에이전트 스킬·프롬프트도구/라이브러리Python

Gathin23/cleanyourtv

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

GitHub 에서 보기 ↗카드 기준일 2026-10-31 · 처음 작성 2026-10-29 · 갱신 2026-11-02
+15,751지난 주
48.6%규모 대비 성장률
48,138누적 스타

AI 작성이 카드는 AI(Claude)가 공개 자료(README·릴리스·HN·웹 글)로 쓴 요약입니다. 사람이 검토하지 않았으며, 주장마다 출처 링크와 확인·추정 표시를 붙였습니다. 숫자는 GitHub API 값을 코드가 채웁니다.

013줄 요약

  • 무엇인지 — CleanYourTV는 코딩 에이전트용 프롬프트와 ADB 도구로 Android TV·Google TV의 광고·텔레메트리 앱을 Wi-Fi로 비활성화하고, Apple TV 스타일의 가벼운 런처로 홈 화면을 바꾸는 오픈소스 프로젝트다.
  • 왜 지금 떴나 — 2026-10-20에 HN에 'Strip the Bloatware from Any Android TV or Google TV over Wi-Fi'가 올라오고 같은 날 v2.4.0이 나오면서 급등했고, 이후 v2.7.0까지 거의 매일 릴리스가 이어지며 화제가 지속됐다.
  • 어떤 의미인지 — 문서화되지 않은 기기를 에이전트가 직접 조사하고, 사용자에게 확인을 받은 뒤 되돌릴 수 있게 변경하는 '프롬프트로 배포하는 소프트웨어'의 대중적 사례다.

02숫자

누적 스타48,1382026-10-31
지난 주+15,751전주 32,023
규모 대비 성장률48.6%주 시작 32,387
생성10.172026년
주간 스타 · 최근 12주
12주 전10.25 주
이번 주 일별 스타 (UTC)
일 10.25토
항목값
누적 스타48,138 (2026-10-31 기준)
이번 주 증가+15,751
성장률+49% (주 시작 32,387)
AI 탭 순위지금 뜨는 2위 · 새로 뜨는 1위 · 규모 대비 급성장 15위
일별 증가10-25 +3,839 · 10-26 +3,628 · 10-27 +2,426 · 10-28 +1,873 · 10-29 +1,567 · 10-30 +1,275 · 10-31 +1,143
급등일2026-10-20 +6,831 (이전 기록 0 — 공개·출시 무렵)
유형 · 카테고리도구/라이브러리 · 에이전트 스킬·프롬프트
확인 필요없음

03왜 지금 떴나

  • 2026-10-19 첫 태그 릴리스 v2.1.0에서 Google TV용 설치 순서를 더 안전하게 바꿨고, 같은 날 v2.3.0에서 지원 TV와 번역이 늘었다. Claude Code로 TV를 디블로트하는 가이드 글도 이날 나왔다. newreleases.io · GitHub 릴리스 · saascity.io (확인)
  • 2026-10-20 HN에 'Strip the Bloatware from Any Android TV or Google TV over Wi-Fi'가 올라왔다. 다른 HN 스레드에서는 '많은 사람이 기여하는 인기 디블로터를 쓰라'는 추천 댓글이 달렸다. 같은 날 TV 안에서 설정을 바꾸는 기능과 앱 라이브러리를 더한 v2.4.0이 릴리스됐다. HN · HN 댓글 · GitHub 릴리스 (확인)
  • 2026-10-21 v2.5.0에서 리모컨으로 독을 편집하고 배경화면을 고르는 기능이 추가됐다. 커뮤니티 PR이 계속 합쳐졌다. GitHub 릴리스 (확인)
  • 2026-10-22 v2.6.0이 나왔고 HN에 두 번째 글이 올라왔다. Codex로 TV를 정리하는 YouTube 영상도 이날 공개됐다. GitHub 릴리스 · HN · youtube.com (확인)
  • 2026-10-23 v2.7.0에서 날씨·슬립 타이머 같은 기능을 별도 앱으로 분리한 Add-ons 구조를 도입했다. HN에 'Using AI to clean your smart TV'가 올라오고 Show HN 스레드에서도 언급됐다. GitHub 릴리스 · HN · HN 댓글 · HN 댓글 (확인)

04무엇인가

Android TV와 Google TV의 기본 홈 화면에는 제조사 광고, 스폰서 콘텐츠 행, 텔레메트리 앱이 깔려 있다. CleanYourTV는 루팅이나 케이블 없이 이를 걷어내고, 광고 없는 홈 화면으로 바꾸는 것을 목표로 한다. TV 개발자 옵션에서 USB 디버깅을 켜면 같은 Wi-Fi에 있는 컴퓨터가 ADB로 접속할 수 있다는 점을 이용한다.

