### Manual Linux Repository Setup

Source: https://github.com/xpra-org/xpra/wiki/Download

Clone the Xpra repository and run the setup script to install the repository. This method allows for more control over the installation process.

```shell
git clone https://github.com/Xpra-org/xpra
cd xpra
./setup.py install-repo
```

--------------------------------

### Clone and Setup gtk-osx

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/MacOS.md

Clone the gtk-osx-build repository and execute the setup script. This script installs jhbuild and configures the build environment.

```shell
git clone https://github.com/Xpra-org/gtk-osx-build
cd gtk-osx-build
sh gtk-osx-setup.sh
```

--------------------------------

### Clone and Install Xpra Source

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/README.md

Clone the Xpra repository from GitHub, navigate into the directory, and then install it using setup.py. Ensure all dependencies are installed beforehand. This method installs Xpra's own scripts, replacing any potentially mangled ones from setuptools.

```shell
git clone https://github.com/Xpra-org/xpra
cd xpra
python3 ./setup.py install --prefix=/usr --single-version-externally-managed --root=/
cp fs/bin/xpra* fs/bin/run_scaled /usr/bin/
```

--------------------------------

### Install Xpra using Winswitch Debian Repository

Source: https://github.com/xpra-org/xpra/wiki/Distribution-Packages-Ubuntu

This example shows how to use the Winswitch Debian repository to install Xpra on Ubuntu Xenial, resolving issues with older versions.

```shell
https://winswitch.org/downloads/debian-repository.html?dist_select=xenial
```

--------------------------------

### Full Build and Install

Source: https://github.com/xpra-org/xpra/blob/master/CLAUDE.md

Use this command for a complete build and installation of the project, which is a prerequisite for running tests.

```sh
python3 setup.py install --prefix=/usr --root=dist/
```

--------------------------------

### Install Xpra

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/RPM.md

Installs Xpra using the setup.py script. This is a general installation command.

```shell
python3 ./setup.py install
```

--------------------------------

### Install Xpra using DNF

Source: https://github.com/xpra-org/xpra/wiki/Download

After setting up the repository, install Xpra using the dnf package manager.

```bash
dnf install xpra
```

--------------------------------

### TCP Upgrade to WebSocket Example

Source: https://github.com/xpra-org/xpra/blob/master/docs/Network/README.md

Demonstrates starting an Xpra server with TCP binding and then attaching to it using a WebSocket client. The same TCP port can also be accessed via a browser using the HTML5 client.

```shell
xpra seamless --start=xterm --bind-tcp=0.0.0.0:10000
```

```shell
xpra attach ws://localhost:10000/
```

```shell
xdg-open http://localhost:10000/
```

--------------------------------

### Start Xpra with Firefox (Outdated Usage)

Source: https://github.com/xpra-org/xpra/wiki/Distribution-Packages-Ubuntu

This is an outdated and incorrect method for starting Xpra with Firefox. It is provided as a warning to avoid this syntax.

```shell
xpra start :7;DISPLAY=:7 firefox
```

--------------------------------

### Check Installed Xpra Packages (Fedora/RHEL)

Source: https://github.com/xpra-org/xpra/wiki/Reporting-Bugs

This example shows how to check for installed Xpra packages on Fedora or RHEL-based systems, useful for reporting version information.

```bash
$ rpm -qa | grep xpra
    xpra-4.0.6-10.fc33.x86_64
```

--------------------------------

### Start Xdummy Standalone

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Xdummy.md

Use this command to start a new X11 display using the dummy driver without special privileges. Specify log and config files as needed.

```shell
Xorg -noreset +extension GLX +extension RANDR +extension RENDER \
     -logfile ./10.log -config /etc/xpra/xorg.conf :10
```

--------------------------------

### Start Xpra with Xwayland

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/OpenGL.md

Enable Xpra to use GPU acceleration through Xwayland by starting Xwayland on a specific display and then launching the Xpra server with the --use-display option.

```shell
Xwayland :20 &
xpra seamless :20 --use-display
```

--------------------------------

