Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Saved setup from 2 h ago
Will it work on macOS?
The maintainers included tools/setup.sh. Run it from the cloned folder after reading it.
bash tools/setup.sh
Also: tools/setup.ps1
CONTRIBUTING.mdThanks for wanting to help! Bug reports, new debloat profiles, fixes and ideas are all welcome.
profiles/ (one package name per line). Tell us the TV model and Android version you tested on.good first issue or help wanted.| Path | What lives there |
| --- | --- |
| app/src/main/java/com/tvlauncher/app/ | The launcher (Java, no extra libraries) |
| app/src/main/res/ | Layouts, drawables, app icon, and fonts |
| profiles/ | Per-brand debloat lists |
| tools/ | audit.sh, apply.sh, restore.sh and the setup scripts |
| tools/protected.txt | Packages that must never be disabled |
You need JDK 17 and the Android SDK (API 34).
./gradlew assembleRelease
# APK: app/build/outputs/apk/release/app-release.apk
Install on your TV over ADB:
adb connect <TV_IP>:5555
adb install -r app/build/outputs/apk/release/app-release.apk
Please test on a real Android TV / Google TV device (or an Android TV emulator) and use the remote (D-pad, Back, Home) to check focus and navigation.
main (fix/recents-focus, feat/new-suit, profile/hisense-u8).tools/protected.txt, or that breaks Wi-Fi, Bluetooth, HDMI inputs, Settings or the system UI.This is an independent, open-source project.
Be kind and respectful. See CODE_OF_CONDUCT.md.
By contributing, you agree that your contributions are licensed under the MIT License.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/loooserking/stvlauncher.git cd stvlauncher
JDK
brew install openjdk@21
./gradlew build -x test
./gradlew run
To build this project, use:
./gradlew assembleDebug
The APK will be located in app/build/outputs/apk/debug/app-debug.apk.
No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.