已收錄469 則資訊/102 款 AI 工具/417 個開源專案/75 個學習資源
首頁資訊開源排行榜模型排行AI 工具Skills學習資源
首頁 / 開源排行榜 / cleanyourtv

cleanyourtv

透過 Wi-Fi 移除 Android TV 與 Google TV 上的預裝臃腫軟體、廣告與遙測資料，並安裝輕量化的 Apple TV 風格啟動器；全程可逆且無需 root。

JavaNOASSERTIONApplication
⭐ GitHubhttps://github.com/Gathin23/cleanyourtv
30,126
Star 數
+0
Star 增速
2026年10月24日
最後更新
11
點擊數

1. 專案概覽

CleanYourTV 是一款專為 Android TV 與 Google TV 設計的開源工具組，能透過 Wi-Fi 移除預裝的臃腫軟體、廣告與遙測資料，並將原廠主畫面替換為輕量化的 Apple TV 風格啟動器——無需 root、不需傳輸線、不會解除安裝任何程式，且只要一行指令即可還原。

2. 背景與定位

開發緣由

許多智慧電視出廠時便預載了各種應用程式、促銷內容列、廣告服務與背景遙測功能，不僅拖慢裝置速度，也讓主畫面變得雜亂。CleanYourTV 讓使用者能以安全且可逆的方式掌控自己的電視，而且只使用使用者本來就有權限更改的設定（內建的 ADB 偵錯功能）。

與類似專案的差異

  • 設計上即具備可逆性： 應用程式是透過 pm disable-user 停用，而非解除安裝；搭配記錄下來的快照，只需一道指令即可還原。
  • 辨識裝置型號： 精簡清單會依品牌而異，因此程式碼助理會先檢查你的特定電視型號，並在進行任何更動前徵求同意。
  • 內附啟動器： 精簡系統與替代主畫面整合在同一個專案中（約 497 KB、純 Java 撰寫，可在 1 GB RAM 的電視上執行）。
  • 社群實測清單： examples/ 資料夾收錄了由使用者貢獻的各機型精簡清單（超過 170 款機型）。

3. 功能分類

🧹 精簡系統與移除廣告

無需 root 即可停用遙測、廣告服務、內容列與預裝應用程式。

  • 備份已安裝的套件清單與設定
  • 以 pm disable-user 為基礎的停用方式（不會解除安裝任何項目）
  • 安全檢查：若未提供替代方案，將拒絕停用目前使用中的主畫面應用程式
  • check.py 可偵測被韌體更新重新啟用的套件（加上 --fix 即可重新套用設定）
  • 一行指令即可從記錄的狀態還原

📺 輕量化啟動器

專為 Android TV 與 Google TV 打造的快速、極簡替代主畫面。

  • 黑色背景搭配收藏列與應用程式網格
  • 頂部橫幅會顯示目前聚焦的應用程式名稱
  • 玻璃風格的焦點提示與毛玻璃效果按鈕（輸入源、網路、設定）
  • 時鐘螢幕保護程式，可選擇顯示 CPU、記憶體與儲存空間資訊
  • 支援 25 種語言，包含鏡像的右至左版面配置

🎨 主題與自訂

無需重新編譯啟動器即可個人化外觀。

  • 可自訂顏色、桌布、收藏列與欄數
  • 內建 default、aurora 與 six-columns 等主題
  • 使用 tools/theme.sh 套用主題
  • 遙控器按鍵重新對應與應用程式庫（選用）

🧩 附加元件與模組卡片

透過選用的應用程式擴充啟動器功能。

  • 其他應用程式必須經過使用者同意才能新增磁貼
  • 附加元件存放於 addons/ 資料夾
  • 在 cleanyour.tv 上有應用程式與附加元件的專屬頁面

🔒 隱私與安全工具

了解並減少電視在背景執行的動作。

  • privacy.py 會列出語音、ACR 與遙測的候選項目並附上證據
  • adb-closed.py 可確認完成後網路 ADB 連接埠已關閉
  • 選用的 AdGuard DNS 設定，透過私人 DNS 阻擋應用程式內廣告
  • 選用的 Tailscale，用於安全的遠端管理

🛠️ 開發者與診斷工具

供維護者與貢獻者使用的公用程式。

  • tv.py：純 Python 撰寫的 ADB 用戶端與探測工具
  • bench.py、trace.py 與 screendiff.py：用於效能與視覺檢查
  • manage.py：用於裝置管理
  • tests/ 中的測試套件

4. 主要亮點

  • 無需 root、不需傳輸線： 透過電視內建的網路 ADB 偵錯功能，經 Wi-Fi 運作。
  • 完全可逆： 不會解除安裝任何項目，基於快照的還原功能可讓電視回到先前狀態。
  • AI 輔助工作流程： 將 PROMPT.md 貼到 Claude Code、Codex 或 Gemini CLI 等程式碼助理中，它會在約十五分鐘內引導你完成整個清理流程。
  • 超小型啟動器： 約 497 KB，以純 Java 撰寫，支援 Android 8.0（API 26）及以上版本。
  • 廣泛的社群支援： 針對 TCL、Sony、小米與 Philips 等品牌超過 170 款電視機型提供經過測試的精簡清單。
  • 預設支援多國語言： 介面支援 25 種語言，README 亦提供日文、越南文與簡體中文翻譯。

