Android Setup

Android Setup & Prerequisites

1. Required APKs

Install the official GitHub builds rather than Google Play Store versions:

• Termux: GitHub Releases — termux-app_...github-debug_arm64-v8a.apk (recommended) or ..._universal.apk.
• Termux:X11: Nightly Releases — termux-x11-universal-debug.apk.
• Termux:API (optional, for battery metrics in benchmarks): GitHub Releases — termux-api-app_...github.debug.apk.

Why GitHub instead of Google Play? The Play Store build of Termux is outdated and signed with a different key, preventing Termux from communicating with the GitHub builds of Termux:X11 and Termux:API.

---

2. Disable Android Child Process Restrictions

Starting with Android 12, Android enforces the Phantom Process Killer, limiting background child processes to 32. Heavy multitasking (Chromium tabs, compilers, background daemons) will trigger this kill-switch unless disabled.

Method 1: Developer Options (Recommended for Samsung One UI)

1. Open Settings > Developer options.
2. Scroll down to the Apps section.
3. Enable Disable child process restrictions.
4. Open App info for both Termux and Termux:X11 > Battery > select Unrestricted.

Method 2: ADB Shell (One-time command)

If the toggle is hidden on your firmware, execute this once via ADB:

adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"
adb shell settings put global settings_enable_monitor_phantom_procs false

---

3. Home Screen 1-Tap Widgets (Termux:Widget)

1. Install Termux:Widget from the same release source as Termux (GitHub Releases or F-Droid).
2. Grant Display over other apps permission to Termux in Android Settings (required so Termux can launch Termux:X11 directly from the background).
3. Run the shortcut generator in Termux:

   curl -fsSL [https://raw.githubusercontent.com/thecbr600/dex-linux-workstation/main/addon/shortcuts.sh](https://raw.githubusercontent.com/thecbr600/dex-linux-workstation/main/addon/shortcuts.sh) | bash

4. Add the Termux:Widget widget to your DeX or phone home screen to launch DeX Desktop or DeX Mobile with a single tap.