### Local Installation with setup.py

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs Xpra from source using setup.py with Debian-like layout. It's recommended to remove existing packages first. This command also includes copying executable scripts to /bin.

```shell
./setup.py install --prefix=/usr --install-layout=deb
# the executable scripts may have been mangled, so overwrite them:
cp fs/bin/* /bin/
```

--------------------------------

### Start Xpra with Firefox (Corrected Usage)

Source: https://github.com/xpra-org/xpra/wiki/Distribution-Packages-Ubuntu

This is the recommended way to start Xpra with an application like Firefox, ensuring seamless integration. Avoid the outdated method.

```shell
xpra seamless :7 --start=firefox
```

--------------------------------

### Build Xpra from Source

Source: https://github.com/xpra-org/xpra/blob/master/README.md

Clone the Xpra repository and install it using Python. Ensure you have Python 3 installed.

```sh
git clone https://github.com/Xpra-org/xpra; cd xpra
python3 ./setup.py install
```

--------------------------------

### Start Xdummy with Xpra (v6.3+)

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Xdummy.md

For distributions with Xdummy support and xpra version 6.3 or later, this command simplifies starting an Xvfb-like display.

```shell
xpra xvfb :10
```

--------------------------------

### Start Server with File Authentication (Shell)

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Authentication.md

Use this command to start a seamless server with a TCP socket protected by a password stored in a file. Ensure the 'password.txt' file exists and contains the correct password.

```shell
xpra seamless --start=xterm -d auth
     --bind-tcp=0.0.0.0:10000,auth=file(filename=password.txt)
```

--------------------------------

### Start Server with Chained Authentication (Shell)

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Authentication.md

This command demonstrates starting a seamless server with multiple TCP sockets, each using different authentication methods. One socket uses host authentication chained with file-based password authentication, while another uses system authentication.

```shell
xpra seamless --start=xterm -d auth \
     --bind-tcp=0.0.0.0:10000,auth=hosts,auth=file(filename=password.txt) \
     --bind-tcp=0.0.0.0:10001,auth=sys
```

--------------------------------

### Update and Install Xpra

Source: https://github.com/xpra-org/xpra/wiki/Download

After adding the repository, update your package list and install Xpra. Ensure the 'universe' repository is enabled if required for full features.

```shell
apt update ; apt install xpra
```

--------------------------------

### Install Xpra on Debian/Ubuntu

Source: https://github.com/xpra-org/xpra/wiki/Download

Follow these steps to install Xpra on Debian/Ubuntu systems. Ensure you update your package list and install necessary dependencies before adding the Xpra repository and GPG key.

```bash
REPO="xpra"
apt update
apt install apt-transport-https software-properties-common
apt install ca-certificates
wget -O "/usr/share/keyrings/xpra.asc" https://xpra.org/xpra.asc
wget -O "/etc/apt/sources.list.d/$REPO.sources" https://raw.githubusercontent.com/Xpra-org/xpra/master/packaging/repos/$DISTRO/$REPO.sources
apt update
apt install xpra
```

--------------------------------

### Install Build Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/RPM.md

Installs all build dependencies for the xpra.spec file using dnf. Alternatively, use the dev-env build subcommand for a minimal set of dependencies.

```shell
dnf builddep xpra.spec
```

```shell
./setup.py dev-env --minimal --with-openh264
```

--------------------------------

### Start Xpra Server with SSL

Source: https://github.com/xpra-org/xpra/blob/master/docs/Network/SSL.md

Starts an Xpra server with TCP and SSL support, requiring a certificate file. Use `--ssl-server-verify-mode=none` on the client to bypass verification for self-signed certificates.

```bash
xpra seamless --start=xterm \
     --bind-tcp=0.0.0.0:10000 \
     --ssl-cert=/path/to/ssl-cert.pem
```

```bash
xpra attach ssl://127.0.0.1:10001/
```

```bash
xpra attach ssl://host:10000/ --ssl-ca-certs=./cert.pem
```

--------------------------------

### Install Xpra on FreeBSD using Ports

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Other.md