5. 各角色使用情境

  • 一般使用者與電視擁有者： 在不承擔技術風險的情況下，獲得更快、更乾淨的主畫面。
  • 一般開發者： 研究精簡的原生 Android TV 啟動器與純 Python ADB 用戶端。
  • DevOps / SRE： 使用腳本與 Tailscale 遠端管理大量電視或互動式終端設備。
  • 資安工程師： 使用 privacy.py 稽核遙測、語音與 ACR 候選項目，並驗證事後 ADB 是否已關閉。
  • 專案經理 / 系統整合商： 使用共享的精簡清單，準備一致且無廣告的數位看板或飯店展示螢幕。

6. 快速入門

尋找所需資源

瀏覽 examples/ 中的各機型清單與 docs/ 中的指南，或造訪 https://cleanyour.tv。

安裝 / 整合

  1. 在電視上啟用開發人員選項與 USB 偵錯，並讓電視與電腦連上同一個 Wi-Fi 網路。
  2. 將 PROMPT.md 貼到程式碼助理中並輸入你的電視型號，或執行以下手動指令：
git clone https://github.com/Gathin23/cleanyourtv.git
cd cleanyourtv
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
tools/disable.sh examples/<model>/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh
tools/theme.sh themes/aurora

若要復原所有更動：

tools/restore.sh examples/<model>/debloat.txt

你也可以使用社群開發的 Android 應用程式，直接從手機進行清理，無需電腦。

參與貢獻

將你測試過的電視機型精簡清單加入 examples/，接著閱讀 CONTRIBUTING.md 並提交拉取請求：https://github.com/Gathin23/cleanyourtv/blob/main/CONTRIBUTING.md

7. 專案結構

cleanyourtv/
├── addons/        # 選用附加應用程式，以模組卡片形式顯示
├── docs/          # 指南、規格、疑難排解、裝置注意事項
├── examples/      # 各機型精簡清單
├── launcher/      # Android 啟動器原始碼與建置腳本
├── themes/        # 主題資料夾（default、aurora、six-columns 等）
├── tools/         # Python/shell 公用程式（tv.py、disable.sh、restore.sh、check.py、privacy.py）
├── tests/         # 測試套件
├── PROMPT.md      # 供程式碼助理驅動設定的提示詞
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

8. 相關生態系

  • Android Debug Bridge (ADB)： 用於控制電視的機制。
  • 程式碼助理： Claude Code、Codex 與 Gemini CLI 皆可驅動引導式設定流程。
  • 建置工具鏈： 啟動器使用 JDK 17 與 Android SDK 平台 34，搭配 build-tools 34.0.0。
  • 選用服務： Tailscale（遠端管理）與 AdGuard DNS（廣告阻擋）。
  • 相關平台： Fire TV 僅支援精簡系統；Samsung (Tizen) 與 LG (webOS) 屬於不同系統，另有獨立說明。

9. 授權條款

  • ✅ 依據 MIT 授權條款（如專案 README 所述），可使用、複製、修改與散布本軟體，包含商業用途
  • ✅ 可將其納入你自己的專案中，但須保留授權聲明
  • ❌ 不提供任何擔保；作者不對損害負責
  • ❌ 與任何電視製造商均無關聯，亦未獲其背書
  • ℹ️ GitHub 將此授權顯示為無法識別 (NOASSERTION)；請查閱儲存庫中的 LICENSE 檔案
  • ℹ️ Outfit 字型採用 SIL Open Font License 授權

10. 常見問題

問：這樣做安全嗎？可以復原嗎？
答：應用程式只會被停用，絕不會被解除安裝。執行 tools/restore.sh examples/<model>/debloat.txt 即可還原。

問：支援 Fire TV、Samsung 或 LG 電視嗎？
答：Fire TV 僅支援精簡系統。Samsung (Tizen) 與 LG (webOS) 屬於不同系統，並未直接支援。

問：韌體更新會取消這些更動嗎？
答：更新可能會重新啟用部分套件。執行 check.py 查看變動內容，並加上 --fix 重新套用你的清單。

問：可以不用電腦完成嗎？
答：可以，社群開發的 Android 應用程式能直接從手機執行相同的清理作業。

問：完成後應該保持 ADB 開啟嗎？
答：不應該。網路 ADB 在 5555 連接埠上未經加密；完成後請將其關閉，並使用 adb-closed.py 驗證。

11. 快速連結

12. 總結

CleanYourTV 讓電視擁有者能以安全、可逆的方式移除臃腫軟體、廣告與遙測資料，並安裝快速乾淨的啟動器，全程透過 Wi-Fi 完成且無需 root。無論你是想要更快、更安靜主畫面的 Android TV 或 Google TV 使用者，還是希望從精簡且文件齊全的程式碼中學習或擴充功能的開發者與資安工程師，這款工具都非常適合。