Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
Saved setup from 2 h ago
Will it work on Windows?
The maintainers included tools/setup.ps1. Run it from the cloned folder after reading it.
powershell -ExecutionPolicy Bypass -File .\tools\setup.ps1
Also: tools/setup.sh
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 powershell -ExecutionPolicy Bypass -File .\setup.ps1. 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: winget install Git.Git
git clone https://github.com/loooserking/stvlauncher.git cd stvlauncher
JDK
winget install EclipseAdoptium.Temurin.21.JDK
.\gradlew.bat build -x test
.\gradlew.bat 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 Windows yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.