Use this command to install Xpra if you are using FreeBSD and have the ports tree set up. Ensure you are in the correct directory before running the make command.

```shell
cd /usr/ports/x11/xpra
make install clean
```

--------------------------------

### Install Authentication Module Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs Python libraries for Kerberos and GSSAPI authentication, used for advanced authentication mechanisms.

```shell
apt-get install python3-kerberos python3-gssapi
```

--------------------------------

### Automated Linux Repository Installation

Source: https://github.com/xpra-org/xpra/wiki/Download

Use this command to automatically install Xpra repositories for supported Linux distributions. This script fetches and executes the installation process.

```shell
curl https://xpra.org/get-xpra.sh | bash
```

--------------------------------

### Start Xpra Proxy Server

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Windows-Service.md

This command starts the Xpra proxy server with specific arguments for TCP binding, authentication, and username verification. The proxy logs to a file.

```shell
Xpra proxy --bind-tcp=0.0.0.0:14500,auth=sys,client-username=true,verify-username=true
```

--------------------------------

### Install X11 Runtime Utilities

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs utilities commonly needed at runtime for X11, such as xauth for managing authorization cookies and x11-xkb-utils for keyboard configuration.

```shell
apt-get install xauth x11-xkb-utils
```

--------------------------------

### Install Ubuntu 20.04 on WSL 2

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/WSL.md

Installs Ubuntu 20.04 as a WSL 2 distribution. Ensure you are running this command in an Administrator Command Prompt.

```shell
wsl --install -d Ubuntu-20.04
```

--------------------------------

### Setup SSL Certificates for Xpra

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Nginx-Proxy.md

Use this command to set up SSL certificates if they are not already present. This command will not overwrite existing certificates.

```shell
sudo /usr/bin/xpra setup-ssl
```

--------------------------------

### Client Cursor Capabilities Example

Source: https://github.com/xpra-org/xpra/blob/master/docs/Subsystems/Cursor.md

Example JSON representing the cursor capabilities a client can handle, including supported encodings like 'raw', 'default', and 'png'.

```json
{
  'cursor': {
    'encodings': ['raw', 'default', 'png'],
  },
}
```

--------------------------------

### X11 Server Cursor Capabilities Example

Source: https://github.com/xpra-org/xpra/blob/master/docs/Subsystems/Cursor.md

Example JSON showing cursor capabilities for an X11 seamless server, specifying default cursor size and maximum allowed cursor dimensions.

```json
{
  'cursor': {
    'default_size': 45,
    'max_size': [64, 64],
  }
}
```

--------------------------------

### Install Audio Forwarding Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs GStreamer plugins for PulseAudio, ALSA, and various GStreamer plugin sets (base, good, ugly) to enable audio forwarding.

```shell
apt-get install gstreamer1.0-pulseaudio gstreamer1.0-alsa \
                gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
                gstreamer1.0-plugins-ugly
```

--------------------------------

### Start Seamless Application Forwarding via SSH

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/README.md

Use this command to start an application (e.g., xterm) on a remote host and display it locally through an SSH transport. Ensure you have SSH access to the HOST.

```shell
xpra seamless ssh://USERNAME@HOST/ --start-child=xterm
```

--------------------------------

### Start a Desktop Session

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Desktop.md

Use this command to initiate a full desktop session. Replace 'xterm' with the desired application or window manager.

```shell
xpra desktop --start=xterm
```

--------------------------------

### Install HTML5 Client Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs tools and libraries required for the HTML5 client, including UglifyJS for JavaScript minification, Brotli for compression, jQuery, jQuery UI, and GNOME backgrounds.

```shell
apt-get install uglifyjs brotli libjs-jquery libjs-jquery-ui gnome-backgrounds
```

--------------------------------

### Start an Xpra Session

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Proxy-Server.md

Starts an Xpra session in seamless mode on display :100 and launches an xterm. This session is not exposed via TCP by default.

```shell
xpra seamless :100 --start=xterm
```

--------------------------------

### Guest virtio-shmem Server Start

Source: https://github.com/xpra-org/xpra/blob/master/docs/Subsystems/MMAP.md

