수록 현황:469 건의 뉴스/102 개의 AI 도구/417 개의 오픈소스 프로젝트/75 개의 학습 자료
홈뉴스오픈소스모델AI 도구Skills학습 자료
홈 / 오픈소스 / cleanyourtv

cleanyourtv

Wi-Fi를 통해 Android TV 및 Google TV에서 블로트웨어, 광고, 텔레메트리를 제거하고 가벼운 Apple TV 스타일 런처를 설치하세요. 루팅 없이 완전히 되돌릴 수 있습니다.

JavaNOASSERTIONApplication
⭐ GitHubhttps://github.com/Gathin23/cleanyourtv
30,126
스타 수
+0
스타 증가율
2026년 10월 24일
최근 업데이트
11
클릭 수

1. 프로젝트 개요

CleanYourTV는 Wi-Fi를 통해 사전 설치된 블로트웨어, 광고, 텔레메트리를 제거하고 기본 홈 화면을 가벼운 Apple TV 스타일 런처로 교체하는 Android TV 및 Google TV용 오픈소스 도구 모음입니다. 루팅도, 케이블도, 앱 삭제도 필요 없으며 한 줄 명령으로 복원할 수 있습니다.

2. 배경 및 포지셔닝

제작 동기

많은 스마트 TV에는 기기 속도를 저하시키고 홈 화면을 어수선하게 만드는 사전 설치 앱, 프로모션 콘텐츠 행, 광고 서비스, 백그라운드 텔레메트리가 함께 제공됩니다. CleanYourTV는 사용자가 이미 변경할 수 있도록 허용된 설정(내장 ADB 디버깅)만을 활용하여 자신의 TV를 안전하게 제어할 수 있는 되돌리기 가능한 방법을 제공합니다.

유사 프로젝트와의 차이점

  • 설계 단계부터 보장되는 되돌리기 기능: 앱은 pm disable-user로 비활성화되며 절대 삭제되지 않고, 기록된 스냅샷을 통해 단일 명령으로 복원할 수 있습니다.
  • 기기 인식 기능: 블로트 제거 목록이 브랜드마다 다르므로, 코딩 어시스턴트가 사용자의 특정 TV를 검사한 후 변경 전에 확인을 요청합니다.
  • 번들 런처: 블로트 제거와 대체 홈 화면이 하나의 프로젝트에 포함되어 있습니다(약 497KB, 순수 Java, RAM 1GB TV에서 실행 가능).
  • 커뮤니티 검증 목록: examples/ 폴더에는 사용자가 기여한 모델별 블로트 제거 목록(170개 이상 모델)이 저장되어 있습니다.

3. 기능 분류

🧹 블로트웨어 및 광고 제거

루팅 없이 텔레메트리, 광고 서비스, 콘텐츠 행, 사전 설치 앱을 비활성화합니다.

  • 설치된 패키지 목록 및 설정 백업
  • pm disable-user 기반 비활성화(아무것도 삭제되지 않음)
  • 대체 앱 없이 활성 홈 앱을 비활성화하지 못하도록 하는 안전 검사
  • 펌웨어 업데이트로 복원된 패키지를 감지하는 check.py(--fix로 재적용)
  • 기록된 상태에서 한 줄로 복원

📺 가벼운 런처

Android TV 및 Google TV를 위한 빠르고 미니멀한 대체 홈 화면입니다.

  • 즐겨찾기 독과 앱 그리드가 있는 검은색 배경
  • 포커스된 앱의 이름을 표시하는 상단 선반
  • 유리 스타일의 포커스 하이라이트 및 반투명 버튼(입력, 네트워크, 설정)
  • 선택적으로 CPU, 메모리, 저장공간 통계를 표시하는 시계 화면 보호기
  • 좌우 대칭 RTL 레이아웃을 포함한 25개 언어 지원

🎨 테마 및 사용자 지정

런처를 다시 빌드하지 않고도 외관을 개인화할 수 있습니다.

  • 색상, 배경화면, 독, 열 수 설정 가능
  • default, aurora, six-columns 등 번들 테마 제공
  • tools/theme.sh로 테마 적용
  • 리모컨 키 재매핑 및 앱 라이브러리(선택 사항)

🧩 애드온 및 모듈 카드

선택적 앱으로 런처를 확장합니다.

  • 다른 앱은 사용자 승인 시에만 타일을 추가할 수 있음
  • 애드온은 addons/ 폴더에 위치
  • cleanyour.tv에서 앱 및 애드온 관련 안내 페이지 제공

🔒 개인정보 보호 및 안전 도구

TV가 백그라운드에서 수행하는 작업을 파악하고 줄여줍니다.

  • privacy.py는 음성, ACR, 텔레메트리 후보를 증거와 함께 보고
  • adb-closed.py는 이후 네트워크 ADB 포트가 닫혔는지 확인
  • Private DNS를 통한 인앱 광고 차단을 위한 선택적 AdGuard DNS 설정
  • 안전한 원격 관리를 위한 선택적 Tailscale

🛠️ 개발자 및 진단 도구

관리자 및 기여자를 위한 유틸리티입니다.

  • tv.py 순수 Python ADB 클라이언트 및 프로브
  • 성능 및 시각 검사를 위한 bench.py, trace.py, screendiff.py
  • 기기 관리를 위한 manage.py
  • tests/ 내 테스트 스위트

4. 주요 특징

  • 루팅 불필요, 케이블 불필요: TV의 내장 네트워크 ADB 디버깅을 사용하여 Wi-Fi로 작동합니다.
  • 완벽한 되돌리기: 아무것도 삭제되지 않으며, 스냅샷 기반 복원으로 TV를 이전 상태로 되돌립니다.
  • AI 지원 워크플로: PROMPT.md를 Claude Code, Codex, Gemini CLI 같은 코딩 어시스턴트에 붙여넣으면 약 15분 만에 전체 정리 과정을 안내합니다.
  • 초경량 런처: 약 497KB 크기의 순수 Java로 작성되었으며 Android 8.0(API 26) 이상을 대상으로 합니다.
  • 폭넓은 커뮤니티 커버리지: TCL, Sony, Xiaomi, Philips 등 다양한 브랜드의 170개 이상 TV 모델에 대해 검증된 블로트 제거 목록을 제공합니다.
  • 기본값으로 글로벌 지원: 25개 인터페이스 언어를 지원하며, 일본어, 베트남어, 중국어 간체 README 번역을 제공합니다.

5. 역할별 활용 사례

  • 일반 사용자 및 TV 소유자: 기술적 위험 없이 더 빠르고 깔끔한 홈 화면을 얻을 수 있습니다.
  • 일반 개발자: 컴팩트한 네이티브 Android TV 런처와 순수 Python ADB 클라이언트를 학습할 수 있습니다.
  • DevOps / SRE: 스크립트와 Tailscale을 사용하여 TV 또는 키오스크 기기를 원격으로 관리할 수 있습니다.
  • 보안 엔지니어: privacy.py로 텔레메트리, 음성, ACR 후보를 감사하고 이후 ADB가 닫혔는지 확인할 수 있습니다.
  • 프로젝트 관리자 / 통합 담당자: 공유된 블로트 제거 목록을 사용하여 일관되고 광고 없는 사이니지 또는 숙박 시설 디스플레이를 준비할 수 있습니다.

6. 시작하기

필요한 정보 찾기

examples/의 모델별 목록과 docs/의 가이드를 살펴보거나 https://cleanyour.tv 를 방문하세요.

설치 / 통합

  1. TV에서 개발자 옵션과 USB 디버깅을 활성화하고, 컴퓨터와 동일한 Wi-Fi에 연결된 상태를 유지합니다.
  2. PROMPT.md를 코딩 어시스턴트에 붙여넣고 TV 모델을 입력하거나, 다음 수동 명령을 실행합니다:
git clone https://github.com/Gathin23/cleanyourtv.git
cd cleanyourtv
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
tools/disable.sh examples/<model>/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh
tools/theme.sh themes/aurora

모든 변경 사항을 되돌리려면:

tools/restore.sh examples/<model>/debloat.txt

커뮤니티에서 제작한 Android 앱을 사용하면 컴퓨터 없이 스마트폰에서도 정리를 수행할 수 있습니다.

기여하기

