orailnoor/DroidDesk

Run a full Linux desktop on any Android phone. Not a terminal. Not an emulator. A complete desktop environment with direct kernel access -- VS Code, Blender, Metasploit, local AI, all of it.

Connect your phone to a monitor and it becomes a Linux PC. Unplug it and your entire setup comes with you.

Everything below has been tested and confirmed working:

• LibreOffice -- Word processing, spreadsheets, presentations. Fully functional.
• VS Code -- Full version. Python, PIP, extensions, everything.
• Claude Code -- AI coding agent running directly in terminal.
• Blender -- Installs and opens. Laggy on mobile hardware, but it runs.
• Wireshark -- Full network analysis, every packet and protocol.
• Metasploit -- Pentesting framework, runs fine.
• Local AI -- Offline LLM inference, 5+ tokens/second, no API needed.

If it runs on Ubuntu, it runs here.

The Linux environment runs through Termux with direct access to the phone's kernel. No emulation, no translation -- native performance.

The setup script installs a full desktop (XFCE4/LXQt/MATE/KDE) inside Termux using the Termux User Repository (TUR) for GUI apps. For tools not available in TUR (Wireshark, Metasploit, etc.), a Proot container provides a standard Ubuntu/Debian/Kali environment where you install anything with apt.

The automatic menu sync scans what you install inside Proot and adds it directly to your desktop app menu. No need to enter the container every time.

DroidDesk is also available as a standalone Android application that completely automates this process without requiring a separate Termux installation. It renders through an embedded Termux:X11 server running in its own Android process; the app does not use VNC.

• Rooted phones: Run the Ubuntu filesystem through chroot.
• Non-rooted phones: Run an app-private native Termux userspace and install desktop packages from the X11 and TUR repositories. PRoot is not used.
• Rendering: Both modes connect directly to the embedded X11 server on DISPLAY=:0. Adreno devices use Turnip/Zink hardware acceleration when available; other GPUs fall back to Mesa software rendering.
• Automated setup: The app extracts the bundled ARM64 Termux bootstrap, configures its private package prefix, and installs the selected desktop automatically.

Download the latest release APK from the Releases tab and sideload it to begin.

• Any Android phone (ARM64)
• Termux (install from F-Droid, not Play Store)
• Termux-X11 (for on-phone display)

Option A: USB-C Display Output If your phone supports display output over USB-C, just use a USB-C to HDMI adapter. Done.

Option B: Raspberry Pi Bridge For phones without display output (most mid-range phones with USB 2.0), use a Raspberry Pi Zero 2W as a bridge:

• Raspberry Pi Zero 2W with Raspberry Pi OS
• Micro USB to USB-C cable
• USB-C hub
• Micro HDMI to HDMI adapter
• SD card with Pi firmware
• Wireless keyboard and mouse

The Pi connects to the phone via USB tethering, detects the phone's IP automatically, and opens a VNC viewer to display the phone's desktop on the monitor.

Download and install Termux from F-Droid: https://f-droid.org/en/packages/com.termux/

Do NOT use the Play Store version. It is outdated and will not work.

Download the latest APK from: https://github.com/termux/termux-x11/releases/tag/nightly

Install it on your phone. This is the display server that renders the desktop.

Open Termux and run:

curl -sL https://raw.githubusercontent.com/orailnoor/DroidDesk/main/termux-linux-setup.sh -o setup.sh
bash setup.sh

The script will:

1. Update Termux packages
2. Add X11 and TUR repositories
3. Install your chosen desktop environment (XFCE4/LXQt/MATE/KDE)
4. Set up GPU acceleration (Turnip for Adreno, Zink fallback for others)
5. Install Firefox, Git, Python, and core tools
6. Set up a Proot Linux container (Ubuntu/Debian/Kali)
7. Create the App Bridge for automatic menu syncing
8. Apply a modern dark theme
9. Optionally set up VNC for remote access

After installation completes:

bash ~/start-x11.sh

Then open the Termux-X11 app on your phone. Your desktop is ready.

To install tools that are not in TUR:

bash ~/start-proot.sh
apt install wireshark    # or any other package
exit
bash ~/proot-menu-sync.sh

The app will appear in your desktop menu automatically.

If you are using a Raspberry Pi Zero 2W to output to a monitor:

Flash standard Raspberry Pi OS to an SD card and boot the Pi.

sudo apt update
sudo apt install realvnc-vnc-viewer

Copy pi-launch_phone.sh to your Pi:

curl -sL https://raw.githubusercontent.com/orailnoor/DroidDesk/main/pi-launch_phone.sh -o ~/pi-launch_phone.sh
chmod +x ~/pi-launch_phone.sh

1. Connect the phone to the Pi via USB cable
2. Enable USB Tethering on the phone
3. Start VNC on the phone: bash ~/start-vnc.sh (in Termux)
4. Run the bridge script on the Pi:

bash ~/pi-launch_phone.sh

The script auto-detects the phone's IP and opens a fullscreen VNC session on the monitor.

To make the Pi automatically connect when powered on, add to crontab:

crontab -e

Add this line:

@reboot sleep 15 && /home/pi/pi-launch_phone.sh

• Termux-X11 directly on the phone is faster than VNC. Use VNC only when you need monitor output through the Pi bridge or remote access from another device.
• For standalone phone use without a monitor, Termux-X11 is the recommended option.
• The Proot container shares the display with the native Termux desktop. Apps installed in Proot render on the same screen.
• GPU acceleration works best on Adreno GPUs (Qualcomm Snapdragon phones). Other GPUs fall back to software rendering.

Created by orailnoor

DroidDesk is independent software licensed under GNU GPL version 3 only. It is not affiliated with or endorsed by Termux, Termux:X11, TUR, Canonical, Ubuntu, or other upstream projects.

The Android application incorporates GPL-licensed Termux:X11 components and bundles other third-party software under their respective licenses. See:

• Notices and attribution
• Third-party software inventory
• Release compliance status

The current compliance checklist includes unresolved source provenance, reproducible-build, custom-prefix bootstrap, and wallpaper-license work. Do not describe a binary release as fully compliant until the blocking checklist items are complete.