orailnoor / DroidDesk

# 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.
> [!IMPORTANT]
> DroidDesk is an independent GPL-3.0 open-source project that incorporates
> modified Termux:X11 components. It is not affiliated with or endorsed by
> Termux, Termux:X11, TUR, Canonical, or Ubuntu.
>
> - **Source and licenses:** 
> - **Termux:X11 upstream:** 
## Video
## What This Actually Runs
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.
## How It Works
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 App (Standalone)
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.
## Requirements
- Any Android phone (ARM64)
- Termux (install from F-Droid, not Play Store)
- Termux-X11 (for on-phone display)
### For Monitor Output ( Optional )
**Option A: USB-C Display Output**
If your phone supports display