1x2vnc(1) General Commands Manual x2vnc(1)
2
6 x2vnc - a dual-screen hack
7
10 x2vnc <options> host:0
11 [ -display display ]
12 [ -version ]
13 [ -shared ]
14 [ -north ] [ -south ] [ -east ] [ -west ]
15 [ -hotkey key ]
16 [ -passwdfile passwd-file ]
17 [ -resurface ]
18 [ -edgewidth width ]
19 [ -desktop desktop-number ]
20 [ -timeout seconds ]
21 [ -wheelhack ]
22 [ -nowheel ]
23 [ -reversewheel ]
24 [ -scrolllines lines ]
25 [ -navhack ]
26 [ -mac ]
27 [ -trimsel ]
28 [ -noblank ]
29 [ -lockdelay seconds ]
30 [ -debug ]
31 [ -accel multiplier ]
32 [ -noreconnect ]
33 [ -tunnel ]
34 [ -via host ]
35
37 x2vnc will let you use two screens on two different computers as if
38 they were connected to the same computer. The computer with the 'main'
39 keyboard must be running X-window, and the second computer should have
40 a VNC server running which will update the contents on the actual
41 screen. This means Xvnc is not suitable, but WinVNC is.
42 For up-to-date information on x2vnc, see the x2vnc home page:
44 http://fredrik.hubbe.net/x2vnc.html
45 -display display
48 The X windows display to connect from.
49 -shared
51 Allow multiple connections to the same VNC server.
52 -north, -south, -east, -west,
54 Determine which edge leads to the other screen.
55 -passwdfile password-file
57 With this option you can start x2vnc without entering a pass‐
58 word. The file is created by vncpasswd which comes with the X-
59 windows VNC software. If the file does not exist, x2vnc will
60 ask for a password and create the file.
61 -resurface
63 This option will cause the trigger window to re-surface automat‐
64 ically if it is covered up by another window.
65 -hotkey key
67 This option allows you to select which key to use to warp the
68 pointer to and from second computer. The default is "Control-
69 F12", any combination of modifiers can be used, such as "shift-
70 alt-meta-ctrl-F1" (or s-a-m-c-F1).
71 -edgewidth pixels
73 This is a workaround for some X servers which do not allow the
74 mouse to go all the way to the edge of the screen. By setting
75 this to 2 or greater, the mouse will be able to reach the x2vnc
76 window and thus warp to the windows machine. The default value
77 is 1. If you set this value to 0, no border will be generated,
78 which means you will have to use hotkeys to switch to the oher
79 screen.
80 -desktop desktop-number
82 With this option, you can make x2vnc non-sticky. This may not
83 work with all window-managers. Note that the first desktop is
84 usually 0 (zero). If you want x2vnc to appear on the last
85 (rightmost) desktop, use -1. This option was especially created
86 with the sawfish edgeflipping in mind, normally you would use
87 "-west -desktop 0" or "-east -destkop -1" with Sawfish to allow
88 edgeflipping to work normally.
89 -timeout seconds
91 This options tells x2vnc how long to wait before warping the
92 cursor back to the X screen if there is no activity. The reason
93 for this is that some screen savers, such as xscreensaver, can‐
94 not activate while x2vnc is in control of the cursor. The
95 default value is 590 seconds, which is equivalent to 9 minutes
96 and 50 seconds. Using a value of 0 will disable timeouts com‐
97 pletely.
98 -nowheel
100 This option does nothing and is left for backwards compatibility
101 only.
102 -wheelhack
104 This will make x2vnc tranlate all mouse wheel events into arrow
105 up/down events. Only use this if your VNC server doesn't under‐
106 stand mouse wheel events.
107 -reversewheel
109 Invert the up/down direction of the mouse wheel emulation. This
110 option only works if -wheelhack is used.
111 -scrolllines lines
113 When using mouse wheel emulation, this selects how many up/down
114 events will be sent for each tick of the mouse wheel.
115 -navhack
117 This will map button 6 & 7 to Alt+Left/Right, which will allow
118 the navigation buttons on some mice to behave more like they do
119 in windows.
120 -mac Macintosh specific mode, maps second mouse button to control-
122 mouseclick.
123 -trimsel
125 If the X selection looks like a URL, trim leading and trailing
126 spaces. This can be useful for pasting URLs into a browser.
127 -noblank
129 Prevent screen blanking on the remote desktop while you are
130 working on the local desktop. Requires the MIT-SCREEN-SAVER or
131 XIDLE extension to work properly. If neither of these extensions
132 are present, the remote desktop will always be kept from blank‐
133 ing.
134 -lockdelay seconds
136 This is only meaningful when using the -noblank option. When
137 this option is present. With this option, x2vnc will not attempt
138 to wake up the remote screen if you have been idle for more than
139 the specified amount of time. This is useful if you need a pass‐
140 word to unlock the remote screen and would rather leave it
141 blanked until you need it.
142 -debug This option will make x2vnc print out information about events
144 it sends and receives to stderr for debugging purposes.
145 -accel multiplier
147 This option allows you to control the speed of the mouse on the
148 remote screen. 2.0 means twice as fast, 0.5 means half as fast.
149 Default is 1.0. Note that this is multiplied with a number which
150 x2vnc calculates based on screen sizes and other factors.
151 -noreconnect
153 This option prevents x2vnc from automatically reconnecting if
154 the connection is closed.
155 -tunnel
157 This option makes x2vnc start an SSH tunnel to the machine being
158 controlled by x2vnc. The SSH command used can be changed by set‐
159 ting the X2VNC_SSH_CMD environment variable. The default is:
160 ssh -A -X -f -L "$LOCALPORT:$REMOTEHOST:$REMOTEPORT" \
161 "$GATEWAYHOST" 'ssh-add;sleep 60'
162 -via host
164 This is similar to -tunnel, but tunnels through a host different
165 than the machine being controlled by x2vnc.
166
170 Most common usage:
171 x2vnc -passwdfile $HOME/.vncpasswd -resurface host:0
172 To make x2vnc start (and re-start) automatically, add the following to
174 your your X startup file (usually .xinitrc):
175 while :;
176 do
177 x2vnc -passwd $HOME/.vncpasswd -resurface host:0
178 sleep 2
179 done
180
183 Fredrik Hќbinette, hubbe@hubbe.net
184 x2vnc(1)