CleanFrame: サムスン『ザ・フレーム』向け静かなホームスクリーンプロジェクト

サムスン『ザ・フレーム』専用の静かなホームスクリーンを実現するプロジェクトです。アプリ、写真、時刻が表示され、テレビリモコンに合わせて設計されたインターフェースを搭載しています。

プロジェクト概要

• ターゲット: 1 台のテレビ（Samsung The Frame / Tizen OS）のみを対象として開発されています。
• 目的:
  • 本コードとセットアップノートを公開し、他者がその基盤上でさらに開発するための出発点を提供します。
  • 利用はご自身の責任において行ってください。
• 開発方針:
  • 開発の大部分は、特定のテレビで良好な動作を確保することに注力しており、ポータビリティへの取り組みは限られています。
  • セットアップスクリプトには、作成者のコンピュータ、テレビ、ファームウェア固有の内容が含まれているため、ご自身のハードウェア環境に合わせて適応させ、結果を検証していただく必要があります。
• 推奨アプローチ:
  • コードをフォークし、その上でさらに開発することを強く推奨します。
  • 可能であれば、コードを記述するAI エージェントを活用し、セットアップの理解や適応を手助けしてもらうのが理想的です。
  • ブラウザでのプレビューから始め、インターフェースをカスタマイズした後にテレビへのインストールへ進めるよう推奨します。
  • ホーム画面や起動時の変更は特に注意が必要です。詳細なリスクと復旧手順はセットアップガイドをご参照ください。

インターフェースを試す（ブラウザプレビュー）

ブラウザ上で動作を確認し、インターフェースをカスタマイズしてからテレビへ導入してください。

環境要件

• Node.js 22 以上
• Python 3.10 以上

起動手順

以下のコマンドを実行して開発サーバーを起動します。

git clone https://github.com/nthnclrk/CleanFrame.git
cd CleanFrame
npm ci
npm run dev:public

ブラウザで

localhost:4795/home/

• 操作方法: 矢印キー、Enter キー、Esc キー、またはクリック操作で制御が可能です。
• 注意事項: アプリの起動やサムスンの画面表示には実際のテレビが必要ですが、プレビューではその制限を提示するようになっています。
• フォント: プレビュー版では、同梱されている Manrope、Geist、Newsreader のフォントを使用しています。

変更可能な項目

以下の設定を調整できます：

• レイアウト: リスト型またはドック型を選択。アイコン名を併用するか单独表示を設定可能。
• 視覚効果: 写真やライト/ダークな背景を使い分け、シンプルな 12 時間制の時計を設定可能。
• スタイリング: タイポグラフィ、フォーカス効果、ガラス素材感を統一された設定インターフェースから調整できます。
• アプリ管理: ホームアプリを選択・並べ替えたり、テレビ上でインストール可能なアプリを発見したりします。
• 壁紙: 15 の壁紙パターンのうちから選択し、好みの設定をローカルに保存できます。
  • 玻璃の質感とぼかし効果は事前にレンダリングされ、テレビでは完成された画像を読み込み、変換と透過度調整によりフォーカスフィードバックを実現しています。

コーディングエージェントを利用する

このリポジトリをローカルなコーディングエージェントで開き、以下の限定されたタスクを与えてください。

エージェントへの指示事項

1. ドキュメントの読み込み:

   • AGENTS.md

   • docs/development.md

   • docs/interaction-behaviour.md

2. 適応の支援:
   • まず公開フォントを使用するブラウザプレビューから始めます。
3. 変更内容の指定:
   • 最初の変更内容は、

     <ここに 1 つの変更内容を記述>

     のように明示的に指示します。
4. 維持すべき機能:
   • リモートナビゲーション、保存された設定、ES5 ランタイムを維持します。
5. 検証:
   • ソースチェックおよび関連するブラウザチェックを実行し、結果を表示させます。

⚠️ 重要な注意点（エージェント利用時）

• このタスクはブラウザ限定です。
• テレビとの接続、署名処理、パッケージのインストール、ホーム画面/起動設定の変更は行わないでください。
• テレビ用セットアッププロンプト、UI 作業、アプリインストール、ネイティブホーム変更の違いについては「エージェントとの連携」をご参照ください。
• テレビへの作業を行うにはローカルコンピューターへのアクセスが必要です。ホストされたチャット環境が単にこのリポジトリを読み取るだけではあなたのテレビに到達することはできません。

テレビに導入する

段階的なサムスン『ザ・フレーム』向けセットアップガイドを使用して、以下の手順を理解し、ご自身のご環境に合わせて適応してください。

• リモコンのデベロッパーモード手順
• 公式サムスンのツール、独自証明書およびアプリアイデンティティの活用
• アプリのインストール
• 可視化されたチェックポイントの確認
• 復旧方法の準備

注意点

• 署名処理とテレビ用スクリプトは、作成者の設定に固有の内容です。
• エージェントにはパス、署名プロファイル、アイデンティティチェック、インストール済みアプリの ID などを適応させ、各段階について共同で検証していただく必要があります。
• アプリのインストールとリモコンのホームボタン割り当ては別々の手順で行います。

実証データと制限事項

• 詳細な機器記録には、観察された結果と SDK から得たレスポンスが分けて記載されています。
• ネイティブホーム/起動機能には未公開かつ守られるべきヘルパー関数を使用しており、オプションでありファームウェア変更後に失敗する可能性があります。その作業を試みる前に、復旧のためのベースラインを維持してください。
• このヘルパーなしでもアプリを手動で開くことは可能です。

開発とチェック

以下のコマンドを実行して環境を確認・テストします。

npm run check
npx playwright install chromium
CLEANFRAME_PUBLIC_FONTS=1 npm run check:browser
npm run check:public
npm run export:public

エクスポートについて

• ブラウザチェックには孤立した Chromium プロフィールとループバックプレビューを使用しており、決してテレビとは通信しません。
• 公開エクスポートでは

  dist/CleanFrame-public-unsigned.wgt

  を作成し、公開フォントと注意事項を同梱します。
• インストール前にはご自身のアイデンティティと署名処理が必要です。
• このエクスポートはアセットの再配布権や機器互換性を保証するものではありません。

プロジェクト構造

app/

scripts/

.local/

dist/

貢献について

• フォークして試行錯誤し、ご自身のテレビに適したものを作り上げてください。
• 有用な修正を見つけたり、セットアップ説明書を改善したりしたら、貢献を歓迎します。
• 大規模な変更を行う前に

  CONTRIBUTING.md

  をお読みください。
• 報告にはモデル、ファームウェア、観察された結果を含め、個人識別情報を削除してください。

ライセンスとクレジット

• CleanFrame のオリジナルコードおよびドキュメントは MIT ライセンスを採用しています。
• フォント、写真、ロゴについては各自の条件を維持しており、

  THIRD_PARTY_NOTICES.md

  をご参照ください。
• 有償の Pangram バイナリは Git および公開エクスポートから除外されています。ローカルパッケージにはこれらが含まれる可能性があるため、個人ビルドと公開ダウンロードは区別してください。
• リリースレビューには出版時のチェック記録が含まれています。サードパーティアセットについては、各自の通知に記載された条件を維持します。
• CleanFrame は独立したプロジェクトであり、サムスンやストリーミングサービスとの関係は一切ありません。

TV Detox は、エージェント支援によるテレビプロジェクトを身近にするための優れた例です。その Android 向けセットアップは異なる実装ですが、こちらのプロンプトおよび指示書は CleanFrame および Tizen 用に作成されています。