Repolode
Submit
nthnclrk

nthnclrk/CleanFrame

A personal home screen for Samsung The Frame TVs running Tizen, with apps, a photo background and a remote-friendly interface you can fork and adapt.

View on GitHub
Stars
264
Forks
30
Open issues
2
Last commit
2 days ago

What is it?

CleanFrame is a quieter home screen for Samsung The Frame TV. It shows your chosen apps, a photograph and the time, and is designed to be navigated with the TV remote. The project is a Tizen app built with an ES5 runtime, and the author shares it as a starting point rather than a polished, portable product.

The interface offers a List or Dock layout, a light or dark background, and a 12-hour clock. Users can choose and reorder Home apps, discover installed apps on the TV, pick from fifteen wallpapers, and adjust typography, focus and glass styling in a Settings screen. Preferences are saved locally. Glass and blur effects are pre-rendered so the TV only loads finished images and uses transforms and opacity for focus feedback.

You can try the interface in a browser with Node.js 22+ and Python 3.10+ before touching any hardware. Installing on a TV requires your own certificates, signing profile and app identity, and the setup scripts are tailored to the author's computer and TV, so adaptation and testing are expected. Native Home/startup changes rely on undocumented helpers and carry risk.

Key features

  • 01Switchable List or Dock layouts with icons, names or both.
  • 02Photo or solid light and dark backgrounds with a simple 12-hour clock.
  • 03Choose, reorder and discover Home apps on the TV.
  • 04Fifteen bundled wallpapers and locally saved preferences.
  • 05Browser preview for developing the interface without a TV.

Use cases

  • Turning a Samsung The Frame into a personal, photo-led home screen.
  • Forking the project as a base for a custom Tizen TV interface.
  • Prototyping remote-navigation UI in a browser before deploying to a TV.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/nthnclrk/CleanFrame.git
  2. 2

    Enter the project folder

    cd CleanFrame
  3. 3

    Install dependencies (requires Node.js 22+)

    npm ci
  4. 4

    Start the browser preview, then open localhost:4795/home/

    npm run dev:public

Things to know

  • It was built for one Samsung The Frame TV and is only tested on that reference setup.
  • Setup scripts reflect the author's computer, TV and firmware, so you must adapt them yourself.
  • Only Tizen is supported; Android TV, Google TV, LG webOS and Roku would need separate implementations.
  • Native Home and startup changes use undocumented helpers that can fail after firmware updates.

Topics

#tizen#smart-tv#samsung#home-screen#javascript#es5#remote-navigation

FAQ

What is CleanFrame?
A personal home screen for Samsung The Frame TVs running Tizen, with apps, a photo background and a remote-friendly interface you can fork and adapt. CleanFrame is a quieter home screen for Samsung The Frame TV. It shows your chosen apps, a photograph and the time, and is designed to be navigated with the TV remote. The project is a Tizen app built with an ES5 runtime, and the author shares it as a starting point rather than a polished, portable product.
Is CleanFrame free to use? What license does it have?
CleanFrame is open source under the MIT license. Check the license terms before using it in commercial products.
Is CleanFrame still maintained?
Actively maintained. The last commit to CleanFrame was on Oct 20, 2026.
What can I use CleanFrame for?
Turning a Samsung The Frame into a personal, photo-led home screen. Forking the project as a base for a custom Tizen TV interface. Prototyping remote-navigation UI in a browser before deploying to a TV.
How do I install CleanFrame?
Clone the repository: git clone https://github.com/nthnclrk/CleanFrame.git Enter the project folder: cd CleanFrame Install dependencies (requires Node.js 22+): npm ci Start the browser preview, then open localhost:4795/home/: npm run dev:public
Where can I get CleanFrame?
The source code and installation instructions are on GitHub: https://github.com/nthnclrk/CleanFrame

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects