kisscommunity

kisscommunity.bvnf.space site sources
git clone git://bvnf.space/home/kiss/kisscommunity.git
Log | Files | Refs | Submodules | README

index.txt (3368B)


      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     16
     17
     18
     19
     20
     21
     22
     23
     24
     25
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
     52
     53
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
X11VNC [0]
________________________________________________________________________________

x11vnc allows one to view remotely and interact with real X displays (i.e. a 
display corresponding to a physical monitor, keyboard, and mouse) with any VNC 
viewer.


Dependencies
________________________________________________________________________________

Refer to the @/xorg/xorg-server page for X server and Window Manager setup and 
configuration.


Configuration
________________________________________________________________________________

First verify that you have x11vnc installed:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ kiss b x11vnc && kiss i x11vnc                                           |
|                                                                              |
+------------------------------------------------------------------------------+

Assuming that you have an X session already running, you can start x11vnc from
a virtual terminal:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ x11vnc -forever                                                          |
|                                                                              |
+------------------------------------------------------------------------------+

The "-forever" switch is not required, but prevents the x11vnc from exiting at
the end of a client session. For more information on this switch or additional 
switch options, refer to the man page [1].


Tips and Tricks
________________________________________________________________________________

* If x11vnc fails to start or you are not operating from a virtual terminal
  (e.g. over SSH), you may also need to specify the xauthority file location in
  addition to the display:

  +----------------------------------------------------------------------------+
  |   "sx" example, configured per #/wiki/xorg/sx                              |
  +----------------------------------------------------------------------------+
  |                                                                            |
  |   $ x11vnc -forever -display :1 -auth /home/USER/.config/sx/xauthority     |
  |                                                                            |
  +----------------------------------------------------------------------------+
  |   "startx" example, configured per #/wiki/xorg/startx                      |
  +----------------------------------------------------------------------------+
  |                                                                            |
  |   $ x11vnc -forever -display :1 -auth /home/USER/.Xauthority               |
  |                                                                            |
  +----------------------------------------------------------------------------+

  Note: Remember to replace USER with the name of the regular user.  

* You can start x11vnc in the background by passing the optional "-bg" switch.


References
________________________________________________________________________________

[0] https://github.com/LibVNC/x11vnc
[1] https://linux.die.net/man/1/x11vnc