A simple, one-line command to install a deeply optimized, hardware-accelerated Debian environment with AI coding agents and full Windows emulation on any Android device using Termux.
The goal of this project is to provide a seamless and fully automated way for users to get a powerful, feature-rich OS experience on their Android device without needing root access. It has evolved into a "Desktop Replacement" designed for developers, pro-gamers, and AI enthusiasts who want to unlock the absolute limit of their Snapdragon processors.
- 🚀 VIP Graphical Setup: Beautiful, full-screen curses-based TUI installer (Dialog). Use your arrow keys to select your OS features visually instead of typing in a standard terminal.
- 🎮 Pro-Gamer Windows Emulation: Built-in Box86/Box64 and Wine integration. Automatically installs DXVK, VKD3D (DirectX 12), and D8VK for flawless AAA gaming.
- ⚙️ Universal Windows Libraries: 1-click GUI tool to permanently inject Visual C++ Redistributables (2010-2015) and DX compilers to stop DLL errors on WineHQ.
- 📚 MS Office Compatibility: Native 1-click GUI tool to prepare your environment for MS Office (Word, Excel, PowerPoint) and SPSS via `winetricks`.
- 🖱️ Terminal-Free Windows Apps: Double-click `.exe` files directly in your Linux file manager to run them, or use the visual "Run Windows App" GUI tool!
- 🛒 Debian Software Center: Install massive Linux apps (Telegram, Discord, GIMP, OBS Studio, Blender, VS Code) using a visual checkbox GUI. Zero terminal required!
- 🔋 OS-Power Management System: Switch seamlessly between 🟢 Power Saver (Software rendering), 🟡 Balanced, and 🔴 Performance (Turnip GPU Overclocking) modes to save battery.
- 🤖 AI Coding Hub: Pre-configured options to install Reasonix Desktop/CLI, Cursor IDE, Aider, and VS Code.
- 📱 The Magic Desktop: Automatically synchronizes your Android `Downloads`, `DCIM`, and `Documents` folders to your Linux desktop.
- 👆 Tablet Touch Optimizations: Dedicated Tablet Mode that enables High DPI UI scaling and the Onboard virtual keyboard for flawless touch controls on devices like the Poco F3 or Pad 7.
- 🌐 Hardware Accelerated Web: Choose between Firefox ESR or a specially configured Chromium browser with Vulkan flags for 1080p/4K 60fps video playback.
- An Android device (phone or tablet) - Snapdragon processors recommended for Turnip 3D acceleration.
- The Termux app installed via F-Droid.
- The Termux-X11 app or a VNC Viewer installed.
- Approximately 5-8 GB of free storage space.
Paste the one-line command below into your Termux terminal and press Enter.
bash -c "$(curl -fsSL https://raw.githubusercontent.com/erfan2255/debian-on-android/main/setup.sh)"The script will launch the V8 interactive wizard. You can choose your Display Server (X11/VNC), GPU Drivers (Turnip/VirGL), Desktop Environment (XFCE/LXQt/i3), Browser, AI tools, and Windows Gaming options.
After the installation is complete, a start-x11 alias will be created in Termux. To launch your desktop, simply type:
start-x11You will instantly be greeted by the OS-Power menu. Select 1 (Power Saver), 2 (Balanced), or 3 (Performance) depending on your battery needs, and your desktop will launch!
- Audio: If you want sound, type
start-audioin Termux before launching your desktop. - Backups: Type
backup-debianin Termux to create a full system snapshot in your Android Downloads folder. Typerestore-debianto recover it. - Graphics Test: Type
gpu-testinside Debian to verify your Vulkan/OpenGL acceleration is working.
| Component | Description |
|---|---|
| Operating System | Debian 13 (Trixie) |
| Graphics Drivers | Mesa-Zink, Turnip, VirGL |
| Windows Translation | Box64, Box86, Wine, DXVK, VKD3D, D8VK |
| Desktop Environment | XFCE 4 / LXQt / i3wm |
| Productivity & AI | Reasonix, Cursor, Aider, VS Code, LibreOffice |
Here is a preview of the Debian 13 XFCE desktop environment you will be installing.
Debian info
Libre Office
If you find this project useful, please give it a ⭐ to show your support!
This project is licensed under the MIT License. See the LICENSE file for details.
by Erfan2255 & CoreLand