CleanFrame README

项目的 README,来自 github.com/nthnclrk/CleanFrame。合并为一个 markdown 文件:README.md。

CleanFrame

A quieter home screen for Samsung The Frame. Your apps, a photograph and the time, with an interface made for the TV remote.

CleanFrame browser preview using the bundled Manrope font

I built CleanFrame for one TV: my own Samsung The Frame, running Tizen. I'm sharing the code and setup notes as a starting point for other people to build on.

Use it at your own risk. The web launcher targets Tizen 5.0 and later for installation, with owner reports across several models. That minimum is not a promise that every device flow is verified. The TV setup scripts and native Home helpers still reflect specific computers and firmware, so adapt them and test on your own hardware.

I highly recommend forking it and building on top of it, ideally with a coding agent that can help you understand and adapt the setup. Start with the browser preview, make the interface your own, then work through TV installation when you're ready. Native Home/startup changes need particular care; the setup guide covers the risks and recovery steps.

Try the interface

You need Node.js 22.13+ (22 LTS), or 24+, and Python 3.10+ to run the browser preview.

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

Open localhost:4795/home/. Use the arrow keys, Enter and Escape, or click the controls. App launches and Samsung screens require a TV; the preview reports that limitation when you select them.

The public preview uses the included Manrope, Geist and Newsreader fonts.

What you can change

The glass and blur are rendered ahead of time. The TV loads the finished images and uses transforms and opacity for focus feedback.

Use a coding agent

Open this repo in a local coding agent and give it a bounded change:

Read AGENTS.md, docs/development.md and docs/interaction-behaviour.md.
Help me adapt CleanFrame. Start with the public-font browser preview.
My first change is: <describe one change>.
Preserve remote navigation, saved preferences and the ES5 runtime.
Run the source checks and relevant browser checks. Show the result.
This task is browser-only: do not connect to a TV, sign or install a
package, or change Home/startup settings.

See working with an agent for the TV setup prompt and the distinction between UI work, app installation and native Home changes. An agent needs local computer access for TV work; a hosted chat cannot reach your TV merely by reading this repo.

Put it on a TV

Use the staged Samsung The Frame setup guide to understand the process used on my TV and adapt it to yours. It covers the remote's Developer Mode sequence, official Samsung tools, your own certificates and app identity, installation, visible checks and recovery.

The latest release includes an unsigned, public-font widget for inspection and adaptation. For your installation, build from source using your own identity in .local/signing.json and sign with your own certificates. The download is not a ready-to-install signed package.

Signing supports an ignored .local/signing.json based on signing.example.json: select your SDK, existing certificate profile and your own SDK-generated app identity. See local signing setup. The TV installation commands and native Home helper still contain reference-machine assumptions. Your agent must check the installed-app IDs and each device stage with you. Installing the app and assigning the remote Home button are separate steps.

Area Evidence and limits
Reference hardware Samsung QA55LS03DAWXXY / LS03D, firmware 2130.0, Tizen 9.0, 32-bit ARM
App installation Signed installation and launch commands succeeded through 0.6.1. Latest rendering and remote feel still need physical observation.
App launch and Home Netflix/YouTube launch and physical Home from Netflix were confirmed on the reference setup.
Still open Normal power-on after streaming/Art Mode, corrected Smart Hub escape and native Art Mode destinations need definite physical checks.
Other TVs Web installation target: Tizen 5.0+. See the attributed device reports for tested flows and omissions. Android TV, Google TV, LG webOS and Roku need separate implementations.

The optional 2020 LS03T profile supplies experimental owner-configured native source. It leaves the reference helper unchanged and is not an unattended installer.

The detailed device record separates observed results from SDK responses. Native Home/startup uses undocumented, guarded helpers; it is optional and can fail after firmware changes. Keep a recovery baseline before attempting that work. The app can be opened manually without it.

Develop and check

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

npm run check, including its check:device command, runs only source checks and synthetic device-adapter tests. It never connects to a TV. The browser checks use isolated Chromium profiles and a loopback preview. They never contact a TV. The public export creates dist/CleanFrame-public-unsigned.wgt, with public fonts and notices. It needs your own identity and signing before installation. It does not certify asset redistribution rights or device compatibility.

