CleanYourTV セットアップガイド
Android TV または Google TV のホーム画面をすっきりさせるための出発点です。
CleanYourTV は Gathin23 によるオープンソースプロジェクトです。このサイトは、その手順を説明する独立した無料ガイドです。ソースパッケージには、プロジェクトの README、プロンプト、デバイス例、テーマ、トラブルシューティングのメモ、安全に関するメモが含まれています。
お使いのテレビを正確に確認する
展開したソースパッケージの examples/ にあるデバイスレポートで、モデル、地域、ファームウェアを確認してください。対応する出発点は Android TV と Google TV です。インストールプロンプトは Fire TV、Samsung Tizen、LG webOS には対応していません。
テレビを準備する
テレビとパソコンを同じローカルネットワークに接続します。「設定」を開き、「デバイス情報」などから Build の項目を7回押して開発者向けオプションを有効にします。利用できる場合は USB デバッグとネットワーク/ADB デバッグを有効にしてください。デバッグ要求は、自分が信頼するパソコンからのものだけを許可します。
テレビのネットワークまたは Wi-Fi 設定で IPv4 アドレスを確認し、アシスタントに伝えます。このサイトのセットアップフォームは、そのアドレスを開始プロンプトに含められますが、ネットワークをスキャンしたり接続したりすることはありません。
一部の Google TV では、ワイヤレスデバッグにペアリングコードと別の接続ポートを使います。通常の接続ができない場合は、ポート5555が常に開いていると決めつけず、インストールプロンプトのペアリング手順に従ってください。接続のトラブルシューティングで確認事項を説明しています。
現在のプロジェクト手順に従う
インストールプロンプトを開き、全文をターミナルにアクセスできるコーディングアシスタントにコピーして、テレビの正確なモデルを伝えます。確認ポイントごとに進めるよう依頼してください。プロジェクトは無料ですが、コーディングアシスタントの利用料金が別にかかる場合があります。
変更する前に、パッケージ一覧、無効にしたパッケージの状態、設定、デバイス情報を保存します。残したいストリーミングアプリ、音声アシスタント、キャストサービス、アップデートを確認してください。不明なパッケージや、入力・リモコン・音声・キーボード・Play サービスに必要なものを無効にしないでください。
ランチャーはソースからビルドします。ソースコードの完全な ZIPをダウンロードして展開してください。プロジェクトフォルダー全体を残します。ビルドスクリプトは tools/ と launcher/ のファイルも必要とします。
Python 3、JDK 17、Android SDK Platform 34、Android Build Tools 34.0.0 を準備します。展開した README.md に手動セットアップの詳細があります。対応する Windows ビルドスクリプトまたは macOS/Linux ビルドスクリプトをダウンロードし、展開した launcher/ ディレクトリに置いて、そこから実行してください。これらはソースをビルドするスクリプトであり、完成済み APK のダウンロードではありません。
新しいランチャーを Home にする前に、置き換え先が正常に開くまで元のランチャーを有効にしておきます。コマンドの成功メッセージだけに頼らず、テレビの Home ボタンで確認してください。
ファームウェアによっては、サイドロードしたアプリやサードパーティ製 Home ランチャーがブロックされます。確認またはメーカー署名の制限でインストールが拒否された場合は、ランチャーのインストールを中止し、正確なモデルのメモを確認してください。インストールを繰り返しても互換性は証明できません。
確認して完了する
Home、リモコンのショートカットボタンと設定ボタン、HDMI 入力、音声、キャストを確認します。デバッグを無効にし、認証を取り消して再起動します。その後、ダウンロードできる ADB クローズ確認ツールで ADB ポートが接続を拒否することを確認してください。タイムアウトやルーティングエラーは、接続拒否の確認とは異なります。
ランチャーを自分用にする
基本セットアップが動作したら、ランチャーの設定でアプリの行を並べ、アニメーションを残すか決めます。展開した themes/README.md に背景、色、ドックの変更方法があります。テーマを適用する前に説明を確認し、適用後にリモコンと Home ボタンをもう一度確認してください。
復元またはトラブルシューティング
元のパッケージ一覧と状態記録をパソコンに保存しておきます。対応する Windows 復元スクリプトまたは macOS/Linux 復元スクリプトをダウンロードし、展開した tools/ ディレクトリに置いて、実際に適用したものと同じ一覧で使います。これらのスクリプトは記録された状態を復元するもので、完全なシステムイメージではありません。モデル固有の問題や安全に関する案内は、展開したソースパッケージ内の docs/TROUBLESHOOTING.md と SECURITY.md を読んでください。