Robert Helewka
b4d60f2f38
Replaces the minimal project description with a comprehensive README including a component overview table, quick start instructions, common Ansible operations, and links to detailed documentation. Aligns with Red Panda Approval™ standards.
1.8 KiB
Purpose This script automates the installation and configuration of xRDP (X Remote Desktop Protocol) on Ubuntu-based systems, providing a complete remote desktop solution with enhanced user experience.
Key Features Multi-Distribution Support: Ubuntu 22.04, 24.04, 24.10, 25.04 Linux Mint, Pop!OS, Zorin OS, Elementary OS Debian support (best effort) LMDE (Linux Mint Debian Edition)
Installation Modes: Standard installation (from repositories) Custom installation (compile from source) Removal/cleanup option
Advanced Capabilities: Sound redirection - Compiles audio modules for remote audio playback H.264 encoding/decoding support (latest version) Desktop environment detection - Handles GNOME, KDE, Budgie, etc. Sound server detection - Works with both PulseAudio and PipeWire Custom login screen - Branded xRDP login with custom colors/backgrounds
Smart Features: SSH session detection - Warns when installing over SSH Version compatibility checks - Prevents incompatible installations Conflict resolution - Disables conflicting GNOME remote desktop services Permission fixes - Handles SSL certificates and user groups Polkit rules - Enables proper shutdown/reboot from remote sessions
What Makes It Special Extensive OS/version support with graceful handling of EOL versions Intelligent detection of desktop environments and sound systems Post-installation optimization for better remote desktop experience Comprehensive error handling and user feedback Modular design with separate functions for different tasks Active maintenance - regularly updated with new Ubuntu releases
The script essentially transforms a basic Ubuntu system into a fully-functional remote desktop server with professional-grade features, handling all the complex configuration that would normally require manual intervention.