How to Enable ADB Over USB on Android TV
Updated 2026-10-31
Android TV devices don’t expose a quick settings toggle for ADB access, so enabling it requires going through the hidden developer menu. Below is a step-by-step guide for getting ADB over USB working on most Android TV boxes and set-top boxes that support it.
What developer mode is and why you need it
Developer mode unlocks the ability to load unsigned files via ADB (Android Debug Bridge), which is essential for installing custom apps, testing firmware, and debugging hardware issues on Android TV boxes such as the NVIDIA Shield TV, Xiaomi Mi Box, or the newer LineageOS-for-TV builds. Without developer mode, the settings screen locks down entirely and blocks the ADB command line entirely.
The setting lives in Settings > About > System Information, where you’ll see an option to “Turn on USB debugging.” Enabling it also asks whether you want to allow USB debugging while the device is connected to a PC—answer yes. This permission is what lets the TV send or receive debug commands over a physical connection.
Turning on developer options and USB debugging
Start by navigating to Settings > About. On most Android TV models the About screen shows a compact version that includes the Android version number and a small “Build number” link; tapping it opens the Developer Options page directly. This is where the full developer feature list appears.
Follow these steps:
- Tap Developer Options. If the label doesn’t appear immediately, enable it by tapping “Enter developer mode” at the bottom of the page—this confirms you intend to modify the device.
- Scroll down until you find “USB debugging.” It may take a moment to show up depending on the firmware version.
- Toggle USB debugging on. The tree icon that appears when you tap it should read “ADB over USB” or “Enable debug bridge when connected to a PC.”
- Save the changes. You may be prompted to accept the permission grant on a pop-up; confirm it.
If you cannot find USB debugging in Developer Options, try holding the Back button for several seconds to bring up the hidden quick settings that surface the settings menu. Some regional firmware variants also require restarting the device after toggling it off and on again.
Connecting your computer and verifying ADB works
After enabling developer mode, connect the TV to your workstation via a USB 2.0 cable. Some Android TV boxes negotiate the debug connection over USB 2.0, and you’ll need the correct OTG adapter if you’re plugging into a desktop with a separate USB hub.
On your computer, make sure the appropriate platform tools are installed: the Android SDK Platform-Tools package (adb and platform-tools binaries). Launch a terminal and run:
adb devices
You should see the device listed with a serial number appended to “device.” If it shows up as “unauthorized,” the prompt on the TV didn’t come from you—it likely means the permission dialog was dismissed accidentally or the TV received a revoked authorization. Check that USB debugging is genuinely enabled on the TV, and re-enter the prompt.
Once the device is recognized, you can push tools such as fastboot, logcat, or custom APKs onto the box. You can verify the connection with:
adb -q shell getprop ro.product.model
This should return the model string, confirming that the communication line is active and accepted.
Tips, common pitfalls, and when to stop
A few practical notes that save time when you first hook up an Android TV box to a development PC.
- Use the correct USB power profile: some TVs draw too little current through USB 2.0 for reliable debug traffic. Trying a different power brick or ensuring the PC has ample power helps.
- Prefer a USB-C to USB-A cable (or a dedicated OTG adapter with sufficient amperage) over a thin micro-USB cable. The older HDMI modems often only deliver enough current for basic file transfer.
- If ADB won’t appear after a reboot, power-cycle the TV and unplug for ten seconds before trying again. Official firmware images sometimes leave the debug port blocked until a clean boot.
- Some devices built from custom kernels (for example, LineageOS-based TV builds) hide the debug toggle behind a hidden menu reachable via the recovery settings screen. Check the device-specific wiki for your firmware version.
Disabling developer mode restores the locked-down state when you’re done. Re-enable it the next time you need to sideload a custom app or run adb logcats for troubleshooting.
For security, treat ADB over USB as a privileged interface: avoid installing random APKs from untrusted sources, and keep your device’s firmware updated. Developer mode grants broad system access, so use it only during active development sessions and revert promptly once you’re finished.
Related reading: more Android TV notes
Read next
How to Use ADB Sideloading to Install Apps on a Fresh Android TV Box
Learn how to sideload APKs on a new Android TV via ADB, including setup, command steps, and common pitfalls for smooth app installs.
How to Sideload Apps on Android TV via ADB
Learn how to use ADB sideloading to install native apps on Android TV, step-by-step, for beginners who want fresh content without Play Store limits.