Repolode
Submit
bryanroscoe

bryanroscoe/shield_optimizer

Desktop app and PowerShell script to debloat, tune, and health-check Android TV devices such as Nvidia Shield TV over ADB.

View on GitHub
Stars
1,415
Forks
43
Open issues
10
Last commit
yesterday

What is it?

ATV Optimizer manages Android TV devices from a computer over ADB. It can disable preinstalled bloat, switch the home launcher, sideload APKs, adjust HDMI-CEC and match-content frame-rate settings, and report on temperature, memory, storage, and what video and audio the TV is outputting.

The project ships in two forms: a native desktop app (v2, in beta) installed via Homebrew or a downloaded installer, and a terminal-based PowerShell 7 script (v1). Both run the same ADB commands and share one feature catalog. The app bundles its own adb and scans the local network for devices on startup.

The tool targets Nvidia Shield TV, Onn 4K Pro, Chromecast with Google TV, and Google TV Streamer. Available actions depend on the device firmware. Fire TV support depends on the build, since some Fire OS versions block changes to the stock launcher. Disables are reversible through a Restore function, and a do-not-disable list guards critical system packages.

Key features

  • 01Disable, enable, or uninstall preinstalled apps with a recommended-action debloat wizard
  • 02Switch the home launcher and install supported launchers
  • 03Sideload APK files and browse, upload, or download files on the TV
  • 04Adjust HDMI-CEC, frame-rate matching, animation speed, and audio passthrough
  • 05Show temperature, CPU, RAM, storage, and display or audio output status
  • 06Snapshot a device's settings and re-apply them to the same or another TV

Use cases

  • Removing manufacturer and carrier bloat from a new Shield TV or Google TV device
  • Setting up several Android TV boxes with the same configuration
  • Diagnosing playback problems by checking the actual HDMI output mode
  • Sideloading apps onto a TV without a remote-friendly install path

Quick start

  1. 1

    Enable Developer Options and Network Debugging on the TV

  2. 2

    Add the Homebrew tap (macOS)

    brew tap bryanroscoe/shield-optimizer
  3. 3

    Install the desktop app with Homebrew (macOS)

    brew install --cask shield-optimizer

Things to know

  • The desktop app is a public beta and its builds are not code-signed yet.
  • Fire TV support depends on the firmware build, and some builds block changes to the stock launcher.
  • The README does not state a clear license, so reuse terms are unclear.
  • Modifying system apps carries risk, and some changes may not be reversible on certain firmware.

Topics

#android-tv#adb#debloat#shield-tv#powershell#rust#desktop-app#home-automation

FAQ

What is shield_optimizer?
Desktop app and PowerShell script to debloat, tune, and health-check Android TV devices such as Nvidia Shield TV over ADB. ATV Optimizer manages Android TV devices from a computer over ADB. It can disable preinstalled bloat, switch the home launcher, sideload APKs, adjust HDMI-CEC and match-content frame-rate settings, and report on temperature, memory, storage, and what video and audio the TV is outputting.
Is shield_optimizer free to use? What license does it have?
shield_optimizer is open source under the Other license. Check the license terms before using it in commercial products.
Is shield_optimizer still maintained?
Actively maintained. The last commit to shield_optimizer was on Oct 19, 2026.
What can I use shield_optimizer for?
Removing manufacturer and carrier bloat from a new Shield TV or Google TV device Setting up several Android TV boxes with the same configuration Diagnosing playback problems by checking the actual HDMI output mode Sideloading apps onto a TV without a remote-friendly install path
How do I install shield_optimizer?
Enable Developer Options and Network Debugging on the TV Add the Homebrew tap (macOS): brew tap bryanroscoe/shield-optimizer Install the desktop app with Homebrew (macOS): brew install --cask shield-optimizer
Where can I get shield_optimizer?
The source code and installation instructions are on GitHub: https://github.com/bryanroscoe/shield_optimizer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects