xwinclip

Section: User Commands (1)
Updated: xorg-server 21.1.1
Index Return to Main Contents
 

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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
BUGS
CONFORMING TO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 19:03:15 GMT, December 12, 2021