RDP Session Manager

Linux  •  GTK 4  •  libadwaita  •  xrdp  •  RemoteApp

🌐 pedroltz.github.io/rdp-session-manager

Overview

RDP Session Manager provides a graphical interface for administering RDP access through xrdp on supported Linux distributions. It centralizes account management, session configuration, and dependency checks in a native GTK 4 and libadwaita application.

Features

• Create, remove, enable, and disable RDP user accounts.
• Configure full desktop sessions with KDE Plasma, GNOME, or XFCE.
• Run Linux applications as RemoteApp sessions.
• Run Windows applications through umu, with legacy WineGE prefix compatibility.
• Check and install required RDP components when needed.
• Monitor user status and active sessions.
• Inspect unified host, user, and session health from GTK or rdpsm health.
• Preview repair plans, automatically roll back managed files on failure, and export privileged repair audit events as JSONL.

Technology

• Python 3.9+
• GTK 4 and libadwaita
• xrdp and FreeRDP
• PolicyKit for privileged system operations

Requirements

Supported distributions:

• Ubuntu 22.04 LTS or later and derivatives
• Debian 12 or later
• Arch Linux and derivatives, including Manjaro, EndeavourOS, and CachyOS

The application requires Python, GTK 4, libadwaita, and PolicyKit. The installer can set up xrdp and FreeRDP; see the installation guide for the complete dependency list.

Installation

Run the official installer:

curl -fsSL https://github.com/Pedroltz/rdp-session-manager/releases/latest/download/install.sh | bash

For manual installation, installer options, and platform-specific notes, see the installation guide.

Running the Application

From a development clone with the required dependencies installed:

./run.sh

You can also start the graphical interface directly:

python3 src/main.py

Command-line usage and available commands are documented in the CLI reference.

Documentation

• Installation guide
• CLI reference
• Windows RemoteApp and legacy WineGE guide
• Production server mode
• Troubleshooting
• Development guide
• Continuous integration and release checks
• v0.7 implementation roadmap
• Changelog

Contributing

Contributions are welcome. Fork the repository, create a focused branch, and open a pull request describing the change.

License

This project is licensed under the GNU General Public License v3.0.