xpra icon
Bug tracker and wiki

Changes between Version 29 and Version 30 of Usage


Ignore:
Timestamp:
01/19/17 04:35:04 (9 months ago)
Author:
Antoine Martin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Usage

    v29 v30  
    1414See also, [/browser/xpra/trunk/src/man/xpra.1 the manual]. (this page is for the current development version, use {{{man xpra}}} to get the version corresponding to the version you have installed - *nix only..)
    1515[[BR]]
    16 '''Note:''' we assume here that you have installed a supported and up to date version. Some distributions ship outdated versions..
     16'''Note:''' we assume here that you have installed a supported and up to date version. Some distributions ship outdated versions, do not use those.
    1717[[BR]]
     18
    1819
    1920{{{#!div class="box"
     
    2223As per the [http://xpra.org/#get_started home page "get started"] instructions, this is how xpra is most often used. This will start an {{{xterm}}} (or any graphical application you want) on {{{SERVERHOSTNAME}}} and forward it to your desktop:
    2324{{{
    24 xpra start ssh:SERVERUSERNAME@SERVERHOSTNAME:100 --start-child=xterm
     25xpra start ssh:SERVERUSERNAME@SERVERHOSTNAME --start-child=xterm
    2526}}}
    2627
     
    4243xpra attach
    4344}}}
    44 * If the username is the same on the server, you can omit it.
     45* if the username is the same on the server, you can omit it
     46* if there is only a single display in use (":100) you can omit it too
    4547}}}
     48
    4649
    4750{{{#!div class="box"
     
    5457In this case, use TCP sockets:
    5558{{{
    56 xpra start :100 --start-child=xterm --bind-tcp=0.0.0.0:10000
     59xpra start --start-child=xterm --bind-tcp=0.0.0.0:10000
    5760}}}
    5861Then, assuming that the port you have chosen ({{{10000}}} in the example above) is allowed through the firewall (if any), you can connect from the client using:
     
    6467}}}
    6568
     69
    6670{{{#!div class="box"
    6771== Forwarding a whole desktop ==
    6872
    69 Xpra normally forwards just the windows of the application you are interested in. If you want to forward a full desktop instead (including its start menu, background, task bar, etc...) use a nested X11 server.
    70 [[BR]]
    71 With {{{Xephyr}}}:
     73Xpra normally forwards just the windows of the application you are interested in. If you want to forward a full desktop instead (including its start menu, background, task bar, etc...) use the "start-desktop" mode:
    7274{{{
    73 xpra start --start-child="Xephyr :200 -ac -screen 800x600" :100
    74 DISPLAY=:200 fluxbox&
    75 }}}
    76 Or with {{{Xnest}}}:
    77 {{{
    78 xpra start --start-child="Xnest :200 -ac -geometry 800x600+24" :100
    79 DISPLAY=:200 fluxbox&
     75xpra start-desktop --start-child=fluxbox
    8076}}}
    8177Notes:
    82  * you can start a window manager of your choice (here {{{fluxbox}}}) or none at all..
    83  * to get the session to terminate when you exit the window manager, modify the command lines and add {{{-terminate}}} to {{{Xephyr}}}'s (or {{{Xnest}}}'s) and {{{--exit-with-children}}} to Xpra's
    84  * beware: some desktop environments may show options to shutdown/reboot the system from their start menu, which may or may not be appropriate
    85  * you can resize the desktop using the standard "randr" desktop tools (and not by resizing the window at present)
    86  * {{{Xephyr}}} may not work properly on some systems as there seems to be some GL driver conflicts (ie: nvidia). You can verify by running it directly without xpra. You can also workaround this issue using [http://www.virtualgl.org/ VirtualGL]'s {{{vglrun}}} to launch Xephyr.
     78* you can start a window manager of your choice (here {{{fluxbox}}}) or none at all..
     79* to get the session to terminate when you exit the window manager, add {{{--exit-with-children}}}
     80* beware: some desktop environments may show options to shutdown/reboot the system from their start menu, which may or may not be appropriate
     81* you can resize the desktop using the standard "randr" desktop tools (and not by resizing the window at present)
    8782}}}
     83
    8884
    8985{{{#!div class="box"
     
    9793Notes:
    9894* this also works for MS Windows and OSX, in which case the display argument is mostly meaningless (only used for naming the log file and identifying the session)
    99 * on MS Windows, which does not have regular "unix domain sockets", you will need to use TCP sockets to connect (see above, "{{{bind-tcp=}}}").
    10095* the display being shadowed must be active (not locked or turned off)
    101 * On posix systems, the default X11 session is usually {{{:0}}} or {{{:1}}} and should be detected automatically if there is only one active session
     96* on posix systems, the default X11 session is usually {{{:0}}} or {{{:1}}} and should be detected automatically if there is only one active session
    10297* if there is more than one display active on the server system, you can specify which one you want to shadow: {{{xpra shadow ssh:SERVERHOST:DISPLAY}}}
    10398}}}
    10499
     100
    105101{{{#!div class="box"
    106102== Xpra as a clipboard sharing tool ==
     103
    107104Xpra can forward sound, clipboard and cursors as well as the application's windows. Each one of these feature can also be disabled, so one can use xpra as a clipboard synchronization tool:
    108105* From the client system:
     
    113110}}}
    114111
     112
    115113{{{#!div class="box"
    116114== Xpra as a printer forwarder ==
     115
    117116To forward a printer to another machine, simply start a remote session without starting an application, and ensure printer forwarding is enabled or force enable it on the command line:
    118117{{{