Starts an Xpra server on the guest VM using virtio-shmem. It binds to a VSOCK port and specifies the MMAP path derived from the shared memory device.

```shell
VSOCK_PORT=10000
MMAP_PATH=$(find /sys/devices/ -type f -name "resource2_wc")
xpra seamless --bind-vsock=auto:${VSOCK_PORT} --mmap=$MMAP_PATH
```

--------------------------------

### Xpra URL Mapping Example

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Client.md

URL mapping allows launching an Xpra client with specified connection options directly from a URL. This example shows connecting to a host using SSL on port 10000.

```url
xpra+ssl://HOST:10000/
```

--------------------------------

### Start Seamless Server with Focus Debugging

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Logging.md

This command initiates a seamless Xpra server with 'focus' debugging enabled, useful for troubleshooting focus-related problems. It also starts an xterm session.

```shell
xpra seamless -d focus --start=xterm
```

--------------------------------

### Install Miscellaneous Extras

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs additional Python libraries like setproctitle and xdg, and X11-related packages including PAM development headers, quilt, Xorg server development files, dummy video driver, and keyboard configuration utilities.

```shell
apt-get install python3-setproctitle python3-xdg \
                libpam-dev quilt xserver-xorg-dev xutils-dev xserver-xorg-video-dummy xvfb keyboard-configuration
```

--------------------------------

### Install Common Dependencies with apt-get

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs essential packages required to run Xpra. These include Xvfb for virtual framebuffers and Python libraries for graphics and image manipulation.

```shell
apt-get install xvfb python3-cairo python3-gi-cairo \
    python3-opengl python3-pil
```

--------------------------------

### Install Basic Picture Codec Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs libraries for basic picture codecs like JPEG and WebP, along with Python Imaging Library (PIL) for image manipulation.

```shell
apt-get install libturbojpeg-dev libwebp-dev python3-pil
```

--------------------------------

### Install X11 Development Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs development libraries for X11, including headers for various X extensions, Python development files, pandoc for documentation generation, and liblz4 for compression.

```shell
apt-get install libx11-dev libxtst-dev libxcomposite-dev libxdamage-dev libxres-dev \
                libxkbfile-dev \
                python3-dev \
                pandoc \
                libsystemd-dev \
                liblz4-dev
```

--------------------------------

### Start Xpra Server with Custom CA Signed Certificate

Source: https://github.com/xpra-org/xpra/blob/master/docs/Network/SSL.md

Starts an Xpra server using a certificate and key signed by a custom CA. This is part of setting up a secure connection with your own certificate authority.

```bash
xpra seamless --start=xterm \
     --bind-tcp=0.0.0.0:10000 \
     --ssl-cert=`pwd`/server.crt --ssl-key=`pwd`/server.key
```

--------------------------------

### Build Only

Source: https://github.com/xpra-org/xpra/blob/master/CLAUDE.md

Execute this command to build the project without performing an installation.

```sh
python3 setup.py build
```

--------------------------------

### Install and Uninstall Xpra Service

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Windows-Service.md

Use these commands to install or uninstall the Xpra Windows Service. The service is not configured to start automatically.

```shell
./Xpra-Service.exe install
```

```shell
./Xpra-Service.exe uninstall
```

--------------------------------

### Start an Xpra Proxy Server

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Proxy-Server.md

Starts an Xpra proxy server on display :20, listening on all interfaces (0.0.0.0) on TCP port 14501. It uses the 'allow' authentication module, which performs no credential checking.

```shell
xpra proxy :20 --tcp-auth=allow --bind-tcp=0.0.0.0:14501
```

--------------------------------

### Install CA Certificates

Source: https://github.com/xpra-org/xpra/wiki/Download

Ensure your system has the latest SSL certificates to securely download packages. This is a prerequisite for adding new repositories.

```shell
sudo apt install ca-certificates
```

--------------------------------

### Get Backtrace in GDB

Source: https://github.com/xpra-org/xpra/wiki/Debugging

