這是一篇教導大家如何透過指令與工具來清理與自訂 Android TV 的文章，透過簡單的步驟就能讓自己的電視變得更酷、更好用，再也不用在電視畫面上看到麥當勞的黑色漢堡廣告（如上方右側修改前所示）。
由於 cleanyour.tv 採用開放原始碼，因此也能向 AI 詠唱新功能到電視機裡。
動手操作之前，首先必須準備一台電腦，且作業系統環境為 Windows、macOS 或 Linux 都可以。
覺得下面的準備工具太麻煩，可以先下載 AI 工具(例如: agy cli, copilot cli, openAi, claude cde) 之後, 直接請AI 幫你部署即可。
透過 Android 裝置進行部署
官方的中文教學網址:
https://github.com/Gathin23/cleanyourtv/blob/main/README.zh-TW.md
官方的英文教學網址:
https://cleanyour.tv/app/android
準備工作很簡單，只要確保手機和電視連到同一個 Wi-Fi，且電視是 Android TV 或 Google TV 系統就行，三星、LG 或 Roku 這種非 Android 系統的電視就不適用。
- 第一步是讓手機與電視連線，打開手機上的專屬 App，依照畫面提示在電視設定中開啟網路偵錯，接著看電視螢幕跳出提示時，勾選永遠允許並按下確定。
- 第二步是分析電視內容，點擊開始分析後，App 會讀取電視狀態並列出一張清理計畫，告訴你哪些廣告、追蹤器和品牌多餘功能準備要關閉，而且過程中完全不用擔心，手機會自動先存好還原點。
- 第三步就是執行清理，按下清理按鈕後，那些惱人的干擾就會立刻消失，畫面變得很清爽。
所有的應用程式都只是被關閉而不是直接刪除，隨時都能在 App 裡面還原，就算真的遇到狀況，電視內建的保護機制也會自動恢復原狀。
透過電腦進行部署的準備工作：安裝 adb 指令工具
在開始動手清理電視之前，我們的電腦必須先安裝一個叫做 adb 的小工具，才能夠跟電視進行連線與設定。
如果你在電腦上輸入 adb 指令時，出現「 不是內部或外部命令、可執行的程式或批次檔 」的錯誤訊息，就代表電腦還沒有安裝這個工具。
你只要透過官方提供的連結，直接下載適用於 Windows 的 SDK Platform-Tools 的壓縮檔來安裝即可。
Windows 平台，也可以直接打開終端機或 PowerShell ，輸入這行指令來自動安裝：
winget install -e --id Google.PlatformTools下載並安裝完成後，記得將它解壓縮並設定到環境變數裡面，這樣電腦才能正常使用 adb 指令。
安裝 Android SDK 開發工具
安裝 Android SDK 最簡單的方法，是直接安裝 Android Studio，因為它會在安裝過程中自動下載並配置好完整的開發工具包。
Windows 平台，可以打開命令提示字元或 PowerShell 輸入這行指令來安裝：
winget install -e --id Google.AndroidStudio安裝完成後第一次開啟軟體時，請跟著畫面的提示進行設定，軟體就會自動把 Android SDK 放到預設路徑中。
如果你只需要命令列工具，而不希望安裝整個 Android Studio ，也可以到官方網站下載專用的命令列工具壓縮檔來手動解壓縮安裝，不需要安裝完整的開發環境也能夠管理 SDK。
安裝 Java 執行環境
有些工具或專案需要用到 Java 才能順利執行。
Windows 平台，請打開命令提示字元或是 PowerShell ，輸入這行指令來安裝：
winget install -e --id EclipseAdoptium.Temurin.17.JDK安裝完成之後，請記得關閉目前的視窗，重新打開一個新的 cmd 視窗，然後輸入 java -version 來確認是否安裝成功。
在電視上的操作
1. [設定] Settings → [裝置偏好設定] Device Preferences → [關於] About
2. 對[版次] (或版本號碼) 連續按確認七次
Press OK on Build seven times.
3 返回[開發人員]選項
Go back to Developer options.
4 開啟 [USB 偵錯]
Turn on USB debugging.
保持電視開機，並連線至與電腦相同的 Wi-Fi。
Keep the TV on, on the same Wi-Fi as your computer.
Q: 這個只能在自己家做嗎? 可以幫別人家電視做修改嗎? 答案是可以，只要透過私人的 Tailscale
連線，而不是連到同一個無線網路。可以選擇在他們的電視上安裝 [Tailscale] 並與你共享，或者在他家放一台電腦或 [Apple TV] 來進行轉發。絕對不能直接打開他們路由器上的 [ADB] 連接埠。詳細步驟請參考 docs/REMOTE.md
文件。
檔案下載
原作者的專案在
https://github.com/Gathin23/cleanyourtv
也有其他網友改的滿有趣的, 例如:
https://github.com/kienmai160598/freeTV
原作者的教學網站:
https://cleanyour.tv/
把原作者的 repo 下載為 zip 檔, 解開之後, 執行以下指令即可:
adb connect 10.130.252.224:5555
# your TV's IP address
set TV_HOST=10.130.252.224
adb shell pm list packages > backup\packages.txt
python -m venv tools\venv
tools\venv\Scripts\python.exe -m pip install -r tools\requirements.txt
# model, Android version, firmware
tools\venv\Scripts\python -I tools/tv.py --probe
powershell -ExecutionPolicy Bypass -File launcher\build-and-install.ps1 -TvHost 10.130.252.224
powershell -ExecutionPolicy Bypass -File tools\disable.ps1 -TvHost 10.130.252.224 examples\xiaomi-mitv-mooq0\debloat.txt執行 adb connect 10.130.252.224:5555, 怎麼知道電視機的 ip address, 可以在網路連線的地方得知電視的 ip address:
第一次執行完指令, 需要在電視機上進行一次授權(打勾) 並 [允許] 的動作.
沒修改, 只使用預設值情況下, 把 apk 部署到電視上的執行畫面如下:
增加自己的主題 (themes)
在 themes 目錄, 增加新目錄 leejueun
增加設定檔 .\themes\leejueun\config.json , 檔案內容:
{
"wallpaper": true,
"wallpaper_rotation_minutes": 1
}設定值說明：
啟用(true) “wallpaper“
背景桌布每 1 分鐘進行自動更換
增加一個 wallpapers 目錄, 完整路徑在 \cleanyourtv\themes\leejueun\wallpapers\ , 在目錄裡放很多張漂亮的照片.
透過下面的指令, 把 leejueun 主題套用到電視裡:
powershell -ExecutionPolicy Bypass -File tools\theme.ps1 -TvHost 10.130.252.224 themes\leejueun指令的執行畫面:
更多主題的設定細節
https://github.com/Gathin23/cleanyourtv/tree/main/themes
推薦的 config.json 設定值
{
"background_color": "#07080D",
"wallpaper": true,
"app_library": true,
"ambient_glow": false,
"dock_opacity": 30,
"app_glow": true,
"focus_overshoot": false,
"columns": 8,
"rows_below_dock": 0,
"dock_title": false,
"wallpaper_rotation_minutes": 1
}
參數說明:
- “app_library” 預設值 false, 建議設為 true (開啟), 目的維護那些 App 要被顯示出來.
- “dock_title” 預設值 true (開啟), 建議設為 false, 畫面會清爽一點.
自動化把下載的圖片邊緣柔化: 自動套用溶解特效在圖片邊緣
https://stackoverflow.max-everyday.com/2026/10/python-cv-effect-fade/
增加 addons
官方 macOS/linux 指令範例
cd addons/<name> && ./gradlew assembleRelease && cd ../..
TV_HOST=<tv ip> tools/venv/bin/python -I tools/tv.py --push addons/<name>/app/build/outputs/apk/release/app-release.apk /data/local/tmp/addon.apk
TV_HOST=<tv ip> tools/venv/bin/python -I tools/tv.py 'pm install -r /data/local/tmp/addon.apk; rm -f /data/local/tmp/addon.apk'以 addons name = “天氣” weather + tv ip=10.64.157.224 為範例:
set TV_HOST=10.64.157.224
set ADDONS_NAME=weather
adb connect %TV_HOST%
cd addons\%ADDONS_NAME%
gradlew.bat assembleRelease
cd ..\..
adb push addons\%ADDONS_NAME%\app\build\outputs\apk\release\app-release.apk /data/local/tmp/addon.apk
adb shell pm install /data/local/tmp/addon.apk
adb shell rm -f /data/local/tmp/addon.apk直接執行在 gradlew 會顯示錯誤訊息:
error message:
FAILURE: Build failed with an exception.
What went wrong:
Could not determine the dependencies of task ':app:lintVitalReportRelease'.
SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir path in your project's local properties file at 'C:\Max\play\tv\cleanyourtv\addons\weather\local.properties'.
解法:
建立檔案 local.properties 指出 Android SDK 安裝路徑，檔案內容如下:
sdk.dir=C\:\\Users\\max32\\AppData\\Local\\Android\\Sdk再執行一次就成功了
更新版本
更新程式碼:
git pull
重新部署到電視
set TV_HOST=10.64.157.224
adb connect %TV_HOST%:5555
powershell -ExecutionPolicy Bypass -File launcher\build-and-install.ps1 -TvHost %TV_HOST%說明: 修改 TV_HOST 為你的電視的 ip address
實際在電視上的執行結果
神奇的設定方式是要在右上角的[設定] 常按 OK 鍵，這個真的非常不直覺，就以微調按鈕出現位置和細節設定：
桌布來源: Lee Ju Eun 이주은
https://www.facebook.com/profile.php?id=61567632557770&sk=photos
相關影片
YouTube: https://youtu.be/cZLZNJGWIQ0
YouTube: https://youtu.be/dWwuzGoOnTA
備註
這個cleanyour.tv 專案的底層就是桌面的啟動器(launcher)。
這個cleanyour.tv 專案的做法是停用而非解除安裝，原則上可以還原，但停用到電視依賴的套件仍可能造成異常。部分中國大陸市場的 TCL 電視會拒絕任何啟動器。
重開機後預設的 launcher 又跑出來，通常是因為系統重新載入時，將原廠預設的桌面應用程式（例如 Google TV Launcher）重新取得了首頁的控制權。
如果你使用的是 Android 系統與相關命令列工具，可以嘗試在終端機輸入以下指令來重新確認與停用原廠桌面（以常見的 Google TV 為例）：
Bash
adb shell pm disable-user --user 0 com.google.android.apps.tv.launcherx
如果原廠桌面是舊版的 Android TV Launcher，則套用對應的套件名稱。
相關用法
直接用自然語言跟他講我的需求 ＱＱ
如果要詳細的步驟，就是先把家裡 android TV 的 debug mode 打開，然後把這一段提示詞貼給你的 AI 開始請他優化介面，弄完之後就可以提出各式各樣的需求了 ＸＤ
https://github.com/Gathin23/cleanyourtv/blob/main/PROMPT.md
