CleanFrame: Samsung The Frameのためのより静かなホームスクリーン

CleanFrame

Samsung The Frameのための、より静かなホームスクリーン。あなたのアプリ、写真、そして時間。テレビのリモコンのために作られたインターフェースです。

［画像: CleanFrameブラウザプレビュー（バンドルされているManropeフォントを使用）］

CleanFrameは、私自身のSamsung The Frame TV（Tizen搭載）のために開発しました。コードとセットアップノートを、他の人がそれを基盤として構築するための出発点として共有します。

ご自身の責任において使用してください。 ほとんどの作業は、私のテレビでうまく動作するように行われました。移植性を高めるための作業はごくわずかです。セットアップスクリプトは私のコンピューター、テレビ、ファームウェアを反映しているため、それらを適応させ、ご自身のハードウェアで結果をテストする必要があります。

フォークして、それを基盤に構築することを強くお勧めします。理想的には、コーディングエージェントを使用して、セットアップを理解し適応させるのに役立ててください。まずブラウザプレビューから始め、インターフェースを自分好みにし、準備ができたらテレビへのインストールに進んでください。ネイティブのホーム/起動時の変更には特別な注意が必要です。セットアップガイドにはリスクと復旧手順が記載されています。

インターフェースを試す

ブラウザプレビューを実行するには、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、Escapeキーを使用するか、コントロールをクリックしてください。アプリの起動とSamsungの画面にはテレビが必要ですが、プレビューではそれらが選択されたときにその制限が報告されます。

パブリックプレビューでは、付属のManrope、Geist、Newsreaderフォントを使用しています。

変更可能な項目

• アイコン、名前、またはその両方を含む、リストまたはドックレイアウトを選択できます。
• 写真、ライト、またはダークの背景と、シンプルな12時間時計を使用できます。
• 同じ設定インターフェースを通じて、タイポグラフィ、フォーカス、ガラス素材を調整できます。
• ホームアプリを選択して並べ替え、テレビにインストールされているアプリを発見できます。
• 15種類の壁紙から選択し、設定をローカルに保存できます。

ガラスとぼかしは事前にレンダリングされます。テレビは完成した画像を読み込み、フォーカスフィードバックのためにトランスフォームと不透明度を使用します。

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

このリポジトリをローカルのコーディングエージェントで開き、範囲を限定した変更を指示してください。

AGENTS.md、docs/development.md、docs/interaction-behaviour.md を読み込んでください。
CleanFrame の適応を手伝ってください。まずパブリックフォントのブラウザプレビューから始めます。
私の最初の変更は次のとおりです：<変更内容を記述してください>。
リモートナビゲーション、保存された設定、ES5ランタイムを維持してください。
ソースチェックと関連するブラウザチェックを実行してください。結果を表示してください。
このタスクはブラウザのみです：テレビに接続したり、署名したり、パッケージをインストールしたり、ホーム/起動設定を変更したりしないでください。

テレビのセットアッププロンプトと、UI作業、アプリのインストール、ネイティブホーム変更の違いについては、エージェントとの作業を参照してください。エージェントはテレビ作業のためにローカルコンピューターへのアクセスが必要ですが、ホストされたチャットではこのリポジトリを読むだけではテレビに到達できません。

テレビにインストールする

ステージングされたSamsung The Frame セットアップガイドを使用して、私のテレビで行われたプロセスを理解し、ご自身のものに適応させてください。リモコンの開発者モードシーケンス、公式Samsungツール、ご自身の証明書とアプリID、インストール、目に見えるチェック、および復旧手順が含まれています。

署名およびテレビ用スクリプトは、私のセットアップに固有のものです。エージェントは、パス、署名プロファイル、IDチェック、およびインストール済みアプリ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を作成します。インストールには、独自のIDと署名が必要です。アセットの再配布権またはデバイスの互換性を証明するものではありません。

貢献

フォークして、実験し、あなたのテレビに合ったものを作成してください。有用な修正を見つけたり、セットアップ手順を改善したりした場合は、貢献を歓迎します。大きな変更を行う前にCONTRIBUTING.mdをお読みください。レポートには、モデル、ファームウェア、および観察された結果を含めてください。プライベート識別子は削除してください。

ライセンスとクレジット

CleanFrameの元のコードとドキュメントはMITライセンスを使用しています。フォント、写真、ロゴはそれぞれの条件を保持しています。 THIRD_PARTY_NOTICES.mdをお読みください。有料のPangramバイナリはGitおよびパブリックエクスポートから除外されています。ローカルパッケージにはそれらを含めることができますので、個人ビルドはパブリックダウンロードとは別に保管してください。

リリースレビューは、公開チェックを記録しています。サードパーティアセットは、その通知に記載されている条件を保持します。CleanFrameは、Samsungまたはストリーミングサービスとは無関係の独立したプロジェクトです。

TV Detoxは、エージェント支援型テレビプロジェクトをわかりやすくするための有用な例です。そのAndroidセットアップは異なるインプリメンテーションですが、ここでのプロンプトと指示はCleanFrameとTizen向けに書かれています。

---