검증된 TV 모델의 블로트 제거 목록을 examples/에 추가한 후, CONTRIBUTING.md를 읽고 풀 리퀘스트를 열어주세요: https://github.com/Gathin23/cleanyourtv/blob/main/CONTRIBUTING.md

7. 프로젝트 구조

cleanyourtv/
├── addons/        # 모듈 카드로 표시되는 선택적 애드온 앱
├── docs/          # 가이드, 사양, 문제 해결, 기기 참고 사항
├── examples/      # 모델별 블로트 제거 목록
├── launcher/      # Android 런처 소스 및 빌드 스크립트
├── themes/        # 테마 폴더 (default, aurora, six-columns, ...)
├── tools/         # Python/shell 유틸리티 (tv.py, disable.sh, restore.sh, check.py, privacy.py)
├── tests/         # 테스트 스위트
├── PROMPT.md      # 코딩 어시스턴트 기반 설정용 프롬프트
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

8. 관련 생태계

  • Android Debug Bridge (ADB): TV를 제어하는 데 사용되는 메커니즘입니다.
  • 코딩 어시스턴트: Claude Code, Codex, Gemini CLI가 안내형 설정을 주도할 수 있습니다.
  • 빌드 툴체인: 런처를 위해 JDK 17 및 build-tools 34.0.0이 포함된 Android SDK 플랫폼 34를 사용합니다.
  • 선택적 서비스: Tailscale(원격 관리) 및 AdGuard DNS(광고 차단).
  • 관련 플랫폼: Fire TV는 블로트 제거만 지원됩니다. Samsung(Tizen) 및 LG(webOS)는 별도의 참고 사항으로 다루어지는 다른 시스템입니다.

9. 라이선스

  • ✅ MIT 라이선스 조건에 따라 상업적 용도를 포함하여 소프트웨어를 사용, 복사, 수정, 배포할 수 있습니다(프로젝트 README에 명시됨).
  • ✅ 라이선스 고지를 유지한 채 자체 프로젝트에 포함할 수 있습니다.
  • ❌ 어떠한 보증도 제공되지 않으며, 저작자는 손해에 대한 책임을 지지 않습니다.
  • ❌ 어떤 TV 제조사와도 제휴하거나 승인을 받지 않았습니다.
  • ℹ️ GitHub는 해당 라이선스를 인식 불가(NOASSERTION)로 보고합니다. 저장소의 LICENSE 파일을 확인하세요.
  • ℹ️ Outfit 폰트는 SIL Open Font License를 따릅니다.

10. 자주 묻는 질문

Q: 안전한가요? 그리고 되돌릴 수 있나요?
A: 앱은 비활성화될 뿐 삭제되지 않습니다. tools/restore.sh examples/<model>/debloat.txt를 실행하여 되돌리세요.

Q: Fire TV, Samsung 또는 LG TV에서도 작동하나요?
A: Fire TV는 블로트 제거만 지원합니다. Samsung(Tizen) 및 LG(webOS)는 다른 시스템이므로 직접 지원되지 않습니다.

Q: 펌웨어 업데이트가 변경 사항을 되돌리나요?
A: 업데이트로 인해 패키지가 다시 활성화될 수 있습니다. check.py를 실행하여 변경된 내용을 확인하고, --fix를 추가하여 목록을 다시 적용하세요.

Q: 컴퓨터 없이도 할 수 있나요?
A: 네, 커뮤니티에서 제작한 Android 앱이 스마트폰에서 동일한 정리를 수행합니다.

Q: 작업 후에도 ADB를 켜두어야 하나요?
A: 아니요. 네트워크 ADB는 5555 포트에서 암호화되지 않으므로, 완료 후 끄고 adb-closed.py로 확인하세요.

11. 빠른 링크

12. 요약

CleanYourTV는 TV 소유자에게 루팅 없이 Wi-Fi만으로 블로트웨어, 광고, 텔레메트리를 제거하고 빠르고 깔끔한 런처를 설치할 수 있는 안전하고 되돌리기 가능한 방법을 제공합니다. 더 빠르고 조용한 홈 화면을 원하는 Android TV 또는 Google TV 사용자뿐만 아니라, 학습하거나 확장할 수 있는 컴팩트하고 잘 문서화된 코드베이스를 원하는 개발자와 보안 엔지니어에게도 적합합니다.