How to Use ADB Sideloading to Install Apps on a Fresh Android TV Box

Updated 2026-10-28

How to use ADB sideloading to install apps on a fresh Android TV box

The first time you plug in a brand-new Android TV box, you usually can’t get any apps onto it out of the box. Google Play isn’t available, so the usual path to installing software just stops working. That’s where ADB (Android Debug Bridge) sideloading comes in: a command-line way to push APK files straight to the box over USB without needing a store account or network access. For power users who want the widest possible app selection, the setup takes patience, but once it works the process is reliable and fully reversible.

What ADB sideloading is and why it matters on a clean Android TV

ADB is part of the Android platform by default on most Android TV boxes, and most developers ship their apps as APK files. Sideloading simply means installing an APK that isn’t obtained from the Google Play Store. On a freshly flash-written or factory-released device, sideloading lets you bring over any custom launchers, media players, parental-control tools, or niche utilities you’ve found online. The main advantage over going through an app store is choice: you’re not limited to whatever the manufacturer chose to ship.

There are two ways to make sideloading work: wired via USB to your computer, or wirelessly over ADB’s own network. Wired is much easier on first use because it forces a trusted connection, but wireless becomes more practical once you have ADB set up on a laptop sitting next to the TV.

Preparing the device — firmware, developer mode, and the jump boot

Before you type a single command, check that your box can run ADB. The easiest signal is a device name shown in Settings > About > Device information that looks like “Pixel TV” or “Android TV.” If the phone-style Developer Options menu doesn’t appear, try pressing and holding the Select button + Home to toggle Developer options.

Turning on Developer Mode requires enabling USB debugging on the screen. On many TV boxes this opens a small “Developer Settings” screen buried near the bottom input menu. With it on you’ll flip a switch that unlocks ADB over a connected PC. Some boxes also need a separate “ADB” toggle enabled in Developer Options; if ADB doesn’t respond to adb devices the setting isn’t enough on that model.

Sideloading on a fresh box is also a good moment to flash a minimal stock firmware image from the manufacturer’s website. A clean image gives you a known baseline for performance, voice-command support, and HDMI‑CEC compatibility. Just don’t turn off the network port while doing this, since you’ll need it later for wireless sideloading.

Connecting your PC and enabling ADB on the box

Plug a good-quality USB-C cable into the box’s port and run a supported Android TV debug build on your laptop: Samsung’s Smart TV firmware updates or LG’s webOS TV SDK sometimes bundle ADB over OTA. Once connected:

Open a terminal window on your laptop.
Run adb devices. If the device shows up with a serial number, ADB is talking to the box.
If you see “unauthorized,” tap “Allow USB debugging” on the TV screen and accept the prompt. On some models the confirmation goes to a tiny notification you can dismiss.
Once the device is paired, run adb shell helps to confirm basic shell access. A simple ls /system/ should return output. This tells you you’re in.

At this point you can push an APK from the laptop with adb install my-app.apk. Watch the install progress bar and wait until it finishes silently.

Step-by-step: installing an APK the traditional way

Here’s a concrete example of the exact commands for a typical Windows or Linux laptop:

Adapter: connect the TV’s USB port to a laptop’s USB port.
Command: adb install MyCustomLaunchy.apk
Verify: adb shell pm list packages | grep mycustomlauncher

That pm list packages check is useful because it confirms whether the app installed correctly and shows its package name. You can then launch it from the app drawer or from Settings > Apps & system.

If the APK is a signed install package (a .aapk from an older Android version), you may need to rename it to .apk before adb install, because Android TV’s package manager rejects mismatched signatures in some builds.

Wireless sideloading over ADB’s own network

Once you have ADB working, wireless sideloading is a nice upgrade. Put the PC and the box on the same Wi-Fi network and run adb tcpip 5555 on the laptop. Then run adb connect <IP address>. The box’s address appears in the devices list when you run adb devices again.

Now install with the same adb install command, but from the laptop’s network. This saves you from unplugging and re-plugging the unit each time. A common gotcha: some TV boxes only expose ADB over USB. If adb connect <IP> fails, the model simply doesn’t do wireless ADB, and you’re back to a cable.

When you’re done, adb disconnect to safely end the session.

Common pitfalls and what to watch out for

Stuck on the splash screen. If the box reboots past the logo after a firmware flash, re-enable recovery and restore a stock image before retrying ADB.
Permission errors. Many newer TV boxes disable USB debugging by default. If you can’t get ADB to see the device after a reboot, hold the power button for ten seconds to force a hard reset, then re-enable the setting from the Developer Options screen.
APK version mismatches. Android TV ships with different permission sets than phones. An APK built for Android 14 may refuse to install on a 2019-style box. Look for builds labeled “Android TV” or “TV beta.”
Storage limits. A fresh box often has 8 GB of internal storage and a small flash partition. Large apps won’t fit, so install smaller utilities first and consider moving data to an attached USB drive if needed.
No Google Play services. This guide assumes zero reliance on Play Store. If you later enable Play Services, many of the benefits of sideloading disappear. Stick to sideloaded apps in their installed state.

Reverting the process and keeping things tidy

If you ever want to remove a sideloaded app, adb uninstall com.example.YourAppName removes it cleanly. To delete everything at once, pull a list of installed packages (adb shell pm list packages) and uninstall them one by one. Back up your custom launch configuration by copying the app’s config folder (usually in /data/data/<package>/) before uninstalling.

For ongoing maintenance, create a small folder on your laptop named “Android TV Sideloads” containing the APKs you’ve tested and their versions. That makes it easy to roll back to an earlier build if a new sideloadged app breaks something. The whole process rewards patience: once the USB connection is trusted and your commands memorized, installing and removing apps on an Android TV box feels as natural as sideloading on a phone.