며칠 전 Ryan Doyle 이 Claude Code 를 사용해 자기 TV 를 커스터마이징했다는 글을 보고, 나도 내 TV 로 뭘 할 수 있을지 궁금해졌다.
https://x.com/doooyle/status/2111196679680540724
내 TV 는 Tizen 이 구동되는 2024 년형 삼성 'The Frame' 이다.
나는 삼성의 Smart Hub(아니면 뭐라고 부르든 간에)가 정말 싫었고, 내가 실제로 쓰는 앱들만 모아둔 더 단순한 홈 화면을 원했다.
일단 내가 만든 이 해결책을 Clean Frame 이라고 부르기로 했다.
스크린샷 몇 장을 올린 뒤로, 삼성 TV 에서 어떻게 작동하게 만들었는지, 액자 모드(Art Mode)로도 여전히 잘 쓰이는지, 레포지토리를 공유할 건지에 대한 질문이 쏟아졌다. 이미 몇 명은 Claude 로 시도해 봤다가 막혔다고 했다.
개인적으로 이걸 글로 정리할 시간이 많지 않아서, Codex 에게 우리 대화 스레드를 검토하게 하고 몇 분간 내용을 받아쓰기했더니 아래에 있는 결과물이 나왔다.
빠른 면책 조항:
나는 절대 전문가가 아니다. 여기에는 분명히 위험이 따르며, 이런 설정을 바꾸면 문제가 생기거나 TV 를 못 쓰게 될 수도 있다. 시도한다면 모든 책임은 본인에게 있다.
TV 에 앱 설치하기
디자인을 고민하기 전에 아주 보수적으로 접근했다. 일단 내 앱을 TV 에 올릴 수나 있는지부터 확인하고 싶었다.
Samsung 설정 과정을 진행하기 위해 Astra 와 함께 Codex 를 사용했고, TV 의 개발자 모드를 켜고 컴퓨터에서 연결하는 것부터 시작했다. Tizen 에는 자체 앱을 설치할 수 있는 개발자 도구가 있어서 거기서 출발했다.
앱 자체는 그냥 HTML, CSS, JavaScript 다. Samsung 도구들이 이걸 패키징해서 TV 에서 돌아갈 수 있게 해준다. TV 는 여전히 Tizen 이 구동하며, Clean Frame 은 TV 에 이미 설치된 스트리밍 앱들을 열어주는 역할만 한다.
첫 버전은 아주 기초적이었다. 리모컨으로 앱 두어 개 사이를 이동하고 OK 를 눌러 Netflix 나 YouTube 를 열 수 있었다. 그 시점에서 테스트하기에 필요한 건 그게 전부였다.
TV 에 테스트하고 설치했던 첫 번째 버전.
그게 작동하고 나서야 비로소 화면에 실제로 뭘 넣고 싶은지 고민하기 시작했다.
직접 시도해 본다면, 세팅 방법은 다음과 같다:
- 컴퓨터와 TV 를 같은 로컬 네트워크에 둔다.
- TV 에서 Apps → App Settings 를 열고 리모컨 숫자 패드로 12345 를 입력한다.
- Developer Mode 를 켜고 Host PC IP 항목에 컴퓨터의 로컬 IP 주소를 입력한다.
- TV 를 재시작한 다음, Samsung 개발 도구를 사용해 컴퓨터에서 연결한다.
- Samsung 인증서 도구를 사용해 author certificate 와 distributor certificate 를 생성한다. distributor certificate 에 TV 의 기기 ID(DUID) 를 추가한 뒤, 앱을 패키징하고 설치한다.
주소가 헷갈리기 쉽다. TV 에는 컴퓨터 IP 를 입력하고, 컴퓨터에서는 TV IP 를 사용해 연결한다. Samsung 연결 가이드와 인증서 가이드에 과정이 잘 나와 있다.
Samsung SDB 도구를 설치했다면, 아래 명령어로 TV 가 인식되는지 연결하고 확인할 수 있다. TV_IP 를 본인 TV 의 로컬 주소로 바꿔주면 된다:
1sdb connect TV_IP:261012sdb devices
컴퓨터가 연결되기 전에 벽면 콘센트에서 The Frame 전원을 껐다 켜야 했다. 리모컨 전원 버튼을 누르면 그냥 Art Mode 로 들어가기 때문이었다.
서명 방식 때문에 앱이 거절당한 적도 있었다. 이건 Samsung 자체 패키징 도구를 사용하니 해결됐다.
어떤 프롬프트를 사용했을까?
누군가는 Codex 가 자신의 시도를 자꾸 막는다며 프롬프트를 물어봤다. 다른 사람들은 Claude 가 Tizen 에서는 불가능하다고 했거나, 커스텀 앱을 빌드하는 단계까지만 갔다고 했다. 그 세션들에서 뭐가 달랐는지는 모르겠다. Astra 와 함께 쓴 Codex 는 내 TV 에서 작동시켰고, 나는 한 단계씩 차근차근 접근했다.
이건 내 세션의 정확한 프롬프트라기보다는, 어디서부터 시작하면 좋을지 보여주는 예시다:
1내 Samsung Frame TV 용 간단한 런처를 만드는 걸 도와줘.2내 모델명과 펌웨어를 Samsung 개발자 문서와 대조해서 확인해 줘.3기존에 설치된 스트리밍 앱을 열 수 있는 기본적인 서명된 Tizen 앱부터 시작하자.4TV 에서 그게 제대로 작동하기 전까지는 Home 이나 시작 설정은 건드리지 마.
디자인 방향 잡기
Codex 와 Claude Opus 5.5 를 사용해 디자인을 몇 가지 시도해 봤다. 어떤 건 앱 이름이 크게 적힌 단순한 목록이었고, 어떤 건 사진 위에 독(dock)이나 그리드가 올라간 형태였다. 나란히 비교해 보니 내가 뭘 좋아하는지 파악하는 데 도움이 됐다.
브라우저에서 테스트해 본 초기 글래스 그리드 디자인인 Shore Tiles.
그다음부터는 레이아웃, 폰트, 그리고 리모컨으로 조작할 때의 느낌을 계속 다듬었다.
브라우저에 작은 외관 빌더(appearance builder)도 만들어서 배경, 폰트, 레이아웃, 글래스 효과를 다양하게 조합해 볼 수 있었다. 덕분에 TV 에 올리기 전에 뭐가 잘 맞는지 훨씬 쉽게 확인할 수 있었다.
여러 옵션을 나란히 비교해 볼 수 있었던 외관 빌더.
결국 목록과 독을 모두 유지하고, 배경·폰트·아이콘을 선택할 수 있는 설정을 넣었다. 어떤 앱을 표시할지 고르고 원하는 순서대로 배치할 수도 있다.
브라우저에 표시된 목록 레이아웃.
속도가 빠른지 묻는 사람들도 있었다. 처음부터 빠르진 않았다. 글래스 효과는 브라우저에선 멋져 보였지만, TV 에선 이동할 때 버벅거렸다. 두 가지가 이걸 해결해 줬다. 이미지를 최적화하고, TV 가 실시간으로 효과를 렌더링하게 하지 않고 글래스 효과를 미리 준비해 둔 것이다. 지금은 반응 속도가 엄청나게 빠르다. 스트리밍 앱 자체가 열리는 데 걸리는 시간은 여전히 똑같다.
앱 목록도 정리해야 했다. Tizen 에 설치된 앱을 조회했더니 수백 개의 항목이 쏟아졌다. 대부분 백그라운드 서비스, 계정 관련 도구, 시스템 앱이었다. 그래서 각 항목의 이름과 앱 ID 를 확인해 내가 쓰는 스트리밍 앱만 남기고 내부용 항목들은 선택기(picker)에서 제외하는 필터를 추가했다. 그 앱들은 여전히 TV 안에서 제 역할을 하고 있다. 이건 Clean Frame 의 목록을 깔끔하게 정리한 것뿐이지, 삭제하거나 비활성화한 게 아니다.
소파에서 더 잘 보이도록 앱 이름을 키우고 여백을 넓혔다. 또 어떤 앱이 선택됐는지 명확하게 드러나게 하고 싶었고, 설정을 닫으면 원래 있던 자리로 다시 돌아오길 바랐다. 이런 자잘한 디테일을 두고 꽤 많은 시행착오를 거쳤다.
홈 화면으로 만들기
작동 방식이 마음에 들자, Home 버튼을 눌렀을 때 이 화면으로 돌아오게 만들고 싶어졌다.
먼저 Samsung 의 시작 설정을 시도했다. Start with Smart Hub Home 을 끄고 Autorun Last App 을 켰다. 그랬더니 TV 를 켤 때 마지막으로 사용한 앱이 Clean Frame 이라면 다시 실행됐다.
하지만 무언가를 시청한 뒤 Home 버튼으로 돌아오는 건 좀 더 손이 필요했다. Clean Frame 을 설치하면 열 수 있는 앱이 생기긴 하지만, TV 에게 이걸 홈으로 쓰라고 지정해 줘야 했다. 그래서 개발자 연결을 통해 TV 에서 한 번만 실행되는 작은 헬퍼 프로그램을 사용했다. 이 프로그램은 TV 의 홈 설정을 Clean Frame 으로 변경하고 해당 홈 앱의 자동 실행을 활성화한다. 만약을 위해 기존 설정을 먼저 저장해 두고 복원 가능한지도 확인했다.
Netflix 로 테스트해 봤다. Netflix 를 연 상태에서 일반 리모컨의 Home 버튼을 누르니 바로 Clean Frame 으로 돌아왔다. 즉, 앱을 열었다가 평소 쓰는 그 버튼 하나로 나만의 홈 화면으로 돌아올 수 있게 된 것이다.
같은 걸 시도한다면, 이 부분은 Samsung 공식 문서에 나온 앱 설정 범위를 넘어선다. 내 기기는 펌웨어 2130.0 이 설치된 LS03D Frame 이다. 우리가 참고한 자료는 다른 Samsung 모델용이었기 때문에, 수정하기 전에 내 TV 와 대조해서 확인했다. 헬퍼는 한 번만 실행하면 되므로 Mac 을 계속 연결해 둘 필요가 없다.
개발자 연결을 통해 실행됐고 루팅 권한은 필요 없었다. 그래도 이 부분은 신중하게 다루길 권한다. TV 의 홈 설정을 변경하는 작업이고, 모델이나 펌웨어가 다르면 결과가 달라질 수 있다.
현재 상황
내 TV 에 설치돼 있고 아주 잘 작동한다. 레이아웃, 폰트, 배경을 바꿀 수 있고, 원하는 앱들을 원하는 순서대로 유지할 수 있다.
일반 리모컨이 잘 먹히고, Home 을 누르면 Clean Frame 으로 돌아오며, TV 를 액자로도 여전히 쓸 수 있다.
내가 시도해 본 조합 몇 가지를 소개한다. 배경, 레이아웃, 폰트, 포커스 스타일, 앱과 Home 컨트롤이 표시되는 방식을 바꿀 수 있다. 아래 스크린샷들은 현재 브라우저에서 실행 중인 앱에서 캡처한 것이다.
Focus 설정. 홈 화면에서 Glass 와 Clear tint 가 어떻게 보이는지 미리보기가 제공된다.
목록 레이아웃, Mori 타이포그래피, Type 포커스, Home 컨트롤 아이콘을 적용한 Blue Peaks.
Mori 타이포그래피와 Type 포커스를 적용한 검은색 배경 텍스트 전용 모드.
독 레이아웃, Clear tint 소재, Glass 포커스를 적용한 Mountain Valley.
이 글을 쓰는 시점에도 레포지토리 링크를 요청하는 사람이 꽤 많다. 아직 몇 가지를 정리하고 있어서 나중에 여기에 추가할지도 모른다. 그동안 이 가이드를 따라 TV 모델명과 펌웨어를 확인하고 한 단계씩 진행하면, 직접 만드는 데 큰 도움이 될 것이다.
댓글에서 나온 몇 가지 질문
액자 모드(Art Mode)로 여전히 쓸 수 있나요?
네, 잘 됩니다. Clean Frame 의 배경은 Samsung 의 Art Mode 와 별개입니다.
Netflix 나 다른 앱이 업데이트되면 어떻게 되나요?
그 앱들은 여전히 TV 가 설치하고 관리하는 앱입니다. Clean Frame 은 그저 그걸 열어줄 뿐이에요. 제가 Netflix 나 YouTube 의 별도 버전을 유지보수하는 게 아닙니다. 다만 Samsung 펌웨어 업데이트는 또 다른 문제인데, 아직 그런 업데이트 이후에도 홈 설정이 유지되는지 테스트해 보진 않았습니다.
Tizen 을 지우거나 Android 를 설치한 건가요?
TV 는 여전히 Tizen 으로 돌아갑니다. Clean Frame 은 Tizen 앱이고, Home 버튼을 누를 때 이게 열리도록 홈 설정만 바꾼 겁니다. Android 를 설치하거나 TV 운영체제를 교체한 게 아니에요.
다른 TV 에서도 작동하나요?
구형 Samsung, LG, Hisense, Vizio 에 대해 묻는 분들이 있었는데, 저는 전혀 모릅니다. 하지만 다양한 모델에서 이걸 시도하는 사람들이 점점 늘어나는 것 같습니다. 제가 보기엔 Tizen 이 오히려 까다로운 축에 속하는 것 같으니, 여러분 TV 에서도 작동할 가능성이 높습니다.
인터페이스가 4K 인가요?
인터페이스는 1920 × 1080 으로 제작되어 화면에 맞게 스케일링됩니다. 네이티브 4K 버전은 만들지 않았어요. 이건 스트리밍 앱 내부의 영상 화질과는 별개의 문제입니다.
Home Assistant 와 연동되나요?
현재 Clean Frame 에 Home Assistant 통합 기능은 없습니다. 지금까지는 홈 화면 자체와 일반 리모컨으로 사용하는 데 집중했어요. 그렇긴 해도 결국 웹 앱이기 때문에 다른 기능을 추가하는 건 상당히 간단할 테니, 충분히 가능할 것으로 봅니다.
