Gathin23/cleanyourtv는 안드로이드 TV와 구글 TV의 첫 화면에서 광고와 추천 줄을 걷어 내는 저장소입니다. 2026년 10월 17일 공개됐고, 3주 만에 깃허브 스타 5만 개를 넘겼습니다(11월 7일 기준 약 5만 3천 개). 라이선스는 MIT입니다.
사람이 명령을 하나씩 치는 대신, 코딩 에이전트(Claude Code, Codex 등)에게 저장소의 PROMPT.md를 주고 맡기는 방식입니다. README에 따르면 15분쯤 걸립니다.
무엇을 바꾸나
| 단계 | 하는 일 |
|---|---|
| 백업 | 설치된 앱 목록과 설정을 저장 |
| 끄기 | 제조사 수집 앱, 광고 서비스, 추천 줄, 미리 깔린 앱을 pm disable-user로 끔. 지우지 않음 |
| 설치 | 572KB짜리 첫 화면 앱(런처)을 깔고 기본 홈으로 지정 |
루팅도 케이블도 필요 없고, 마음이 바뀌면 한 줄로 되돌립니다.
새 첫 화면은 애플 TV를 닮았습니다. 검은 바탕에 좋아하는 앱 네 개가 놓인 독, 고른 앱 이름을 크게 띄우는 윗단, 아래로 내리면 나오는 앱 격자, HDMI 입력 이름이 보이는 입력 버튼, 시계 화면보호기가 있습니다. 테마로 색과 배경, 독 크기를 바꿉니다.
준비물
- TV와 같은 Wi-Fi에 있는 컴퓨터
- Python 3, JDK 17~22(23 이상은 Gradle 8.9가 멈춤), Android SDK platform 34와 build-tools 34
- Claude Code나 Codex 같은 코딩 에이전트
Docker만 있으면 tools/docker-build.sh로 런처를 빌드할 수도 있습니다.
순서
-
TV에서: 설정 → 기기 환경설정 → 정보 → 빌드를 일곱 번 누름 → 뒤로 → 개발자 옵션 → USB 디버깅 켜기. 네트워크(ADB) 디버깅 스위치가 있으면 그것도 켭니다.
-
컴퓨터에서: 저장소를 받아 그 폴더를 에이전트로 엽니다.
PROMPT.md를 붙여 넣고 TV 모델명을 적습니다.git clone https://github.com/Gathin23/cleanyourtv -
따라가기: TV에 뜨는 “USB 디버깅을 허용할까요?”를 승인하고, 에이전트의 질문(쓰는 앱, 독 크기와 순서, 음성 비서·크롬캐스트·업데이트를 남길지)에 답합니다.
저장소를 꼭 받아서 여는 이유가 있습니다. 에이전트가 직접 스크립트를 짜지 않고 저장소의 tools/disable.sh와 런처 빌드 스크립트를 쓰는데, 백업과 복구 기록이 거기서 만들어집니다. 에이전트는 단계마다 TV 화면을 캡처해 확인합니다.
되돌리기
tools/restore.sh examples/<내 TV>/debloat.txt # 끈 앱을 다시 켜고 원래 런처로앱을 끄기만 했으므로, 바꾸기 전에 남긴 기록대로 되돌립니다. 새 런처에서 뺀 앱은 앱 보관함에서 한 번 눌러 다시 홈에 올립니다.
되는 TV, 안 되는 TV
- 됨: 안드로이드 TV·구글 TV. 지금까지 122개 브랜드 456개 모델의 목록이 모였습니다(TCL, 소니, 샤오미 등).
- 절반: Fire TV는 앱 끄기만 됩니다. Fire OS가 다른 런처에 홈을 넘기지 않기 때문입니다.
- 안 됨: 삼성(Tizen), LG(webOS), Roku, Vizio, Hisense VIDAA. ADB가 없어서입니다. 대신 추적 기능을 끄는 법을 cleanyour.tv/not-android에 모아 뒀습니다.
컴퓨터나 코딩 에이전트가 없다면 README의 “Doing it by hand”로 같은 일을 직접 하거나, 안드로이드 폰·맥·윈도용 커뮤니티 앱을 쓰면 됩니다. 커뮤니티 앱은 다른 개발자들이 같은 목록으로 만든 것입니다.
볼 점
- 끄는 목록은 브랜드마다 다릅니다. 프롬프트는 에이전트가 내 TV에서 직접 찾아보고, 쓸 만한 앱은 끄기 전에 묻게 되어 있습니다.
- 제조사 업데이트가 끈 앱을 다시 켤 수 있습니다.
오늘 할 일
TV 설정에서 개발자 옵션부터 켜 보세요. 빌드 번호를 일곱 번 누르는 데서 시작합니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.87의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/87.