Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Debloat, de-backdoor and speed up cheap Android projectors (T950S, HY300, JM firmware) over Wi-Fi. Reversible.
Saved setup from 8 h ago
Will it work on Linux?
| Device | Firmware | Notes |
|---|---|---|
| KAW K670 | JM, Amlogic T950S, Android 13 | backdoor, 1 GB RAM reported as 2 GB, Home via com.jm.jmlauncher |
Add yours: copy devices/_template, keep it free of personal data (serial, MAC, Wi-Fi name, account names), open a PR.
Problems: docs/TROUBLESHOOTING.md.
The maintainers included tools/install-launcher.sh. Run it from the cloned folder after reading it.
bash tools/install-launcher.sh
On the projector: enable Developer options and USB debugging. Then, on a computer on the same network:
git clone --recurse-submodules https://github.com/tqhit/cleanyourprojector
cd cleanyourprojector
tools/scan.sh 192.168.1.50
The easy way: paste PROMPT.md into Claude Code from this folder and let it walk through your unit, model by
model, the way cleanyourtv does for TVs. By hand: read the scan, then follow devices/<model>/README.md, or for a model not
listed yet tools/inventory.sh and devices/_template/. Needs adb; the launcher build also needs JDK 17 and the Android SDK (platform 34).
When you are done, switch USB debugging off. On JM firmware ADB is root and needs no confirmation, so anyone on your network who reaches port 5555 owns the projector.
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.
Compare yours with the README's “Devices” list above before installing anything.
The repo uses git submodules, so the clone fetches them too.
git clone --recurse-submodules https://github.com/tqhit/cleanyourprojector.git cd cleanyourprojector
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
tools/scan.sh 192.168.1.50
No reports for Linux yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.