Chinese Users (中国用户): Please click the link below for the Chinese documentation.
📖 Additional Resources
- 📋 Changelog / 更新日志 - View version history and new features
- 🚀 Quick Start / 快速开始 - Getting started guide and tips
- ✨ Improvements / 改进总结 - Detailed feature improvements
XXY v5.0 is the latest enhanced version of the Termux Linux container manager. Deeply optimized with AI assistance, this version focuses on stability, usability, and safety.
It serves as a smart wrapper around proot-distro, providing a menu-driven interface that eliminates the need for complex commands. Whether you are a beginner or a developer, XXY handles dependencies, localization, and desktop environments (GUI) automatically.
| Feature | Description |
|---|---|
| 💾 Complete Backup & Restore | One-click backup, restore anytime. Full system packaging and quick restoration from backups to ensure data safety. |
| 📝 Smart Logging System | Full recording, easy debugging. Automatically logs all operations and errors, with automatic cleanup of expired logs. |
| ⚙️ Flexible Configuration | Personalized customization. Support for config files to customize mirror sources, update checks, log retention, etc. |
| 🔄 Auto Version Check | Stay up-to-date. Automatically checks for new versions on startup with one-click upgrade to latest features. |
| 📊 System Info Dashboard | Comprehensive monitoring. Displays system status, backup count, log info and other key metrics. |
| ⚡ Performance Optimization | Lower resource usage. Continuously optimized code structure for reduced CPU and memory footprint. |
Before installing, ensure your Termux is up to date.
pkg update -y && pkg upgrade -y
pkg install proot-distro curl -y🚀 One-Click Install Command Copy and paste the following command into your Termux terminal:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Xynrin/XXY-Termux/main/xxy)"Note: After installation, simply type xxy to launch the tool anytime.
🎮 Usage Guide Main Menu
[1] Login System: Select an installed system to log in. Auto-Beautify: Automatically removes old neofetch config and injects a clean startup info.
[2] Install New System: Supported: Ubuntu, Debian, Kali, Arch, Alpine. Automation: Automatically updates sources, installs Chinese fonts, and configures locales.
[3] GUI Mode (Desktop): One-click setup for XFCE4 desktop. Auto-detects installation status.
[4] Uninstall: Safely removes the system and cleans up residual files.
🖥️ GUI Mode (Desktop) Support Mode Description
- Termux:X11 (Recommended) Hardware accelerated, smooth performance. Requires the
Termux:X11app. - VNC Viewer Universal mode. Works with any VNC Viewer app. Address:
127.0.0.1:5901.
❓ Troubleshooting
Q: My cursor disappeared! A: Just run xxy again and exit properly using option 0. The new v32.0 self-healing logic will fix it.
Q: Why is installation slow? A: It depends on your network connection to the Linux mirrors. Use termux-change-repo to switch to a faster mirror.
Q: How to update to the latest version? A: The program automatically checks for updates on startup. You can also manually run the installation command to overwrite the old version.
Q: How to backup my system?
A: In the main menu, select "Maintenance" → "Backup System". The program will automatically package the entire system. Backup files are saved in ~/.xxy/backups/ directory.
Q: Where are the log files?
A: Log files are saved in ~/.xxy/logs/ directory. The program automatically cleans up logs older than 7 days (configurable in config file).
🤝 Contribution Contributions are welcome! Fork the Project Create your Feature Branch Commit your Changes Push to the Branch Open a Pull Request
💾 Data Safety
- Regularly use the backup feature to protect your data
- Backup files can be copied to external storage devices
- Restore operations will completely overwrite existing systems - use with caution
Built with ❤️ by XXY Team & AI Assistant - v5.0 Enhanced Edition