Location Purpose
app/ Current packaged UI and runtime assets
scripts/ Preview, validation, asset generation and reference TV tools
Development / testing Runtime map, preferences, checks and device boundaries
Assets / third-party notices Rendering recipes, font separation and asset provenance
Asset sources Photo credits and verification of the bundled third-party assets
.local/, dist/ Ignored private setup, recovery data, generated files and packages

Contribute

Fork it, experiment and build something that suits your TV. If you find a useful fix or improve the setup instructions, contributions are welcome. Read CONTRIBUTING.md before a larger change. Reports should include model, firmware and the observed result, with private identifiers removed.

Licence and credits

CleanFrame's original code and documentation use the MIT licence. Fonts, photographs and logos retain their own terms; read THIRD_PARTY_NOTICES.md. Paid Pangram binaries are excluded from Git and public exports. A local package may include them, so keep personal builds separate from public downloads.

The release review records the publication checks. Third-party assets retain the terms listed in their notices. CleanFrame is an independent project with no Samsung or streaming-service affiliation.

TV Detox is a useful example of making an agent-assisted TV project approachable. Its Android setup is a different implementation; the prompts and instructions here are written for CleanFrame and Tizen.

CleanFrame (nthnclrk/CleanFrame)

正在搜索数据库…

这是什么?CleanFrame 是三星 The Frame 电视(运行 Tizen 系统)的个人主屏幕替代方案,会显示已安装的应用、一张照片和时间。它适合 fork 之后按自己的电视进行修改。
这是一个成品应用,还是需要我自己改造的起点?这是一个作为起点分享的个人项目,包含一个 Tizen 应用和安装脚本,都是围绕作者自己的电视、固件和电脑编写的。它适合 fork 后自行定制,而不是可以直接安装使用的通用成品。
在动我的电视之前,怎么先试一下?用 Node.js 22+ 和 Python 3.10+ 在本地运行浏览器预览,然后打开 localhost:4795/home/,用方向键、Enter 和 Escape 键操作界面,确认没问题后再进行电视安装。
要真正装到电视上,还需要准备什么?除了预览所需的 Node.js 22+ 和 Python 3.10+,把它装到电视上还需要通过遥控器开启开发者模式、使用三星官方的开发者工具,以及你自己的签名证书和应用标识。
这个能在任何智能电视上用吗?不能。它只针对作者自己的三星 The Frame 型号和固件进行了构建和测试,不保证适用于其他电视。Android TV、Google TV、LG webOS 和 Roku 各自都需要单独的实现。
这个项目实际适合哪些人?适合拥有三星 The Frame 电视、能够 fork 代码、愿意根据自己的硬件调整安装脚本的人,最好还能借助编程智能体完成电视安装步骤。
只看 MIT 许可证就够了吗?CleanFrame 的代码和文档采用 MIT 许可证,但捆绑的字体、照片和徽标各自有独立的条款。付费的 Pangram 字体文件不包含在公开仓库和导出内容中。
在界面上我实际能自定义哪些内容?你可以选择 List 或 Dock 布局,选用照片或浅色/深色背景并设置 12 小时制时钟,调整字体排版、焦点和玻璃材质效果,重新排列主页应用,还可以从十五张内置壁纸中选择。
编程智能体能不能替我把它装到电视上,我什么都不用做?不能。电视相关的操作需要智能体能访问你电脑上的本地环境,因为仅靠读取代码仓库,托管的聊天工具无法连接到你的电视。智能体可以帮你调整签名脚本,并与你一起逐个阶段核对安装结果。
替换电视原生的主页按钮有风险吗?有。修改原生主页或开机启动依赖未公开记录、带保护机制的 Tizen 辅助功能,而且这些改动是可选的。固件更新后可能失效,因此设置指南建议先备份一个可恢复的基线。
其他电视平台有类似的东西吗?TV Detox 是一个类似的、由智能体辅助的项目,但它面向 Android TV,是另一套不同的实现。CleanFrame 本身仅支持 Tizen。
作者
nthnclrk
大小
21.1 MB
星标
1.1K
时长
29天
提交 · 90 天