README
1autocutsel
2http://www.nongnu.org/autocutsel/
3https://github.com/sigmike/autocutsel
4Copyright (c) 2001-2006 - Michael Witrant
5
6X servers use two schemes to copy text between applications. The first one
7(old and deprecated) is the cutbuffer. It is a simple buffer in which any
8application can store text. The other scheme is the selection and works
9differently. There may be many selections in a single server. An
10application does not copy data in a selection, it "owns" it. When
11another application wants to retreive the content of a selection, it
12asks the owner.
13
14Recent desktop applications (GNOME, KDE, ...) use two selections: the
15PRIMARY and the CLIPBOARD. The PRIMARY selection is used when you select
16some text with the mouse. You usually paste it using the middle button. The
17CLIPBOARD selection is used when you copy text by using, for example,
18the Edit/Copy menu. You may paste it using the Edit/Paste menu.
19
20Windows VNC clients keep the Windows clipboard synchronized with the
21cutbuffer, but not with the selections. And since recent applications
22don't use the cutbuffer, the server's CLIPBOARD is never synchronized
23with Windows' one.
24
25Autocutsel tracks changes in the server's cutbuffer and CLIPBOARD
26selection. When the CLIPBOARD is changed, it updates the cutbuffer. When
27the cutbuffer is changed, it owns the CLIPBOARD selection. The cutbuffer
28and CLIPBOARD selection are always synchronized. Since the VNC client
29synchronizes the Windows' clipboard and the server's cutbuffer, all
30three "clipboards" are always kept synchronized. When you copy some text in
31Windows, the cutbuffer and the CLIPBOARD selection are updated. When you
32copy text on the server using either the cutbuffer or the CLIPBOARD
33selection, the Windows's clipboard is always updated.
34
35To build autocutsel:
36 ./configure
37 make
38
39If you downloaded autocutsel from CVS, you first have to run ./autogen.sh to
40build the configure script.
41
42If configure fails because it can't find X or Xaw libraries, you may have to
43install the devel packages of these libraries.
44
45On Ubuntu, you may need to install these packages :
46 sudo apt-get install libc6-dev libxtst-dev xorg-dev
47
48To install it (as root):
49 make install
50
51To run it:
52 autocutsel
53
54By default, autocutsel synchronizes the CLIPBOARD selection. You may want to use
55the PRIMARY selection instead, if your applications use Motif or another toolkit
56not using the CLIPBOARD. To do that, simply run
57 autocutsel -selection PRIMARY
58
59Some softwares (like Open Office Writer) have trouble when the PRIMARY selection
60is requested before the mouse button is released. As a workaround, you can run
61autocutsel with the "-buttonup" option and it will only get the selection when
62the first mouse button is not pressed.
63
64Any feedback is welcome.
65
66Michael Witrant <mike at lepton.fr>
67
68
69 This program is free software; you can redistribute it and/or modify
70 it under the terms of the GNU General Public License as published by
71 the Free Software Foundation; either version 2 of the License, or
72 (at your option) any later version.
73
74 This program is distributed in the hope that it will be useful,
75 but WITHOUT ANY WARRANTY; without even the implied warranty of
76 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
77 GNU General Public License for more details.
78
79 You should have received a copy of the GNU General Public License
80 along with this program; if not, write to the Free Software
81 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
82