Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/NuvioMedia/NuvioTV/llms.txt

Use this file to discover all available pages before exploring further.

NuvioTV is distributed as an APK and is not listed on the Google Play Store in its full-featured form. Installation requires enabling sideloading on your Android TV device, then transferring the APK either directly or over ADB. This page covers both methods and explains the differences between the available build flavors.

System requirements

RequirementMinimum
OSAndroid TV / Google TV
Android API level24 (Android 7.0)
Target API level36
Architecturearmeabi-v7a, arm64-v8a, x86, or x86_64
While the minimum SDK is API 24, NuvioTV is designed and tested for Android TV-class devices. Phones and tablets are not a supported form factor — the entire UI is built with TV Material3 and optimized for D-pad navigation.

Build flavors

NuvioTV ships two distribution flavors. Make sure you download the right one:
FlavorPackage IDPlugin supportIn-app updatesIn-app trailersExternal trailers
fullcom.nuvio.tv✅ Yes✅ Yes✅ Yes✅ Yes
playstorecom.nuvio.app❌ No❌ No❌ No✅ Yes
Always use the full flavor unless you specifically need the Play Store variant. The full APK is the one published on GitHub Releases.
Before installing any APK you must allow installation from unknown sources on your Android TV device. Go to Settings → Device Preferences → Security & Restrictions (exact path varies by manufacturer) and enable Unknown sources or Install unknown apps for whichever app you will use to open the APK (e.g., a file manager or the ADB source). Without this, the system will silently block the install.

Installation methods

Build from source

If you want to compile NuvioTV yourself, see the Building from Source guide. You will need Android Studio (latest stable), JDK 11+, Android SDK targeting API 36, and Gradle 8+. A quick reference for the most common build tasks:
# Clone the repository
git clone https://github.com/tapframe/NuvioTV.git
cd NuvioTV

# Build the full debug flavor
./gradlew :app:assembleFullDebug

# Launch the debug build on a connected device (debug builds use the com.nuviodebug.com package ID)
adb shell am start -n com.nuviodebug.com/com.nuvio.tv.MainActivity

First-launch flow

After opening NuvioTV for the first time you will be guided through a short onboarding sequence before reaching the main app:
  1. Account sign-in — A QR code screen lets you sign in to a NuvioTV account on your phone for profile sync and settings backup. You can tap Skip to continue as a guest.
  2. Experience mode selection — Choose between Essential (focused setup: add-ons, playback basics, Trakt, account) and Advanced (full settings: layout, catalog order, collections, plugins, diagnostics). You can switch modes later from Settings.
  3. Addon setup — If you chose Essential mode with no addons installed, an addon setup prompt appears. Add at least one Stremio-compatible addon or tap Continue for now to skip.
After these steps you land on the Home screen. See the Quickstart guide to install your first addon and start streaming.

Build docs developers (and LLMs) love