nthnclrk/ClearFrame: A private residence display screen for Samsung The Frame. A place to begin to fork and adapt. · GitHub
A quieter residence display screen for Samsung The Frame. Your apps, {a photograph} and the time, with an interface made for the TV distant.
I constructed ClearFrame for one TV: my very own Samsung The Frame, operating Tizen. I’m sharing the code and setup notes as a place to begin for different individuals to construct on.
Use it at your individual danger. Most of the work has gone into making it work properly on my TV. Very little has gone into making it transportable. The setup scripts mirror my pc, TV and firmware, so count on to adapt them and take a look at the end result by yourself {hardware}.
I extremely suggest forking it and constructing on high of it, ideally with a coding agent that may assist you to perceive and adapt the setup. Start with the browser preview, make the interface your individual, then work by way of TV set up once you’re prepared. Native Home/startup modifications want explicit care; the setup information covers the dangers and restoration steps.
You want Node.js 22+ and Python 3.10+ to run the browser preview.
git clone https://github.com/nthnclrk/CleanFrame.git
cd ClearFrame
npm ci
npm run dev:public
Open localhost:4795/home/. Use the arrow keys, Enter and Escape, or click on the controls. App launches and Samsung screens require a TV; the preview experiences that limitation when you choose them.
The public preview makes use of the included Manrope, Geist and Newsreader fonts.
- Choose a List or Dock format, with icons, names or each.
- Use {a photograph}, gentle or darkish background, with a easy 12-hour clock.
- Adjust typography, focus and glass supplies by way of the identical Settings interface.
- Choose and reorder Home apps; uncover put in apps on the TV.
- Select from fifteen wallpapers and save your preferences regionally.
The glass and blur are rendered forward of time. The TV hundreds the completed pictures and makes use of transforms and opacity for focus suggestions.
Open this repo in an area coding agent and provides it a bounded change:
Read AGENTS.md, docs/growth.md and docs/interaction-behaviour.md.
Help me adapt ClearFrame. Start with the public-font browser preview.
My first change is: .
Preserve distant navigation, saved preferences and the ES5 runtime.
Run the supply checks and related browser checks. Show the end result.
This process is browser-only: don't connect with a TV, signal or set up a
bundle, or change Home/startup settings.
See working with an agent for the TV setup immediate and the excellence between UI work, app set up and native Home modifications. An agent wants native pc entry for TV work; a hosted chat can not attain your TV merely by studying this repo.
Use the staged Samsung The Frame setup guide to grasp the method used on my TV and adapt it to yours. It covers the distant’s Developer Mode sequence, official Samsung instruments, your individual certificates and app id, set up, seen checks and restoration.
The signing and TV scripts are particular to my setup. Your agent might want to adapt the paths, signing profile, id checks and installed-app IDs, then confirm every stage with you. Installing the app and assigning the distant Home button are separate steps.
| Area | Evidence and limits |
|---|---|
| Reference {hardware} | Samsung QA55LS03DAWXXY / LS03D, firmware 2130.0, Tizen 9.0, 32-bit ARM |
| App set up | Signed set up and launch instructions succeeded by way of 0.6.1. Latest rendering and distant really feel nonetheless want bodily commentary. |
| App launch and Home | Netflix/YouTube launch and bodily Home from Netflix have been confirmed on the reference setup. |
| Still open | Normal power-on after streaming/Art Mode, corrected Smart Hub escape and native Art Mode locations want particular bodily checks. |
| Other TVs | No compatibility declare. This is Tizen supply; Android TV, Google TV, LG webOS and Roku want their very own implementations. |
The detailed device record separates noticed outcomes from SDK responses. Native Home/startup makes use of undocumented, guarded helpers; it’s non-obligatory and may fail after firmware modifications. Keep a restoration baseline earlier than making an attempt that work. The app will be opened manually with out it.
npm run examine
npx playwright set up chromium
CLEANFRAME_PUBLIC_FONTS=1 npm run examine:browser
npm run examine:public
npm run export:public
The browser checks use remoted Chromium profiles and a loopback preview. They by no means contact a TV. The public export creates dist/ClearFrame-public-unsigned.wgt, with public fonts and notices. It wants your individual id and signing earlier than set up. It doesn’t certify asset redistribution rights or machine compatibility.
| Location | Purpose |
|---|---|
app/ |
Current packaged UI and runtime property |
scripts/ |
Preview, validation, asset technology and reference TV instruments |
| Development / testing | Runtime map, preferences, checks and machine boundaries |
| Assets / third-party notices | Rendering recipes, font separation and asset provenance |
| Asset sources | Photo credit and verification of the bundled third-party property |
.native/, dist/ |
Ignored personal setup, restoration information, generated information and packages |
Fork it, experiment and construct one thing that fits your TV. If you discover a helpful repair or enhance the setup directions, contributions are welcome. Read CONTRIBUTING.md earlier than a bigger change. Reports ought to embody mannequin, firmware and the noticed end result, with personal identifiers eliminated.
ClearFrame’s unique code and documentation use the MIT licence. Fonts, pictures and logos retain their very own phrases; learn THIRD_PARTY_NOTICES.md. Paid Pangram binaries are excluded from Git and public exports. An area bundle might embody them, so hold private builds separate from public downloads.
The release review data the publication checks. Third-party property retain the phrases listed of their notices. ClearFrame is an impartial undertaking with no Samsung or streaming-service affiliation.
TV Detox is a helpful instance of constructing an agent-assisted TV undertaking approachable. Its Android setup is a distinct implementation; the prompts and directions listed below are written for ClearFrame and Tizen.
