Installation & Setup

• Android device running Android 8.0 (API 26) or higher
• A Lumo API key
• Optional: Shizuku or Termux for advanced networking commands (Shizuku recommended)

📦 Pre-built APK (recommended)

1. Download the app-release.apk file
2. Open the file manager on your Android device and tap the APK
3. Allow installation from unknown sources if prompted
4. Follow the on-screen instructions to install

🔧 Build from Source

# Clone the repository
git clone <repo-url>
cd LumoDroid

# Build the debug APK
./gradlew assembleDebug

# Install on connected device
adb install -r app/build/outputs/apk/debug/app-debug.apk

⚙️ Set Your API Key

On first launch:

1. Open LumoDroid
2. Tap the gear icon in the top-right corner
3. Enter your Lumo API key in the input field
4. Tap Save
5. You're ready to chat!

🔐 Grant Permissions

LumoDroid will automatically request the following runtime permissions on first launch:

📂 All Files Access (optional but recommended)

For full file management capabilities — recursive directory listing with folder sizes:

1. When prompted, go to "All Files Access" settings page
2. Find LumoDroid in the list
3. Toggle "Allow access to manage all files" to ON
4. Return to the app

LumoDroid supports both Shizuku (recommended) and Termux for running advanced networking and system commands with elevated privileges.

Option A: Shizuku (Recommended)

Shizuku provides a cleaner, more modern approach with no need for root or ADB every time.

Step 1: Install Shizuku

Download Shizuku from Google Play, F-Droid, or GitHub.

Step 2: Start Shizuku

Without root (Android 11+):

1. Enable Developer Options on your device
2. Turn on USB Debugging
3. Connect your device to a computer with ADB
4. Run:

   adb shell dpm set-device-owner com.rikka.shizuku.server/.Receiver

5. Start Shizuku from the app

With root: Simply grant root permission when Shizuku requests it.

Step 3: Grant LumoDroid Access

1. Open Shizuku
2. Scroll to "Running services"
3. Find LumoDroid in the app list
4. Tap to grant access

Option B: Termux (Alternative)

Termux provides a full Linux-like environment with extensive package support.

Step 1: Install Termux

Download Termux from F-Droid or GitHub Releases.

Step 2: Enable External App Access

1. Open Termux
2. Edit properties:

   nano ~/.termux/termux.properties

3. Add:

   allow-external-apps=true

4. Save and restart Termux

Step 3: Grant Display & Run Permissions

1. Go to Settings → Apps → Termux → Display over other apps and enable
2. Grant RUN_COMMAND permission:

   adb shell pm grant com.lumodroid com.termux.permission.RUN_COMMAND

⚡ How It Works

When you ask LumoDroid to run advanced commands like dig, nslookup, whois, nmap, or traceroute:

1. LumoDroid checks if the command is available in its sandbox
2. If not, it routes the command to Shizuku (preferred) or Termux
3. The command executes with elevated privileges
4. Output is captured and displayed in the chat

📋 Supported Commands

Install missing tools:

With Termux:

pkg install whois nmap traceroute curl wget git python nodejs ffmpeg

With Shizuku: Tools must be pre-installed or added via ADB.