Install from F-Droid (NOT Play Store):
- Termux
- Termux:X11 — display server
- Termux:API — battery, clipboard, voice
Download the latest APK from GitHub Releases and install it.
~30 seconds. The app downloads and sets up the prebuilt Debian 13 + XFCE image from GitHub Container Registry.
Done. Full Linux desktop on your phone.
CLI fallback: You can also install via Termux terminal:
curl -sL https://raw.githubusercontent.com/arinadi/arinanoX/main/bootstrap.sh | bash arinanox start
┌─────────────────────────────────────┐
│ arinanoX APK (Flutter) │ ← Companion app: start/stop/terminal/snapshots
├─────────────────────────────────────┤
│ Bash scripts (~/.arinanox/) │ ← Downloaded by bootstrap, updatable from app
├─────────────────────────────────────┤
│ Proot container (ghcr.io) │ ← Prebuilt Debian 13 + XFCE image
│ Built from image/Dockerfile │ CI-built, tagged, pushed to GHCR
└─────────────────────────────────────┘
| What | Detail |
|---|---|
| OS | Debian 13 (Trixie) ARM64 |
| Desktop | XFCE4 + Whisker Menu + PulseAudio tray |
| Browser | Firefox ESR |
| Dev tools | Git, Node.js 22 LTS, Python 3 (pip/venv/dev), GCC, Make, CMake |
| Theme | Orchis-Dark Material Design + elementary-hidpi icons |
| Touch | Single-click Thunar, large scrollbars, clipboard auto-sync |
| Terminal | mousepad, ristretto, htop, tmux, OpenSSH |
| GPU | virglrenderer auto-detect (3-tier: android → angle-vulkan → CPU) |
Auto-detected at launch:
1. android → virgl_test_server_android (native GLES)
2. angle-vulkan-null → virgl + ANGLE passthrough (Vulkan GPUs)
3. CPU fallback → LIBGL_ALWAYS_SOFTWARE=1 (desktop only)
Download APK from GitHub Releases.
| Feature | Description |
|---|---|
| 📥 Install | Download and set up Debian 13 + XFCE (~30s, one tap) |
| 🟢 Start/Stop | One-tap launch or shutdown XFCE desktop |
| 💻 Terminal | In-app proot shell with streaming output |
| 🩺 Health Check | Run doctor.sh to diagnose issues |
| 📸 Snapshot | Instant user-home checkpoint (hardlinked) |
| 🔄 Update Scripts | Download latest launchers + scripts from GitHub |
| 📊 System Info | GPU, RAM, storage, container size |
The app uses Termux bash internally — all commands run in the correct environment with proper PATH, HOME, and library paths.
APK builds are CI-triggered manually (workflow_dispatch) — no spam on every commit.
arinanox start # Start desktop (PulseAudio → X11 → virgl → XFCE)
arinanox stop # Stop everything
arinanox status # System overview + layered packages
arinanox doctor # Full health-check
arinanox store # APT Store GUI (install/search/upgrade)
arinanox snapshot # Instant checkpoint (hardlinked, 3 retained)
arinanox install # Apply packages from user-manifest.yaml
arinanox help # All commands| Command | Action |
|---|---|
battery |
Battery % and health |
clipget / clipset |
Android clipboard |
vol-up / vol-down |
Media volume |
bright 50 |
Brightness 0-100 |
toast "msg" |
Toast popup |
notify "T" "B" |
Notification |
speak "hello" |
Text-to-speech |
speechlisten |
Speech-to-text |
openurl / share |
Open / share in Android |
whereami / wifi |
GPS / WiFi |
photo / flash |
Camera / flashlight |
Background processes get silently killed. Disable it:
- Android 14+: Developer Options → Disable child process restrictions
- Android 12–13:
adb shell settings put global settings_enable_monitor_phantom_procs false
| Limitation | Workaround |
|---|---|
| No root | proot provides root-like environment, not real root |
| No systemd | Start services manually |
| No GPU passthrough | virglrenderer auto-detected (3-tier fallback) |
| ARM64 only | QEMU user-mode for cross-arch (slow) |
| No native X11 | Termux:X11 APK required |
| Docker containers | Not possible (daemon needs kernel features proot lacks) |
arinanoX/
├── app/ ← 📱 Flutter app (APK) — primary entry point
│ ├── lib/ ← Dart: screens, state, services, theme
│ └── android/ ← Kotlin: shell executor, script updater
├── bootstrap.sh ← CLI fallback: curl | bash
├── image/ ← 🎯 System definition (Dockerfile)
│ ├── Dockerfile ← declarative: packages, configs, themes
│ └── configs-target/ ← XFCE, bash, GTK, autostart
├── scripts/ ← setup, patch, status, doctor, snapshots
├── launchers/ ← start/stop shortcuts
├── docs/ ← documentation
└── .github/workflows/ ← CI: build-image (manual), build-apk (manual)
GPLv3 — see LICENSE.