이틀 전, 부모님 댁 TV 를 고쳐드렸습니다. 그러자 인터넷이 자기들 TV 도 알아서 고치기 시작했죠.
요약: Wi-Fi 로 어떤 Android TV 나 Google TV 든 불필요한 앱을 정리하고 Apple TV 스타일의 홈 화면을 만들어주는 프롬프트입니다. 루팅 불필요, 삭제되는 앱 없음, 한 줄이면 전부 되돌릴 수 있습니다.
트윗 하나, 이틀 만에 이름과 웹사이트가 생겼습니다: cleanyour.tv.
지금 당장 시작하고 싶다면 맨 아래 "직접 해보기"로 건너뛰세요. 아니면 계속 읽어주세요 :)
숫자로 보는 이틀
그리고 카드에 다 담지 못한 것들:
16 개 브랜드에서 테스트를 마친 30 대의 TV (그중 2 대는 프로젝터). 8 개 언어. 저장소 방문자 45,000 명. 그 위에 만들어진 9 개의 런처와 애드온.
어떻게 시작됐나
부모님 댁 TV 는 Netflix 에 들어가기도 전에 광고를 띄웠습니다. 돈 주고 산 TV 에서 은행 광고가 전체 화면으로 나온 거죠. 그래서 토요일 오후, 저는 Claude Code 를 켜고 TV 모델명을 입력했습니다.
AI 가 Wi-Fi 로 TV 를 찾아 실행 중인 모든 항목을 나열했고, 우리는 함께 그 목록을 훑었습니다. Xiaomi 패키지 25 개를 처리하자 광고, 텔레메트리, "Discover" 탭이 사라졌습니다. 그런 다음 새로운 홈 화면을 만들었죠. 검은 배경, 큰 타일 네 개, 시계 하나. 어머니는 "오, 보기 좋네"라고 하셨고, 그게 리뷰의 전부였습니다.
오후 2 시 21 분에 비포 & 애프터를 트윗하고 점심을 먹으러 갔습니다.
예상하지 못했던 일
점심을 먹고 돌아왔을 때 이미 트윗이 퍼지고 있었습니다. 다음 날 아침에는 좋아요 2 만 개, 저장소 스타 2 천 개가 찍혔습니다. 주말 동안 4 만 5 천 명이 TV 블로트웨어에 대한 README 를 읽은 겁니다.
그리고 풀 리퀘스트가 쏟아지기 시작했고, 지금도 멈추지 않았습니다. 오늘 하루만 50 개가 병합됐습니다 🤯
가장 멋진 건 답글이었습니다. 사람들은 "좋네요"라고 말만 한 게 아니라 직접 실행했거든요. 2017 년형 Sony TV 에서. 한 번 복구 모드로 부팅된 뒤 얌전해진 Hisense 에서. Samsung 자체 버전의 adb 를 쓰는 Samsung 프로젝터에서도 누군가 결국 작동하게 만들었습니다.
어떤 할머니는 이제 더 이상 소리를 지르지 않는 TV 를 갖게 됐습니다. 아내가 빨리 접근할 수 있도록 도크에 타밀어 드라마 두 개를 고정해 둔 사람도 있습니다. Fire TV 가 "이제 Wii 처럼 보인다"는 분도 있고, 자기 TV 에 Polymarket 실시간 배당률을 띄운 분도 있습니다.
정체가 뭔가요
솔직히 말하면 프롬프트 하나입니다. Claude Code 나 셸을 실행할 수 있는 어떤 어시스턴트에든 붙여넣을 수 있는 마크다운 파일 하나죠. Wi-Fi 로 TV 에 접속하는 방법, 무엇을 백업해야 하는지, 내 모델에서 쓸데없는 앱을 어떻게 찾아내는지 알려줍니다.
뭔가를 건드리기 전에 먼저 물어봅니다. 어떤 앱을 쓰는지, 도크에 넣을 네 개는 무엇인지, 음성 어시스턴트를 유지할 것인지. 그런 다음 작은 런처를 만들고 홈으로 설정한 뒤, TV 의 스크린샷으로 결과를 확인합니다.
첫날부터 세 가지 원칙이 있었습니다. 루팅 금지. 삭제하지 않고 비활성화만 할 것. 한 줄이면 전부 원상복구될 것. 확실히 하기 위해 오늘 밤 부모님 댁 TV 에서 그 명령어를 실행해 봤습니다. 광고가 다시 나타났죠. 그리고 설치를 다시 돌렸습니다.
토요일 이후 바뀐 점
- TV 1 대에서 30 대로. Xiaomi, TCL, Sony, Hisense, Philips, OnePlus, NVIDIA Shield, Chromecast, BenQ, CHiQ, RCA, SANYO, Toshiba, Insignia. 16 개 브랜드이며, 모든 목록은 직접 작업한 사람이 작성했습니다.
- 프로젝터. @zarubaf 님의 XGIMI, @aravinddass 님의 Stellamore. 키스톤 및 자동 초점 서비스는 "절대 비활성화하지 않음"으로 표시했습니다.
- Fire TV. 이제 Fire OS 에서도 블로트 제거가 됩니다. Amazon 광고는 사라지고, Amazon 홈은 그대로 남습니다.
- 테마. config.json 과 배경화면 하나를 TV 에 푸시하면 전체 디자인이 바뀝니다. 다시 빌드할 필요 없습니다.
- 모듈 카드. 어떤 앱이든 자기만의 타일을 선언할 수 있습니다. 런처가 한 번 물어보고, 기본값은 "숨김 유지"입니다. 첫 번째 모듈로 NES 라이브러리를 배포한 @udhaykumarbala 님이 만들었습니다.
- 8 개 언어. @angelwzr 님의 러시아어, @ScaryFr92 님의 프랑스어, 그리고 답글에 달린 태국어, 중국어, 카탈루냐어, 스페인어, 독일어.
- Google TV 충돌 루프 수정. 설정 마법사가 홈을 점유하면서 200ms 마다 시스템을 죽이고 있었습니다. 이제 설치 프로그램이 이를 감지하고 롤백합니다.
- Windows 지원. 모든 스크립트에 PowerShell 버전이 있습니다.
- adb 불필요. macOS 는 Google 의 adb 를 조용히 차단합니다. tools/tv.py 는 그런 거 신경 쓰지 않는 순수 Python 클라이언트입니다.
- 앱이 추가되거나 제거될 때 실시간으로 반영되는 타일 by @angelwzr. 이더넷 아이콘 by @sonalder-darlene. VPN 이 끊기면 빨간색으로 변하는 VPN 배지 by @zarubaf.
- 250KB 런처. 네트워크 요청 없음, 서비스 없음. RAM 1GB 기기용으로 제작.
- 화면 번인을 방지하기 위해 위치가 미세하게 이동하는 시계 화면 보호기.
- 한 줄 명령어로 복원. 오늘 밤 부모님 댁 TV 에서 양방향 모두 테스트 완료.
- 그 위에 만들어진 9 가지. @OmkarK97 님의 webOS 포트, @YouLop009 님의 Hisense 리스타일링, @benfirad 님의 Stremio 선반, @samdegan2311 님의 제어 센터, @rakshajag13 님의 오로라 화면 보호기, @rocavence 님의 클릭 사운드, @nguyenduchoai 님의 AirPlay, @itsmeterrylin 님과 @ljis120301 님의 Fire TV 런처.
- 웹사이트, 이름, 도메인. cleanyour.tv.
그래서, CleanYourTV
저장소 이름은 원래 tv-vibehack 이었는데, 토요일 프로젝트치고는 괜찮았지만 2 만 5 천 명이 읽는 프로젝트 이름으로는 영 아니었습니다.
오늘부터 주소는 여기입니다: https://github.com/Gathin23/cleanyourtv
직접 해보기
- TV 에서: 설정 → 정보 → 빌드 번호에서 OK 버튼 7 번 누르기 → 개발자 옵션 → USB 디버깅 켜기.
- 컴퓨터에서: cleanyour.tv 에 있는 프롬프트를 Claude Code 에 붙여넣고 TV 모델명을 알려주기.
- TV 에 뜨는 "USB 디버깅을 허용하시겠습니까?"를 수락하고 질문에 답하기.
15 분 정도 걸립니다. 목록에 없는 TV 라도 프롬프트가 알아서 블로트웨어를 찾아냅니다. 작업 후 목록을 공유해 주시면 다음 사람의 수고를 덜어줄 수 있습니다.
도움이 되었다면 저장소에 스타를 눌러주세요. 잘 작동했다면 스크린샷을 보내주세요. 새 TV 를 살 뻔한 걸 막아줬다면 커피 버튼도 있습니다.
풀 리퀘스트가 병합된 36 분, 답글로 목록을 보내주신 수많은 분들, 그리고 이게 뭔지는 여전히 모르시지만 광고가 사라진 걸 좋아하시는 저희 부모님께 감사드립니다.
GIF
