Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Saved setup from 2 h ago
Will it work on Linux?
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.
git clone https://github.com/loooserking/stvlauncher.git cd stvlauncher
JDK
sudo apt install openjdk-21-jdk # Debian/Ubuntu
./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 Linux yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.