TV Detox가 하는 일
TV Detox는 오래되고 느린 TV의 반응성을 높이도록 설계된 소형 Android TV 홈 화면 프로젝트입니다. 블로트웨어, 광고, 스폰서 행을 끄고 앱, HDMI 입력, 시계가 포함된 단순한 화면을 표시하여 시각적·소프트웨어 혼잡을 줄여 줍니다.
이 프로젝트는 변경하는 앱을 제거하지 않습니다. 대신 앱을 꺼서 나중에 복원할 수 있도록 합니다. 포함된 작업 흐름에서는 애니메이션을 끄고, 절전 동작을 설정하고, TV를 다시 시작하며, 정리 전후의 여유 메모리를 비교할 수도 있습니다.
시작하기 전에
TV Detox는 Android TV 9, Android TV 11, Android TV 12 및 Google TV 14를 대상으로 합니다. 제조업체에 따라 메뉴가 다르므로 도움을 요청할 때 TV의 브랜드와 모델을 함께 알려 주세요.
이 과정을 신중하게 진행하세요. README에서는 이를 전문적인 조언이 아닌 개인 설정으로 설명하며, TV에 적용한 변경에 대한 책임은 사용자에게 있습니다. 가장 안전한 방법은 제안된 변경 사항을 모두 검토하고 되돌리기 지침을 준비해 두는 것입니다.
개발자 모드 활성화
- TV에서 설정을 엽니다.
- 기기 환경설정 또는 시스템을 연 다음 정보를 선택합니다.
- TV에 개발자가 되었다는 메시지가 표시될 때까지 빌드를 일곱 번 누릅니다.
- 설정 메뉴로 돌아가 개발자 옵션을 엽니다.
- USB 디버깅을 활성화합니다. 사용할 수 있다면 네트워크 디버깅 또는 무선 디버깅도 활성화합니다.
- 첫 연결 요청이 나타나면 항상 허용을 선택하고 허용을 누릅니다.
옵션 1: Claude Code 또는 Codex 사용
가장 간단한 설정 방법은 노트북에서 Claude Code 또는 Codex를 사용하는 것입니다. 노트북과 TV를 같은 Wi-Fi 네트워크에 연결하고 AI 코딩 도구를 연 다음 아래 요청을 입력합니다. 자리 표시자를 TV 모델과 계속 표시할 앱으로 바꾸세요.
Android TV를 정리하고 더 빠르게 만들어 주세요.
내 TV는 <브랜드 및 모델>입니다.
1. Wi-Fi를 통해 내 TV에 연결해 주세요. TV에서 눌러야 할 항목이
있으면 단계별로 안내해 주세요.
2. 아무것도 변경하기 전에 모든 앱을 쉬운 말로 분류해 주세요:
꺼도 안전한 앱, TV에 필요한 앱, 내가 사용하는 앱으로 나눠 주세요.
여유 메모리도 확인해 주세요.
3. 변경할 때마다 먼저 물어보세요. 앱은 삭제하지 말고 꺼 주세요.
Google Play, 키보드, Bluetooth 또는 내 HDMI 입력은 절대 끄지 마세요.
변경한 항목과 되돌리는 방법을 목록으로 기록해 주세요.
4. 홈 화면을 설치해 주세요. 다음 저장소를 다운로드하고
install.sh를 내 TV 및 다음 앱과 함께 실행해 주세요:
https://github.com/Ansub/tv-detox
앱: <내 앱>
5. 애니메이션과 화면 보호기를 끄고 TV가 5분 후 절전 모드로
전환되도록 설정해 주세요.
6. TV를 다시 시작하고 전후의 여유 메모리를 보여 주세요.AI 도구는 TV에 표시되는 요청을 처리하도록 안내하고 각 변경 전에 확인을 요청해야 합니다. 앱 분류를 주의 깊게 검토하세요. 프로젝트 지침에 따라 Google Play, 키보드, Bluetooth 및 HDMI 입력은 활성화된 상태로 유지하세요.
옵션 2: 홈 화면 수동 설치
AI 도구 없이도 adb인 Android Debug Bridge를 사용하여 홈 화면을 설치할 수 있습니다. macOS에서는 다음 명령으로 설치합니다.
brew install android-platform-toolsTV Detox 저장소를 다운로드하고 프로젝트 디렉터리에서 터미널을 연 다음 TV의 IP 주소를 사용하여 설치 프로그램을 실행합니다.
sh install.sh <TV_IP>이 방식에서는 TV 앱을 자동으로 감지합니다. 앱을 명시적으로 선택하려면 패키지 이름을 쉼표로 구분한 목록으로 입력합니다.
sh install.sh <TV_IP> "com.netflix.ninja,com.hulu.livingroomplus"대부분의 TV는 기존 홈 화면을 비활성화할 때까지 계속 기존 홈 화면을 엽니다. 설치 프로그램에서 해당 홈 화면을 끄도록 요청합니다. TV Detox는 기존 홈 화면을 제거하지 않으므로 나중에 복원할 수 있습니다.
홈 화면 설치 되돌리기
TV의 기존 홈 화면을 복원하고 TV Detox 홈 화면을 제거하려면 다음을 실행합니다.
sh undo.sh <TV_IP>이 명령은 홈 화면 설치를 되돌립니다. 다른 정리 변경 사항을 되돌리려면 Claude Code 또는 Codex에 생성된 변경 목록의 각 항목을 되돌리도록 요청하세요.
개발자 빌드 및 테스트
개발자는 TV Detox를 로컬에서 빌드할 수 있습니다. 이 프로젝트는 라이브러리나 Gradle 없이 일반 Java를 사용합니다. 인터페이스는 단일 화면이며 배경은 한 번만 그려지고 유일한 애니메이션은 포커스 상승 효과입니다. README에 따르면 메모리 사용량은 약 30 MB입니다.
Android 빌드 환경 준비
Java 17과 Android SDK를 설치합니다. macOS에서는 README에 다음 명령이 제공됩니다.
brew install openjdk@17
brew install --cask android-commandlinetools
sdkmanager "platforms;android-34" "build-tools;34.0.0"구성 및 빌드
기본 앱 패키지 이름을 apps.txt에 한 줄에 하나씩 입력합니다. 처음 여섯 항목이 표시됩니다. 또는 패키지 이름을 install.sh에 직접 전달할 수 있습니다.
다음 명령으로 프로젝트를 빌드합니다.
sh build.sh그런 다음 로컬 빌드를 설치합니다.
sh install.sh <TV_IP>첫 빌드에서 TV Detox는 key.jks를 생성합니다. 이후 업데이트에서도 같은 서명 키를 사용해야 하므로 이 파일을 안전하게 보관하세요.
스모크 테스트 실행
빌드 및 설치가 끝나면 TV 또는 에뮬레이터에서 프로젝트를 확인합니다.
sh ci/smoke-test.sh <TV_IP 또는 emulator>HDMI 입력은 홈 화면에서 자동으로 감지되므로 앱 목록에 수동으로 추가할 필요가 없습니다.
문제 해결 팁
시작할 때 TV에서 라이브 TV 또는 HDMI가 열립니다
이 동작은 TV Detox 홈 화면이 아니라 TV 설정에 의해 제어됩니다. AI 어시스턴트에게 사용 중인 정확한 브랜드와 모델의 시작 설정을 찾아 라이브 TV 또는 HDMI를 여는 옵션을 비활성화해 달라고 요청하세요.
개발자 메뉴의 모양이 다릅니다
제조업체마다 이러한 메뉴의 이름이 다릅니다. 설정, 기기 환경설정 또는 시스템, 그리고 정보 항목을 찾아보세요. 연결 설정을 찾을 수 없다면 다음과 같이 물어보세요. 저는 <브랜드 및 모델> TV를 사용하고 있습니다. 노트북에서 이 TV에 연결해 제어하려면 어떻게 해야 하나요?
모든 변경 사항을 검토하세요
변경 사항을 무조건 승인하지 마세요. 먼저 앱 목록과 각 앱의 용도를 쉬운 말로 정리해 달라고 요청하고, 사용하는 앱을 확인한 뒤 Google Play, 키보드, Bluetooth, HDMI 입력이 활성화된 상태로 유지되는지 확인하세요. 이 프로젝트는 앱을 삭제하는 대신 사용 중지하는 방식으로 설계되어 복구가 더 쉽습니다.
결론
TV Detox는 오래된 Android TV를 간소화하는 실용적인 방법을 제공합니다. 개발자 모드를 활성화하면 Claude Code 또는 Codex의 안내에 따라 정리 작업을 진행하고, ADB를 사용해 가벼운 홈 화면을 수동으로 설치하거나, 직접 프로젝트를 빌드하고 테스트할 수 있습니다. 기존 홈 화면과 사용 중지한 앱을 복원할 수 있으므로 이전 구성으로 돌아갈 방법을 확보한 상태에서 이 설정을 시험해 볼 수 있습니다.