Installation & Setup

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

📦 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 integrates with Termux to provide advanced networking and system tools not available in Android's default shell.

Step 1: Install Termux

Download Termux from F-Droid (recommended) or the GitHub Releases.

Step 2: Enable External App Access

1. Open Termux
2. Create or edit the Termux properties file:

   nano ~/.termux/termux.properties

3. Add or uncomment this line:

   allow-external-apps=true

4. Save (Ctrl+O, Enter) and exit (Ctrl+X)
5. Fully close Termux (type exit until it closes, or swipe it away)
6. Reopen Termux to apply changes

Step 3: Grant Display Over Other Apps

Termux needs this to display command sessions when invoked from LumoDroid:

1. Go to Settings → Apps → Termux → Display over other apps
2. Toggle "Allow display over other apps" to ON

Step 4: Grant RUN_COMMAND Permission

This allows LumoDroid to send commands to Termux. It should auto-grant, but if you see an error:

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

Or reinstall LumoDroid after Termux is installed — the permission request will fire automatically.

⚡ How It Works

When you ask LumoDroid to run a command like dig, nslookup, whois, nmap, or traceroute:

1. LumoDroid detects the command isn't available in its sandbox
2. It routes the command to Termux via the RunCommandService intent
3. The command executes in Termux's background shell
4. Output is written to a shared file (/sdcard/LumoDroid/termux_results/)
5. LumoDroid reads the output and displays it in the chat

📋 Supported Termux Commands

Install missing tools via Termux:

pkg install whois nmap traceroute curl wget git python nodejs ffmpeg

When a command isn't installed, LumoDroid will detect the error and suggest the correct pkg install command.