How to Sideload and Manage Streaming Client Libraries on Android TV

Updated 2026-11-01

Managing sideloaded streaming client libraries (e.g., Kodi, Plex) on Android TV efficiently

Why Android TV Needs a Separate Sideloading Workflow

Most users grab an APK from a trusted site, drop it into the Files app, and install it through ADB or the Settings install-from-unknown sources screen. On Android TV the same pattern works, but the consequences are steeper: a broken or malicious library can hang the UI, break voice-command hooks, or expose your network traffic. Android TV’s launch screen and home launcher are more rigid than a phone, so once a rogue library is active it’s harder to roll back cleanly.

The goal here is simple: keep custom streaming apps—Kodi, Plex, and similar—installable, restorable, and safe to update without risking the core OS image. The CleanYourTV launcher helps, but managing the sideloaded client libraries remains a separate skill set.

Preparing a Safe Sideload: Vetting and Secure Storage

Before you even touch an APK, spend time on vetting. Android TV doesn’t have App Store sandboxing the way iOS does, so every package you install lands in a position where it can access the entire network stack. Follow this checklist:

Download only from sites you trust. Some “Kodi installer” mirrors bundle outdated cores or custom plugins with aggressive telemetry.
Verify checksums against official sources. Plex Media Player ships its own .apk; don’t use third-party wrappers.
Keep a backup of the stock Android TV image or at least a snapshot of the current state before adding libraries.

Storage matters too. Android TV exposes the Files app with a limited internal partition. Put your APKs in a dedicated folder like /Android/data/com.kodi.kodi and avoid dumping them on the external SD card. CleanYourTV’s launcher cache stores metadata in the system partition, so keep the directory tree shallow: one folder per app, no nested script folders. This makes cleanup and rollback later predictable.

Installing Sideloaded Clients via CleanYourTV or ADB

CleanYourTV’s launcher has a manual “Add Library” flow that lets you point the app at a local APK file. On a 65-inch set top box connected via LAN or USB, the process looks like this:

Copy the APK to the TV using a USB stick, a secure FTP pull from your office machine, or the Google Drive picker built into most TVs.
Open CleanYourTV, tap Add Library, select the file, and confirm placement under your chosen profiles folder.
Launch the installed client normally. It will register its playlists, subtitles, and API hooks with the Home interface.

If you prefer command-line precision, adb install --target /data/local/tmp/client.apk. On Android TV the --target flag points to the system partition, but for privacy-conscious installs you can instead push to /mnt/sdcard/Android/data/ and hand-deliver it. After installation, always verify the binary hash with apktool d client.apk --bepackage and compare the SHA-256 to the checksum you recorded earlier.

Keeping Libraries Updated Without Breaking the UI

Updates are the part that breaks most often. A new Kodi release might change the video decoding path or the way it talks to the Home launcher’s media center. If you force an update while the old library is active, the UI can show greyed-out icons, and voice control stops routing commands to any player.

Best practice:

Keep one version of each client at a time. Don’t install a second Kodi .apk while the first one is running.
Check the developer blog or GitHub release notes before pulling a new build. For Plex, the standard build is fine; for Kodi, prefer the official kodi‑android ports with LNMS components.
Test the update on a secondary “clean” profile TV first. If the upgrade introduces a regression in picture rendering or network discovery, roll back immediately and report the issue.

Use the launcher’s built-in version history if available. Some builds of CleanYourTV let you pin an older APK to a profile and toggle between two versions side-by-side. Disable auto-update for sideloaded apps in Settings → Apps → [App] → Disable updates. You’ll have to remember to re-check manually, but the trade-off is worth it: a stable entertainment surface beats a constantly broken one.

Organizing Multiple Clients: Profiles, Playback, and Nested Libraries

A common mistake is dumping Kodi, Plex, and a niche app like Infuse all in the same root folder, then trying to switch between them with the remote. Each library has its own settings, add-ons, and cache. A clean partition scheme looks like this:

/mnt/media/kodi/ — Kodi 3.x installation, plus its add-on .x86_64 folder
/mnt/media/plex/ — Plex Media Player + Plex Pass features
/mnt/media/custom/ — niche players, legacy tools, or deprecated builds you’ve retired

Keep the home launcher’s “Add to profile” option turned off for Sideloaded profiles. This prevents the launcher from accidentally surfacing the internal paths of hidden apps when you press Back or the quick settings grid. Instead, create a single “Stream Hub” tile that points to a custom script wrapper (a small shell script that launches the client with the correct profile arg).

When you need to remove a library, uninstall it through Settings → Apps, then manually delete the folder from the TV. Reinstalling from the same APK after removal is safe because CleanYourTV’s caches store only the metadata; the old binary is overwritten.

Common Pitfalls and When to Stay Clear

Some developers ship Kodi builds with custom shaders that require GPU drivers not present in the vanilla Android TV firmware. Those builds will crash at launch, and there’s no easy fix. The same goes for Plex plugins that depend on the Google Play Movies and TV APIs, which have different permissions on the TV platform.

If you’re planning a permanent library swap (for example, moving from a 19-year-old Kodi build to a current release), back up your watch history, subscriptions, and profile watchlists before touching the system partition. CleanYourTV can export your library list, but it won’t restore subtitle packs or personal DNS settings automatically.

My rule of thumb: if the installer’s error message mentions “manifest mismatch,” stop and re-download the correct build. On Android TV, manifest mismatches tend to be worse than a blank screen—because the launcher keeps retrying, locking the home screen until you hard-reset. Resolve with a verified APK, and you avoid a night-long fight with the device’s recovery mode.

Summary

Sideloading streaming clients on Android TV is straightforward if you treat the TV as a constrained environment and follow a disciplined workflow: vet the APK, isolate it in its own folder, keep one version per app at a time, test updates on a secondary device, and always back up before you modify the system layout. CleanYourTV gives you a convenient library manager, but the real safety net is a clean backup of your watch profiles and settings—something the launcher itself can’t protect. With those habits in place, Kodi, Plex, and other clients can coexist alongside the stock Home experience without turning your 65-inch screen into a troubleshooting canvas.