Bạn có chiếc Samsung The Frame và thấy màn hình Home mặc định của nó hơi ồn ào? CleanFrame là thứ để ngó. Đây là home screen cá nhân do nthnclrk viết cho chính chiếc TV của mình, rồi mở mã nguồn để người khác fork và tùy biến.
Nói thẳng: nó thay giao diện Home mặc định bằng một màn hình yên tĩnh hơn. Bạn có app, một bức ảnh làm nền, và đồng hồ 12 giờ đơn giản. Toàn bộ điều khiển thiết kế cho remote TV, không phải cho chuột hay cảm ứng. Chấm hết. Không có tính năng AI, không có đồng bộ cloud, không có gì phức tạp.
Vấn đề nó giải quyết
Home screen mặc định trên The Frame, cũng như phần lớn Smart TV Tizen, là một mớ nội dung đề xuất, quảng cáo và app xếp theo thuật toán. Với một chiếc TV treo tường đóng vai trò tranh nghệ thuật, giao diện đó phá vỡ cảm giác tĩnh lặng. CleanFrame đưa về đúng ba thứ cần thiết: app, một bức ảnh, và giờ. Tác giả gọi đây là “quieter home screen”, và mô tả đó khá chính xác với những gì mã nguồn thể hiện.
Repo này không phải sản phẩm hoàn chỉnh cho mọi người. Ngay trong README tác giả viết rõ: “Use it at your own risk. Most of the work has gone into making it work well on my TV. Very little has gone into making it portable.” Đọc câu đó xong thì bạn hiểu mình đang đối mặt với cái gì. Đây là điểm khởi đầu để fork, không phải bản cài đặt một phát ăn ngay.
Vì sao repo được chú ý
526 sao trong ngày đầu tiên (repo tạo và cập nhật cùng ngày 2026-10-20) là con số đáng kể cho một dự án cá nhân không có topics, không marketing. Lý do khá dễ hiểu: cộng đồng The Frame khá đông, ai cũng biết Tizen không cho tùy biến nhiều, và việc thay được Home screen là điều người dùng mong từ lâu nhưng ít ai làm được vì phải đụng tới signing certificate, Developer Mode, và mấy helper không được tài liệu hóa của Samsung.
Điểm khác biệt nằm ở chỗ tác giả không bán giấc mơ. Anh ghi rõ phần cứng tham chiếu: QA55LS03DAWXXY / LS03D, firmware 2130.0, Tizen 9.0, 32-bit ARM. Ghi rõ cái gì đã xác nhận chạy được (cài đặt và launch app qua 0.6.1, mở Netflix/YouTube, bấm Home vật lý từ Netflix), và cái gì còn mở (khởi động bình thường sau khi dùng streaming hay Art Mode, đường thoát Smart Hub đã sửa, native Art Mode destinations). Một bảng “Evidence and limits” như vậy hiếm thấy ở repo cá nhân. Nó cho người fork biết mình đang đứng ở đâu.
Cài và chạy thử trên browser
Phần hay nhất: bạn không cần đụng tới TV để xem giao diện. Chỉ cần Node.js 22+ và Python 3.10+.
git clone https://github.com/nthnclrk/CleanFrame.git
cd CleanFrame
npm ci
npm run dev:publicMở localhost:4795/home/. Dùng phím mũi tên, Enter, Escape, hoặc click vào các nút điều khiển. Lưu ý là app launch và mấy màn hình Samsung cần TV thật, bản preview sẽ báo giới hạn đó khi bạn chọn.
Bản preview dùng font Manrope, Geist, Newsreader đi kèm. Muốn chỉnh sửa gì thì mở Settings trong giao diện, đổi List hay Dock layout, icon hay tên hay cả hai, chọn nền ảnh hoặc nền sáng/tối, chỉnh typography và hiệu ứng kính. Có 15 wallpaper để chọn, lưu preference cục bộ trên máy.
Một chi tiết kỹ thuật nên biết: glass và blur được render sẵn thành ảnh, TV chỉ load ảnh đã xử lý xong rồi dùng transform và opacity để phản hồi focus. Cách làm này hợp lý với phần cứng TV yếu, tránh phải chạy blur realtime trên con chip 32-bit ARM.
Ai nên dùng, và dùng thế nào
Đối tượng chính là dev có một chiếc The Frame và chịu khó vọc. Tác giả khuyến nghị dùng coding agent: mở repo trong agent local, đưa một task giới hạn, ví dụ đọc AGENTS.md, docs/development.md, docs/interaction-behaviour.md rồi giúp adapt. Anh còn đưa luôn prompt mẫu. Điều kiện quan trọng: agent cần quyền truy cập máy local để làm việc với TV. Một chat hosted không thể chạm tới TV chỉ bằng cách đọc repo.
Quy trình đưa lên TV chia giai đoạn, có hướng dẫn riêng cho The Frame: bật Developer Mode trên remote, dùng tool chính thức của Samsung, tạo certificate và app identity của riêng bạn, cài đặt, kiểm tra bằng mắt, và có đường recovery. Cài app và gán nút Home là hai bước tách biệt. Tác giả cảnh báo phần native Home/startup dùng helper không có tài liệu, có thể hỏng sau khi firmware update, nên phải giữ baseline recovery trước khi thử. App vẫn mở thủ công được nếu không đụng vào phần đó.
Nếu bạn chỉ muốn đổi giao diện cho đẹp mà không muốn đụng tới signing, hãy dừng ở bản browser preview, fork, sửa CSS, sửa font, sửa layout. Đó là phần an toàn và cũng là phần thú vị nhất.
So sánh nhanh
Thị trường home screen thay thế cho TV không nhiều. Với Android TV có một vài launcher cộng đồng, với webOS thì gần như không có gì phổ biến. CleanFrame đứng riêng ở chỗ nó nhắm đúng Tizen và đúng dòng The Frame, thay vì cố làm universal. Đó vừa là điểm mạnh (tác giả tối ưu cho một thiết bị cụ thể) vừa là giới hạn (README nói rõ: “Android TV, Google TV, LG webOS and Roku need their own implementations”).
Ưu điểm và những gì cần cân nhắc
- License MIT cho code và tài liệu gốc. Font, ảnh, logo giữ điều khoản riêng, xem
THIRD_PARTY_NOTICES.md. Binary Pangram trả phí bị loại khỏi Git và bản public export. - Bản preview chạy được ngay, không cần TV. Đây là điểm cộng lớn, nhiều repo TV bắt bạn phải có thiết bị mới thử được.
- Tài liệu trung thực về giới hạn. Tác giả ghi rõ cái gì đã test, cái gì chưa. Hiếm.
- Script setup gắn chặt với máy tác giả. Path, signing profile, identity check, installed-app ID đều phải sửa. Agent sẽ cần adapt từng bước và verify với bạn.
- Chưa có compatibility claim với TV khác. Đừng kỳ vọng cắm vào là chạy trên LG hay Sony.
- Phần native Home/startup là rủi ro sau firmware update. Tác giả nói thẳng điều này.
Một điểm nữa: repo này không có topics, không có release, mới chỉ một commit ngày đầu. Nếu bạn cần thứ đã ổn định, đây chưa phải. Nếu bạn thích đọc code, fork, và tự chịu trách nhiệm với cái TV của mình, thì nó đúng gu.
Kết
CleanFrame không hứa biến TV của bạn thành thứ gì khác. Nó chỉ đưa về một màn hình gọn hơn, ba thành phần, và một bộ script đủ để người có kinh nghiệm tự đi tiếp. Với 526 sao trong ngày đầu và license MIT, nó đáng để clone về xem ít nhất phần browser preview. Còn đưa lên TV thật thì hãy chuẩn bị tâm lý sửa script, đọc kỹ bảng “Evidence and limits”, và giữ một baseline recovery trước khi đụng vào nút Home. Repo ở đây: nthnclrk/CleanFrame.