Once GDB is attached or has started the process, use these commands to extract stack traces after a crash or at a breakpoint.

```gdb
(gdb) continue
```

```gdb
py-bt
```

```gdb
bt
```

--------------------------------

### Update and Upgrade Packages in WSL

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/WSL.md

Updates the package list and upgrades installed packages within the WSL environment. Run this after initial WSL setup or periodically.

```shell
sudo apt update; sudo apt upgrade
```

--------------------------------

### Start Xpra Seamless Session

Source: https://github.com/xpra-org/xpra/blob/master/README.md

Initiate a seamless Xpra session to run an application (e.g., xterm) on a remote host and display it locally. The target application must be installed on the remote host.

```sh
xpra seamless ssh://USER@HOST/ --start=xterm
```

--------------------------------

### Create Xpra Session File

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/README.md

This example shows how to create a session file that can be used to connect to an xpra session by double-clicking it. Configure connection details like mode, host, and speaker settings.

```shell
cat > ~/Desktop/example.xpra
mode=ssh
host=YOURSERVER
speaker=off
```

--------------------------------

### Install Build Dependencies with dev-env

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Use the dev-env build subcommand to install necessary build dependencies. This command is available in xpra v6.1 onwards and supports minimal installations and specific features like OpenH264.

```shell
./setup.py dev-env --minimal --with-openh264
```

--------------------------------

### Start and Connect to a Desktop Session via SSH

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Desktop.md

Initiate a desktop session on a remote host and connect to it in a single command using SSH.

```shell
xpra desktop --start=xterm ssh://USER@HOST/
```

--------------------------------

### Install Client OpenGL Acceleration Dependency

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs the python3-opengl package, which is required for client-side OpenGL acceleration.

```shell
apt-get install python3-opengl
```

--------------------------------

### Step-by-Step Seamless Application Forwarding

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/README.md

This two-step process involves first starting the xpra server instance on a specific display on the remote host, and then attaching to it from the client. Replace HOST with the server's hostname or IP.

```shell
xpra seamless :100 --start=xterm
```

```shell
xpra attach ssh://USERNAME@HOST/100
```

--------------------------------

### Install NVENC Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs the NVIDIA NVENC library and Python NumPy for using NVIDIA's hardware-accelerated video encoding.

```shell
apt-get install libnvidia-encode1 python3-numpy
```

--------------------------------

### Package Xpra using setup.py

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Builds DEB packages for Xpra using the setup.py script. This is a convenient way to create distributable packages.

```shell
./setup.py package
```

--------------------------------

### Start Desktop Session with a Specific Size

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Desktop.md

Initialize the desktop session with a predefined resolution. The virtual screen can be resized later using X11 tools like 'xrandr'.

```shell
xpra desktop --resize-display="1024x768" --start=fluxbox
```

--------------------------------

### Install SSH Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs SSH client, sshpass for password-based authentication, and Paramiko for programmatic SSH access, required for SSH tunneling.

```shell
apt-get install openssh-client sshpass python3-paramiko
```

--------------------------------

### Start Desktop Session with a Window Manager

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Desktop.md

Launch a desktop session using a specific window manager like 'fluxbox'. More featureful WMs may consume more bandwidth.

```shell
xpra desktop --start=fluxbox
```

--------------------------------

### Install Printer Forwarding Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs CUPS (Common UNIX Printing System) related packages and python3-cups to enable printer forwarding functionality.

```shell
apt-get install cups-filters cups-common cups-pdf python3-cups
```

--------------------------------

### Install Video Codec Dependencies

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs development libraries for video codecs x264 and VP8, along with yasm assembler, required for video support.

```shell
apt-get install libx264-dev libvpx-dev yasm
```

--------------------------------

### Install Essential Packages in WSL

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/WSL.md

Installs gedit (a text editor) and mesa-utils (which includes glxinfo) in WSL. These are often needed for graphical applications and display information.

```shell
sudo apt install gedit mesa-utils
```

--------------------------------

### Download Repository File

Source: https://github.com/xpra-org/xpra/wiki/Download

