CleanYourTV 설정 가이드
더 깔끔한 Android TV 또는 Google TV 홈 화면을 시작하기 위한 안내입니다.
CleanYourTV는 Gathin23이 만든 오픈 소스 프로젝트입니다. 이 웹사이트는 프로젝트 사용 흐름을 설명하는 독립적인 무료 가이드입니다. 소스 패키지에는 프로젝트 README, 프롬프트, 기기 예시, 테마, 문제 해결 메모와 보안 메모가 들어 있습니다.
사용하는 TV 모델부터 정확히 확인하세요
압축을 푼 소스 패키지의 examples/ 기기 보고서에서 모델, 지역, 펌웨어를 확인하세요. 지원되는 시작 환경은 Android TV와 Google TV입니다. 설치 프롬프트는 Fire TV, Samsung Tizen 또는 LG webOS를 지원하지 않습니다.
TV 준비하기
TV와 컴퓨터를 같은 로컬 네트워크에 연결하세요. 설정을 열고 정보로 이동한 다음 Build 항목을 일곱 번 눌러 개발자 옵션을 잠금 해제합니다. 사용할 수 있다면 USB 디버깅과 네트워크/ADB 디버깅을 켜세요. 본인이 신뢰하는 컴퓨터에서 온 디버깅 요청만 승인하세요.
TV의 네트워크 또는 Wi-Fi 설정에서 IPv4 주소를 찾아 어시스턴트에 알려 주세요. 이 웹사이트의 설정 양식은 해당 주소를 시작 프롬프트에 넣을 수 있지만, 네트워크를 스캔하거나 연결하지는 않습니다.
일부 Google TV는 페어링 코드와 별도 연결 포트를 사용하는 무선 디버깅을 제공합니다. 일반 연결이 되지 않으면 5555 포트가 항상 열려 있다고 가정하지 말고 설치 프롬프트의 페어링 절차를 따르세요. 연결 문제 해결 가이드에서 확인할 사항을 설명합니다.
현재 프로젝트 흐름에 따라 진행하세요
설치 프롬프트를 열고 전체 내용을 터미널에 접근할 수 있는 코딩 어시스턴트에 복사한 뒤, 정확한 TV 모델을 알려 주세요. 확인 지점마다 멈추며 진행하도록 요청하세요. 프로젝트는 무료이지만 일부 코딩 어시스턴트는 별도로 사용료를 청구합니다.
변경하기 전에 패키지 목록, 비활성화된 패키지 상태, 설정과 기기 정보를 저장하세요. 어떤 스트리밍 앱, 음성 비서, 캐스팅 서비스와 업데이트를 유지할지 확인합니다. 알 수 없는 패키지나 입력, 리모컨, 오디오, 키보드, Play 서비스에 필요한 구성 요소는 비활성화하지 마세요.
런처는 소스에서 빌드합니다. 전체 소스 ZIP을 다운로드하고 압축을 푸세요. 프로젝트 폴더 전체를 보관하세요. 빌드 스크립트에는 tools/와 launcher/의 파일도 필요합니다.
Python 3, JDK 17, Android SDK Platform 34, Android Build Tools 34.0.0을 준비하세요. 압축을 푼 README.md에 수동 설정 방법이 있습니다. 알맞은 Windows 빌드 스크립트 또는 macOS/Linux 빌드 스크립트를 다운로드해 압축을 푼 launcher/ 디렉터리에 넣고 그곳에서 실행하세요. 이는 소스 빌드 스크립트이며, 미리 만들어진 APK 다운로드가 아닙니다.
새 런처를 Home으로 지정하기 전에 교체 런처가 정상적으로 열릴 때까지 기존 런처를 활성화해 두세요. 명령의 성공 메시지만 믿지 말고 TV에서 Home 버튼을 눌러 확인하세요.
일부 펌웨어는 사이드로드 앱이나 타사 Home 런처를 차단합니다. 확인 제한이나 제조사 서명 제한으로 기기가 설치를 거부하면 런처 설치를 중단하고 해당 모델의 안내를 읽으세요. 설치를 반복한다고 호환성이 확인되는 것은 아닙니다.
확인하고 마무리하기
Home, 리모컨의 바로가기 및 설정 버튼, HDMI 입력, 소리와 캐스팅을 확인하세요. 디버깅을 끄고 권한을 취소한 다음 재부팅합니다. 다운로드할 수 있는 ADB 종료 확인 도구를 사용해 ADB 포트가 연결을 거부하는지 확인하세요. 시간 초과나 라우팅 오류는 연결 거부가 확인된 것과 다릅니다.
런처를 원하는 대로 꾸미기
기본 설정이 작동하면 런처 설정에서 앱 행을 배치하고 애니메이션을 유지할지 결정하세요. 압축을 푼 themes/README.md에 배경, 색상과 Dock을 변경하는 방법이 있습니다. 테마를 적용하기 전에 설명을 읽고, 적용한 뒤 리모컨과 Home 버튼을 다시 확인하세요.
복원 또는 문제 해결
원래 패키지 목록과 상태 기록을 컴퓨터에 보관하세요. 해당하는 Windows 복원 스크립트 또는 macOS/Linux 복원 스크립트를 다운로드해 압축을 푼 tools/ 디렉터리에 넣고, 실제로 적용한 목록과 함께 사용하세요. 이 스크립트는 기록된 상태를 복원하는 도구이며 전체 시스템 이미지가 아닙니다. 모델별 문제와 보안 안내는 압축을 푼 소스 패키지의 docs/TROUBLESHOOTING.md와 SECURITY.md를 읽으세요.