xwinclip(1)

NAME
xwinclip - An X11 and Windows clipboard integration tool

SYNOPSIS
xwinclip [OPTION]...

DESCRIPTION
xwinclip is a tool for copying and pasting text between the Windows and X11 clipboard systems. xwinclip watches for updates to either clipboard and copies data between them when either one is updated. xwinclip monitors the X PRIMARY and CLIBPOARD selections for changes in ownership, and makes the contents of the most recent one to change available to paste from the Windows clipboard. It also monitors the contents of the Windows clipboard for changes, taking ownership of the PRIMARY and CLIPBOARD selections, and making the contents of the Windows clipboard available in them. Note well: The XWin(1) X server has internal clipboard integration that is enabled by default. Do NOT run xwinclip unless XWin(1) has been started with the -noclipboard option.

OPTIONS
xwinclip accepts the following optional command line switches:

-display [display]
    Specifies the X server display to connect to.

-noprimary
    Do not monitor the PRIMARY selection.

SEE ALSO
XWin(1)

BUGS
Only text clipboard contents are supported. The INCR (Incremental transfer) clipboard protocol for clipboard contents larger than the maximum size of an X request (approximately 256K) is only supported for X -> Windows clipboard transfers. Some X clients, notably ones written in Tcl/Tk, do not re-assert ownership of the PRIMARY selection or update its timestamp when its contents change, which currently prevents xwinclip from correctly noticing that the PRIMARY selection's contents have changed. Windows clipboard rendering is synchronous in the WM_RENDER*FORMAT message (that is, we must have placed the contents onto the clipboard by the time we return from processing this message), but we must wait for the X client which owns the selection to convert the selection to our requested format. This is currently achieved using a fixed timeout. After requesting conversion of the selection, if no events are received from the X client which owns the selection for one second, the conversion is assumed to have failed. The XWin(1) server should indicate somehow (by placing an atom on the root window?) that it is running with its internal clipboard integration enabled, and xwinclip should notice this and exit with an appropriate error. Probably many other bugs.

CONFORMING TO
ICCCM (Inter-Client Communication Conventions Manual) 2.0

AUTHORS
Contributors to xwinclip include Benjamin Riefenstahl, Roland Cassard, Brian Genisio, Colin Harrison, Harold L Hunt II, Matsuzaki Kensuke, Jon Turney, Chris Twiner and Jeremy Wilkins.