작업은 세 단계다. 먼저 설치된 패키지 목록과 설정을 백업한다. 다음으로 제조사 텔레메트리, 광고 서비스, 콘텐츠 행, 선탑재 앱을 pm disable-user로 비활성화한다. 삭제가 아니라 비활성화이므로 복원 스크립트 한 줄로 되돌릴 수 있다. 마지막으로 작은 네이티브 런처를 설치해 기본 홈으로 지정한다. 블로트웨어 구성은 브랜드와 펌웨어마다 다르다. 그래서 핵심은 프롬프트다. Claude Code·Codex·Gemini CLI 같은 코딩 에이전트가 TV의 패키지를 직접 조사·분류하고, 사용자가 쓸 수도 있는 앱은 건드리기 전에 묻는다. 에이전트 없이 같은 작업을 직접 실행하는 셸 명령도 README에 있다.

저장소에는 이 프롬프트 외에도 순수 Python ADB 클라이언트, 디블로트·복원 스크립트, 커뮤니티가 기여한 모델별 패키지 목록, 런처 소스가 들어 있다. 바이너리는 배포하지 않으며 launcher/build-and-install.sh로 직접 빌드한다. 런처는 테마, config.json 옵션, 리모컨 설정 메뉴를 지원한다. v2.7.0부터는 날씨·기도 시간·슬립 타이머 같은 부가 기능을 권한이 분리된 별도 앱(Add-ons)으로 제공하고, 홈 화면에 카드로 띄운다. Samsung·LG·Roku처럼 Android 기반이 아닌 TV는 지원하지 않는다.

05비교

  • Ansub Khan의 TV Detox도 Claude Code·Codex 프롬프트로 ADB 디블로트와 미니멀 홈 화면 설치를 안내하는 비슷한 프로젝트다. 다만 이 비교는 프로젝트가 공식이 아니라고 밝힌 도메인의 페이지에서 나온 것이다. cleanyourtv.com · GitHub (추정)
  • README의 'Doing it by hand' 셸 스크립트는 에이전트 없이 같은 작업을 한다. HN에서는 에이전트 방식이 굳이 필요한지 의문을 제기했다. GitHub · HN 댓글 (확인)
  • @udhaykumarbala가 만든 커뮤니티 Clean Your TV 앱은 노트북이나 코딩 에이전트 없이 Android 폰만으로 연결·분석·정리를 한다. GitHub (확인)
  • CleanYourTV.ai는 이 오픈소스를 바탕으로 독립 개발된 가이드형 설치 도구다. Mac·Windows·Android용 앱과 추가 레이아웃을 내세우지만 공식 프로젝트가 아니다. cleanyourtv.ai · aidirectori.es (확인)

06활용사례

  • 한 YouTuber가 OpenAI Codex로 CleanYourTV를 실행해 Android TV의 블로트웨어와 광고를 없애고 런처를 교체하는 과정을 영상으로 공개했다. youtube.com (확인)
  • 케냐의 한 리뷰어는 Claude Code로 자기 TV를 디블로트했다. 그는 런처보다 '에이전트가 처음 보는 기기를 조사하고, 묻고, 되돌릴 수 있게 바꾸는 방식'이 핵심이라고 평가했다. kendesigners.com (확인)
  • 블로그 글은 다른 집에 있는 가족의 TV를 정리할 때 Tailscale 사설 연결을 쓰라고 안내한다. Private DNS를 AdGuard DNS 같은 광고 차단 리졸버로 지정하는 방법도 소개한다. victorhugosolis.com (확인)
  • 작성자는 부모님 TV에서 Netflix 전에 광고가 뜨는 문제를 AI 에이전트로 고친 것이 프로젝트의 시작이라고 밝혔다. 릴리스 검증도 부모님의 Mi TV 4A에서 했다. reddit.com · GitHub 릴리스 · GitHub 릴리스 (확인)

07한계·리스크

항목값
라이선스NOASSERTION
기여자444
상위 1명 기여 비중66%
지난 30일 이슈열림 469 · 닫힘 353
릴리스 주기약 1.4일마다
열린 이슈+PR163
  • ADB 디버깅을 켜야 하므로 네트워크 노출에 주의해야 한다. 프로젝트는 원격 지원 시 라우터에서 ADB 포트를 열지 말라고 경고한다. 디버깅을 켠 채 방치하면 공격 표면이 된다. victorhugosolis.com · GitHub (추정)
  • 며칠 사이 릴리스가 연달아 나왔고, 일부 빌드는 메인테이너 TV에서 돌려보지 않거나 일부 기능을 하드웨어로 검증하지 않은 채 태그됐다. 검증도 주로 기여자 각자의 기기에 의존하므로 모델별 안정성은 들쭉날쭉할 수 있다. GitHub 릴리스 · GitHub 릴리스 (확인)
  • cleanyourtv.com, cleanyourtv.ai 같은 비공식 도메인이 같은 이름을 쓰고 있다. 일부는 유료 서비스로 보여 사용자 혼동과 사칭 위험이 있다. GitHub · aidirectori.es · cleanyourtv.com · cleanyourtv.ai (확인)
  • 권장 경로가 유료 코딩 에이전트에 의존하고 바이너리 없이 직접 빌드해야 한다. 비개발자에게는 진입 장벽이 있고, Android 기반이 아닌 TV는 아예 지원하지 않는다. GitHub · HN 댓글 · saascity.io (추정)

08변경 기록

근거