How orailnoor/droiddesk works
DroidDesk is an Android app for setting up and running a Linux desktop on a phone, with rooted chroot and non-root native Termux userspace modes. The user configures a desktop, the app prepares the runtime and packages, then starts a Linux session rendered through its embedded X11 server; touch and keyboard input are forwarded to that display. The README also describes a separate Termux-script workflow and Proot menu sync, but their implementation is not mapped here. Runtime details are based on sampled Android sources and the SOURCE INDEX; unsampled UI and setup links are omitted where their call paths are unverified.
Main entry points: ChrootRuntime.kt Chroot Runtime · MainActivity.kt Platform Bridge · DesktopActivity.kt Desktop Activity · LinuxRuntime.kt Native Linux Runtime
Components 30
App Setup
- Flutter App UI
app/lib - Platform Bridge
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/MainActivity.kt - App State
app/lib/state/app_state.dart - Setup Screens
app/lib/screens/setup - App Catalog
app/lib/screens/apps/app_catalog_screen.dart
Linux Runtime
- Session Service
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/service/DroidDeskService.kt - Native Linux Runtime
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/LinuxRuntime.kt - Chroot Runtime
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/ChrootRuntime.kt - Root Filesystem
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/RootfsManager.kt - Root Shell
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/RootShell.kt - XFCE Mobile Profile
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/XfceMobileProfile.kt
Desktop Display
- Desktop Activity
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/DesktopActivity.kt - Android Surface
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/AndroidSurfaceView.kt - X11 Client
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11ServiceClient.kt - X11 Server Service
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11ServerService.kt - Native X Entry
app/android/app/src/main/java/com/termux/x11/CmdEntryPoint.java - Lorie Renderer
app/android/app/src/main/java/com/termux/x11/LorieView.java - X11 Activity Support
app/android/app/src/main/java/com/termux/x11/MainActivity.java - Display Preferences
app/android/app/src/main/java/com/termux/x11/Prefs.java
Input Handling
- X11 Input Controller
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11InputController.kt - Touch Gesture Handler
app/android/app/src/main/java/com/termux/x11/input/TouchInputHandler.java - Input Event Sender
app/android/app/src/main/java/com/termux/x11/input/InputEventSender.java - Input Event Interface
app/android/app/src/main/java/com/termux/x11/input/InputStub.java - Render Mapping
app/android/app/src/main/java/com/termux/x11/input/RenderData.java
Termux Workflow
- Termux Setup Scripts
termux-linux-setup.sh - Proot Environment
- Proot Menu Sync
Other components
- Phone User
- Termux:X11
- Linux Desktop
Connections 30
- Phone User → Flutter App UI: configures
README.md - Flutter App UI → Platform Bridge: invokes platform
- Platform Bridge → Native Linux Runtime: installs and runs
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/MainActivity.kt - Platform Bridge → Chroot Runtime: selects rooted mode
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/MainActivity.kt - Platform Bridge → Session Service: starts session service
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/MainActivity.kt - Platform Bridge → Desktop Activity: opens desktop
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/MainActivity.kt - Chroot Runtime → Root Shell: uses
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/ChrootRuntime.kt - Chroot Runtime → Root Filesystem: manages filesystem
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/ChrootRuntime.kt - Chroot Runtime → XFCE Mobile Profile: applies profile
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/ChrootRuntime.kt - Native Linux Runtime → XFCE Mobile Profile: applies profile
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/runtime/LinuxRuntime.kt - Desktop Activity → Chroot Runtime: starts rooted session
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/DesktopActivity.kt - Desktop Activity → Native Linux Runtime: starts native session
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/DesktopActivity.kt - Desktop Activity → X11 Client: connects display
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/DesktopActivity.kt - X11 Client → X11 Server Service: binds and requests server
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11ServiceClient.kt - X11 Server Service → Native X Entry: starts native server
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11ServerService.kt - Desktop Activity → Android Surface: attaches surface
- Android Surface → Lorie Renderer: renders through
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/view/AndroidSurfaceView.kt - Lorie Renderer → Termux:X11: displays X11 output
README.md - X11 Input Controller → Touch Gesture Handler: delegates gestures
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11InputController.kt - Touch Gesture Handler → Input Event Sender: sends input
app/android/app/src/main/java/com/termux/x11/input/TouchInputHandler.java - Input Event Sender → Input Event Interface: dispatches events
app/android/app/src/main/java/com/termux/x11/input/InputEventSender.java - Input Event Sender → Render Mapping: maps coordinates
app/android/app/src/main/java/com/termux/x11/input/InputEventSender.java - X11 Input Controller → Lorie Renderer: registers listeners
app/android/app/src/main/kotlin/com/orailnoor/droiddesk/x11/X11InputController.kt - Lorie Renderer → Display Preferences: reads display settings
app/android/app/src/main/java/com/termux/x11/LorieView.java - Termux Setup Scripts → Proot Environment: sets up container
README.md - Proot Environment → Proot Menu Sync: syncs installed apps
README.md - Termux Setup Scripts → Termux:X11: uses display server
README.md - Termux:X11 → Linux Desktop: renders desktop
README.md - Native Linux Runtime → Linux Desktop: runs desktop session
README.md - Chroot Runtime → Linux Desktop: runs desktop session
README.md