Clean Your TV（cleanyourtv）：AI コーディングエージェントで Android/Google TV の広告とブロートウェアを除去
Clean Your TV とは？コーディングエージェントが Wi-Fi 経由で Android/Google TV の広告サービスとプリインストールアプリを無効化し、Apple TV 風のホーム画面に入れ替えるオープンソースプロジェクト。導入手順、対応テレビ、復元方法を解説。
最終更新: 2026-10-31
Clean Your TV とは？
Clean Your TV（Gathin23/cleanyourtv）は、GitHub トレンド週間チャートで 1 位を獲得した（2026-10-19〜25、trendshift 調べ）オープンソースプロジェクトです。答えているのは、Android TV / Google TV ユーザーなら誰もが一度は抱く疑問——自分のテレビが、なぜ自分に広告を見せるのか？
このプロジェクトは 2 つのことをします。1 つ目はテレビのダイエット：Wi-Fi 経由でメーカーのテレメトリ、広告サービス、スポンサー付きコンテンツ行、プリインストールアプリを無効化します。2 つ目は、広告まみれのホーム画面を、約 572 KB の小型ネイティブランチャーに置き換えること。見た目も操作感も Apple TV のようで、純黒の背景にお気に入りアプリ 4 つの dock、バックグラウンドで何かを送信する挙動もありません。
TechCrunch、TechRadar、Tom's Guide、Mashable、Android Authority、XDA など 54 か国の 412 本の記事で取り上げられ、コミュニティは 103 ブランド・387 機種の動作報告リストを蓄積しています。
始める前に一つだけ注意：公式サイトは cleanyour.tv、公式リポジトリは上記の GitHub リンクです。cleanyourtv.com 類似ドメインはこのプロジェクトのものではありません。
仕組み
Android TV には Android スマホと同じデバッグブリッジが用意されています。テレビの開発者向けオプションで USB デバッグを有効にし、パソコンを 1 回許可すれば、あとは標準の Android ツールチェーンで完結します。root 不要、ケーブル不要です。
| ステップ | 内容 |
|---|---|
| バックアップ | 何かを変える前に、インストール済みパッケージと設定を記録。 |
| 無効化 | Android の pm disable-user でテレメトリ・広告サービス・コンテンツ行・プリインストールアプリを無効化。アンインストールではないので、復元スクリプトで一歩ずつ取り消せます。 |
| インストール | 小型ネイティブランチャーをインストールし、ホームとして既定に設定。 |
メーカーごとにブロートウェアの内容は違うため、同梱のプロンプトは coding agent に実際のテレビ上で調査させ、まだ使うかもしれないものに触る前には確認を求めます。
インストールと実行
テレビと同じ Wi-Fi につながったパソコンに、Python 3、JDK 17〜22、Android SDK platform 34 + build-tools 34（ランチャーのビルドに使用）を用意します。所要時間は 15 分ほど。
使えるのは Claude Code、Codex、Gemini CLI、Antigravity CLI などのコーディングアシスタント。ここが DeepSeek Harness との接点でもあります。リポジトリのプロンプトを読めてシェルコマンドを実行できる agent CLI なら、どれでもこの流れを完走できます。
- テレビ側：設定 → デバイス設定 → 端末情報 →「ビルド」を 7 回押す → 戻る → 開発者向けオプション →「USB デバッグ」をオン。ネットワークデバッグ / ADB デバッグのトグルがあれば一緒にオン。テレビはつけたままに。
- パソコン側：
git clone https://github.com/Gathin23/cleanyourtvして、そのフォルダをアシスタントで開き、リポジトリのPROMPT.mdを貼ってテレビの型番を記入。 - 沿って進める：テレビで「USB デバッグを許可しますか？」を承認し、チェックリストに答えます。よく使うアプリ、dock のサイズと並び順、音声アシスタント / Chromecast / システムアップデートを残すかどうか。
リポジトリの clone が重要です。agent が再利用するのはリポジトリ同梱の tools/disable.sh と launcher/build-and-install.sh で、バックアップ・ホームガード・復元記録はすべてこの中にあります。
コーディングアシスタントがない場合：リポジトリは手動コマンド（tools/tv.py、tools/disable.sh、tools/restore.sh）も同梱しています。さらに第三の道として、コミュニティ製のスマホアプリ（cleanyour.tv/app）なら Android スマホから接続 → 分析 → クリーンが約 5 分で完了し、パソコンも agent も不要です。
対応テレビ
| プラットフォーム | 対応状況 |
|---|---|
| Android TV / Google TV | フル対応：ダイエット + ランチャー。 |
| Amazon Fire TV | ダイエットのみ——Fire OS はサードパーティランチャーをホームにできないため（2015 年の Fire TV Box はそれも失敗）。 |
| Samsung（Tizen）・LG（webOS）・Roku・Vizio・Hisense VIDAA | 非対応——ADB がないため。公式サイトにトラッキングオフのガイドがあります。 |
安全性
意図的に「元に戻せる」設計になっています。
- 何もアンインストールしません。 パッケージは
pm disable-userで無効化するだけ。変更前にテレビの状態を~/.cleanyourtv/に記録します。 - ワンライン復元：
TV_HOST=<テレビのIP> tools/restore.sh examples/<機種>/debloat.txtで純正ホームに戻せます。 - スクリプトはテレビをホームアプリなしの状態にしません——認識できる純正ランチャーだけを無効化し、別のランチャーが HOME を握るまでリスト内のホームアプリはスキップします。
- ファームウェア更新後は
tools/check.pyがテレビと適用リストを比較し、--fixで元に戻された無効化をやり直せます。
FAQ
Clean Your TV は Google TV でも使えますか？
使えます。Google TV の実体は Android TV で、ダイエットもランチャーもフル対応。Google TV の復元時は純正ランチャーのパッケージ名（com.google.android.apps.tv.launcherx）を追加で渡します。
Claude Code が必須ですか？ いいえ。README には Claude Code、Codex、Gemini CLI、Antigravity CLI が選択肢として明記されています。実体は標準 ADB ツールの上に成り立つプロンプト駆動ワークフローなので、能力のある coding agent CLI なら何でも動きます。DeepSeek Harness の agent がシェル自動化を走らせるのと同じ理屈です。
root 化や保証への影響は？ root なし、ケーブルなし、アンインストールなし。Android スマホと同じ開発者モードのデバッグブリッジを使うだけで、変更はすべて復元スクリプトで取り消せます。
コマンドラインを使いたくないのですが、アプリはありますか？ あります。コミュニティ製の Android アプリ（cleanyour.tv/app）ならスマホから約 5 分でクリーンまで完了し、パソコンも coding agent も不要です。
Samsung / LG / Roku テレビでも使えますか？ 直接は無理です。これらのプラットフォームは ADB を公開していません。プロジェクトは代わりに、プラットフォーム別のトラッキングオフ手順（cleanyour.tv/not-android）を案内しています。
関連する DeepSeek Harness プラグイン
「agent に実作業を任せる」発想が気に入ったなら、DeepSeek Harness エコシステムにも同系統のネイティブプラグインがあります。
- デスクトップ & アプリ系プラグイン——DSH agent 駆動のデスクトップ自動化・画面操作・システムツール。
- ユーティリティ——ArtCraft クリエイティブスイートのブリッジやナレッジグラフツールなど。
- エージェント・自動化ワークフロー——定期実行ジョブと複数ステップの agent ワークフロー。