---

Supported Platforms

Platform	Module	Description
📱 Phone & Tablet	:app	Material 3 UI, dynamic colors & spring animations
📺 Android TV	:tv	D-pad navigation, 10-foot UI with QR code pairing & remote receive
⌚ Wear OS	:wearos	Wear Compose UI for smartwatch package management & install

---

Supported Formats

• Single APK: .apk
• Split APK Bundles: .apks, .xapk, .apkm, .apk+
• Manual Splits: Merge multiple individual .apk files into a single installation session
• Game Data: Automatic extraction & background placement of .obb expansion files

---

Key Features

• ⚡ Flexible Installation Backends:

  • Standard system installer, Shizuku, and Root (libsu). On phones and tablets, Porter can serve the Shizuku engine too.
  • Silent install and uninstall without prompts.
  • Privileged controls: allow downgrade, bypass minimum SDK restrictions, grant permissions, install for all users, and spoof installer package names (Google Play, F-Droid, Aurora Store, Amazon, etc.).

• 📦 Seamless OBB Support:

  • Auto-extracts .obb files from XAPK/APKM archives directly to Android/obb/<package>/.
  • Attach standalone OBB files to APK installs.
  • Multi-tier write strategy: Direct I/O, Shizuku, or Storage Access Framework (SAF).

• 🛡️ VirusTotal Security:

  • Automatic SHA-256 hash lookup before install.
  • Engine detection breakdown (malicious, suspicious, clean).
  • On-demand file upload scan for unindexed packages (up to 650 MB).

• 🌐 Local Sharing & Send to TV:

  • Built-in HTTP server and web dashboard for transferring APKs from PC or mobile browser.
  • Push packages directly to Android TV via QR code scanning.
  • Optional PIN security for local network access.

• 🗂️ App Manager:

  • Inspect installed user & system apps with rich details (SDK targets, size, permissions, signatures).
  • Sort and filter by name, install date, size, or last used time.
  • Batch uninstall with detailed status logs.

• 📥 Remote Downloader & Intake:

  • Download APK packages directly from web URLs with download history.
  • Deep-link and intent handling to open packages from browsers, messaging apps, and file managers.

---

Tech Stack

• UI: Jetpack Compose, Wear Compose, Material 3
• Installer Engine: Ackpine & Shizuku (or Porter through its Shizuku-API bridge)
• Networking: Ktor
• Storage & Async: Room, DataStore, WorkManager
• Dependency Injection: Koin

---

Project Structure

├── app/        # Android Phone & Tablet application
├── tv/         # Android TV application
├── wearos/     # Wear OS smartwatch application
├── core/       # Shared engine (package parsing, installers, storage, networking)
└── updater/    # In-app update checking logic

---

Building from Source

Prerequisites

• Android Studio Ladybug or newer
• JDK 17+
• Android SDK 36

Build Commands

# Build Phone app (open-source flavor)
./gradlew :app:assembleOpensourceDebug

# Build Android TV app
./gradlew :tv:assembleDebug

# Build Wear OS app
./gradlew :wearos:assembleDebug

# Build all debug variants
./gradlew assembleDebug

Note: The play flavor of :app requires app/src/play/google-services.json (see docs/FIREBASE.md). Without it, build the opensource flavor.

---

Contributing & License

• Issues & Requests: GitHub Issues
• License: GNU General Public License v3.0 (GPL-3.0)
• Maintainer: Nguyen Quang Minh