ATV Optimizer

Debloat and tune your Android TV from your computer. Disable bloat, switch launchers, sideload APKs, adjust HDMI-CEC and frame-rate matching, and check device health, all from a desktop app. Works on Nvidia Shield TV, Onn 4K Pro, Chromecast with Google TV, Google TV Streamer and other Android TV devices.

Known ADB issue in 2.4.1: A SHIELD TV Pro on macOS has been reported missing from Scan LAN or going offline until connected with standalone ADB. Workaround and status.

It's a native app for macOS, Windows and Linux. It connects to your TVs directly with its own built-in ADB, finds them on your network, and updates itself. You don't need a terminal, Google's adb or any scripting. Google's platform-tools are still one click away in Settings → ADB if a TV doesn't get along with the built-in engine, or for a TV connected by USB.

📱 Coming soon: ATV Optimizer for Android. A phone and tablet version that runs the same cleanup over Wi-Fi, with no computer involved. It's in testing now.

Install

macOS: Homebrew (easiest)

brew tap bryanroscoe/shield-optimizer
brew install --cask atv-optimizer

Homebrew clears the macOS quarantine flag for you, so the app opens with a normal double-click. Upgrade with brew upgrade --cask atv-optimizer, or let the app update itself.

Any platform: download an installer

Get an installer from the Releases page. Choose the newest stable v2-* desktop release; v0.* releases contain the legacy PowerShell script:

OS	File
Windows	.msi or _x64-setup.exe
macOS	_universal.dmg (Apple Silicon + Intel)
Linux	.AppImage, .deb, .rpm, or _x86_64.flatpak

First launch

The builds aren't code-signed yet, so your OS may warn you the first time you open the app. You only have to dismiss it once:

• macOS (.dmg only, Homebrew skips this): on macOS 15+ the dialog only offers Move to Trash / Done. Click Done, then either go to System Settings → Privacy & Security → Open Anyway, or run xattr -dr com.apple.quarantine "/Applications/ATV Optimizer.app".
• Windows (SmartScreen): More info → Run anyway.
• Linux: chmod +x ATV.Optimizer*.AppImage before running the AppImage. The Flatpak installs with flatpak install --user ATV.Optimizer_*_x86_64.flatpak. It doesn't update itself: install the next release's .flatpak the same way.

On macOS 15+, also click Allow when macOS asks whether ATV Optimizer can find devices on your local network. Without it, the app can't reach any TV.

Before you start

Turn on ADB on the TV. You only do this once:

1. Settings → Device Preferences → About → select Build 7 times to unlock Developer Options.
2. Settings → Developer Options → turn on Network debugging, or Wireless debugging if that's what your TV offers. Many Google TV devices only have Wireless debugging.

The TV has to allow this computer once. A TV that hasn't yet is listed as Not allowed yet: click Request approval, then on the TV tick Always allow from this computer and choose Allow.

Using it

1. Launch the app. It scans your network and lists the Android TV devices it finds.
2. For a TV marked Not allowed yet, click Request approval and choose Allow on the TV.
3. Click your device. Each tab is a feature:

Tab	What it does
Overview	Model, Android version, build and hardware ID.
Health	Temperature, CPU and network sampling, RAM and storage, display mode and HDR, audio, and the apps using the most memory, each with a safety verdict.
Playback	What the TV is actually outputting: resolution, refresh rate, HDR and audio passthrough.
Launcher	Install a supported launcher, make it the default, and, where the firmware allows it, disable the stock launcher after you confirm.
App List	Disable, enable or uninstall any app, or install one from the Play Store.
Optimize	The debloat wizard. Review each app's recommended action and RAM use, untick anything you want to keep, then Run. Undo it later with Restore.
Tweaks	HDMI-CEC, match-content frame rate, long-press timeout, animation speed, display scaling, audio passthrough, Private DNS.
Remote	An on-screen D-pad and live typing over a low-latency channel. Paste a long URL or password instead of typing it on the TV.
Files	Browse /sdcard, copy files to and from your computer, and find an app's exported backups.
Install APK	Sideload an .apk from a folder.
Snapshot	Save a device's state and re-apply it later, to the same device (rollback) or a different one (clone).
Shell	Run an ADB shell command directly, for anything the UI doesn't cover.

Can't find your TV?

Use Scan LAN, Add by IP or Pair PIN.

A TV that has never allowed this computer is listed as Not allowed yet. Scanning never shows anything on the TV. Click Request approval on its row: the TV asks "Allow debugging?" (some say "Allow USB debugging?"). Tick Always allow from this computer and choose Allow. The app waits up to 10 minutes; Cancel stops waiting. TVs that already allow Google's adb on this computer connect without asking. With Google platform-tools chosen in Settings, the TV asks by itself the first time the app connects instead.

On a Mac, if nothing is found even by IP, macOS may be blocking the app: open System Settings → Privacy & Security → Local Network and turn ATV Optimizer on. If it already looks on, turn it off and on again. If it's listed more than once, turn every entry on. Then scan again.

This is the beginning of the README. Read the rest at the original. Read the full README ↗