First‑time setup of sideloaded third‑party apps on Google TV: a guide

Updated 2026-10-21

First-time setup of sideloaded third‑party apps on Google TV interface

Why sideloading matters on modern Google TV

If you have just finished flushing the default store out and want to put a specific app on your Fire TV or NVIDIA Shield that does not ship with Android TV, the only practical route is sideloading. The official Play Store blocks many apps from installing outside its curated catalogue, so sideloading—pushing an .apk file via ADB, a USB drive, or a trusted repo—becomes the mechanism that actually gets work done. On first‑time use, most people discover that the stock UI shows a blank home‑screen or keeps redirecting them to recommended content. Getting around that and installing the exact app you need without waiting for the platform team to approve it takes a few deliberate steps.

CleanYourTV, a lightweight custom launcher for Android TV, makes the process less alien. It strips away the heavy default skin and replaces it with a simple grid of app icons, plus a settings pane that exposes sideload permissions more clearly than the stock Settings → Apps menu. Learning the sideloading flow on that base layer is what turns a confusing first launch into a repeatable workflow.

Preparing a clean environment before you push APKs

Before you try sideloading anything, make sure your receiver is healthy. A buggy network connection is the number one cause of failed installs, because the APK has to finish downloading and verifying before the package manager accepts it. Check that you have:

Once the device is ready, create a dedicated folder on the internal SD card (or on the always‑empty hidden partition if your model supports external storage) for APK files. Name each file with a clear, versioned label such as com.example.app_v2.1.apk. Renaming removes metadata that often triggers Smart Storage auto‑cleanup, and a short version suffix helps you roll back to the last install after a bad update.

Getting CleanYourTV installed and configured

Because the stock launcher is locked down, the first change is to get CleanYourTV onto the device. It comes pre‑packaged as a small APK with no dependencies, and you can place it directly on the home screen from the default browser or from any installed browser.

After sign‑in and reboot:

  1. Open the new launcher icon. The icon looks like a minimalist square with a soft blue background.
  2. Go to Settings → Advanced → Enable Custom Launcher Permissions. Flip the toggle.
  3. Open Settings → System → Developer options (enable developer mode if it is still hidden).
  4. In the Developer section, turn on “Apps from unknown sources” (you may see it as “Install unknown apps” on some firmware). This unlocks ADB side‑loading.
  5. Accept the prompt, then restart the device.

When the device boots again, the CleanYourTV grid appears. You can now drag any installed APK onto the home screen just by tapping it. CleanYourTV also provides a “Repair corrupted icons” button that fixes missing thumbnails after a partial uninstall—handy when you rotate between sideloaded utilities and stock apps.

The actual sideloading procedure (ADB method)

The most reliable way to push an installer is via ADB from a PC or Mac terminal on your laptop. The following commands are standard across all Android platforms, including Android TV boxes.

  1. Connect the device over USB, or use Wi‑Fi ADB if the receiver supports Chromebook streaming.

  2. Run adb shell pm clear com.google.android.tv to reset the default launcher cache. This avoids interference.

  3. Install your APK:

    adb install -r -g --permissions=all /path/to/com.example.app_v2.1.apk
    • -r replaces an existing version.
    • --permissions=all temporarily lifts the restriction so the package can declare its signed APK; the OS discards these flags on next boot.
    • If you are sideloading inside the CleanYourTV layout rather than via ADB, simply tap the APK icon; the launcher’s own installer passes the same arguments automatically.
  4. Reboot the device: adb reboot.

  5. Verify the install: adb shell pm path com.example.app should return the path. Launch the app from the CleanYourTV grid and check that its main window opens.

If you receive a “App not installed” error despite the APK being well‑formed, the most common cause is that the signing certificate differs from one you installed. Download the exact APK that matches the signature of your package and retry. CleanYourTV’s “Package info” pane lists the package’s SHA‑256 fingerprint, which you can compare to the file digest from your source.

Safety checklist before enabling sideload install on every channel

Sideloading removes the platform’s checks, so treat it like any permission you grant to a third‑party binary:

A short checklist works well:

If the answer is no to any item, delete the file and look for the same functionality through the stock Play Store.

Uninstalling and cleaning up after a test run

When you have finished testing an app, do not leave it sitting on the system. Android TV devices are small, and the default automatic cleanup does not scan your custom launcher’s private folders. Use CleanYourTV to remove the icon, then run adb uninstall -k /data/system/privileged_app_packages/com.example.app from a rooted device. On unsupported models (for example, some early NVIDIA Shield), Power off, hold the volume buttons, and enter recovery, then select “wipe cache partition.” That removes leftover .apk remnants from the /data/local/tmp scratch area.

CleanYourTV also offers a “Remove all sideloaded packages” button, which wipes every non‑stock app. Use it only after you have confirmed that you no longer need the tested bundle—Google TV’s stock system updates sometimes require the default camera and microphone apps to remain untouched.

TL;DR summary of the first‑time sideload workflow

Start by preparing the device—enough storage, updated firmware, and a stable Wi‑Fi link. Install CleanYourTV from the Play Store, enable developer‑mode features, and turn on unknown‑source installation. Use ADB to push the APK with adb install -r -g --permissions=all, reboot, and confirm the package runs. Before each install, verify the signature, cross‑check the SHA‑256 hash against the launcher’s package info, and limit sideloaded apps to one per functional channel. After testing, remove the app with CleanYourTV’s uninstall tool and wipe the cache partition. Following these steps lets a first‑time user move from a blank Google TV home screen to a working third‑party app suite without relying on the Play Store.

Related reading: more Android TV notes

Read next