Download the appropriate repository configuration file for your distribution and place it in `/etc/apt/sources.list.d/`. This allows `apt` to find Xpra packages.

```shell
cd /etc/apt/sources.list.d ; wget $REPOFILE
```

--------------------------------

### Host to Guest virtio-shmem Setup

Source: https://github.com/xpra-org/xpra/blob/master/docs/Subsystems/MMAP.md

Steps to set up virtio-shmem for Xpra communication between a host and a guest VM. This involves adding a shmem device to the VM and enabling it on the guest.

```shell
DEV_NAME="shmem-xpra"
virt-install --shmem name="${DEV_NAME}",model.type=ivshmem-plain,size.unit=M,size=512"
```

```shell
echo 1 > $(find /sys/devices/ -type f -name "resource2_wc" -exec dirname "{}" \;)/enable
```

--------------------------------

### Install Packaging Tools

Source: https://github.com/xpra-org/xpra/blob/master/docs/Build/Debian.md

Installs essential tools for Debian packaging, including devscripts, build-essential, lintian for package checking, debhelper for build automation, and pandoc for documentation conversion.

```shell
apt-get install devscripts build-essential lintian debhelper pandoc
```

--------------------------------

### X11 Client Clipboard Capabilities

Source: https://github.com/xpra-org/xpra/blob/master/docs/Subsystems/Clipboard.md

Example JSON configuration for an X11 client enabling clipboard support, notifications, and specifying preferred targets and direction.

```json
{
  'clipboard': {
    'enabled': true,
    'notifications': true,
    'selections': ['CLIPBOARD', 'PRIMARY', 'SECONDARY'],
    'preferred-targets': ['UTF8_STRING', 'TEXT', 'STRING', 'text/plain', 'image/png'],
    'direction': "both",
  },
}
```

--------------------------------

### Start Remote Xpra Sessions

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Proxy-Server.md

Start two Xpra sessions on a target host that will be accessible via the proxy server. These sessions are configured to listen on specific TCP ports.

```shell
xpra seamless :200 --bind-tcp=0.0.0.0:10100 --start=xterm
xpra seamless :201 --bind-tcp=0.0.0.0:10101 --start=xterm
```

--------------------------------

### Run Xpra Docker Image with Podman

Source: https://github.com/xpra-org/xpra/blob/master/packaging/containers/docker/README.md

Example command to run an Xpra Docker image using podman. You can switch between 'podman' and 'docker', and 'xpra-base' and 'xpra-minimal' images.

```shell
TOOL="podman"       # or "docker"
IMAGE="xpra-base"   # or "xpra-minimal"
$TOOL run --publish 10000:10000/tcp --publish 10000:10000/udp ${IMAGE}
```

--------------------------------

### Start Xpra with VirtualGL

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/OpenGL.md

Use 'vglrun' to execute OpenGL applications with GPU acceleration via VirtualGL. This command starts a seamless Xpra session with glxgears accelerated by VirtualGL.

```shell
xpra seamless --start="vglrun glxgears"
```

--------------------------------

### Enabling the Extension

Source: https://github.com/xpra-org/xpra/blob/master/fs/share/gnome-shell/extensions/input-source-manager@xpra_org/README.md

Instructions on how to enable the Input Source Manager extension using the `gnome-extensions` command or manually.

```APIDOC
## Enabling

### Using gnome-extensions
```bash
/usr/bin/gnome-extensions enable input-source-manager@xpra_org
```

### Manual Enabling
Manually enable the extension by searching for `Extensions` (using the `Super` key) and finding `input-source-manager@xpra_org` in the filtered list.
```

--------------------------------

### Start Xpra Servers for Apache Proxy

Source: https://github.com/xpra-org/xpra/blob/master/docs/Usage/Apache-Proxy.md

Start Xpra servers on specified TCP ports that will be proxied by Apache. Ensure these servers are running before attempting to connect through the Apache proxy.

```shell
xpra seamless --bind-tcp=0.0.0.0:20001 --start=xterm
```

```shell
xpra seamless --bind-tcp=0.0.0.0:20002 --start=xterm
```