Aerial TV 데스크톱 교체 튜토리얼: aerial-tv 설치, 복원 및 부팅 광고
친구가 지난주에 Xiaomi TV를 새로 샀는데, 전원을 켜면 먼저 30초 광고가 나오고 데스크톱을 아래로 넘기면 전부 추천 항목이다. 그는 그저 몇 개의 App만 보고 싶다고 했는데, 매번 남의 진열대에서 자기 물건을 찾아야 한다.
이 요구는 너무나 보편적이다. 며칠 전 GitHub에 Aerial이라는 프로젝트가 등장해서 이틀 만에 2천 개 넘는 star를 얻었다—이것은 플레이어도 아니고 어떤 영상 자료 사이트도 아니며, 단 한 가지 일만 한다:TV의 데스크톱을 바꾸는 것。
먼저 데이터를 보자, 이것은 "듣기로는 인기 있다"는 것이 아니다
내가 저장소를 확인했다(10월 22일 오전 기준): 2026년 10월 20일 저장소 생성, 하루 남짓 만에 2.0k star, 138개의 fork, 최신 release는 10월 21일에 발표된 v1.22이고, 두 설치 패키지는 각각 약 2.4 MB이며, MIT 라이선스다. 작성자는 pengchujin이고, GitHub 저장소 이름은 pengchujin/aerial-tv, 공식 사이트는 aerial.qust.me이다. 인터넷에서 aerialtv 또는 Aerial TV로 쓰는 사람도 있는데 모두 같은 프로젝트를 가리킨다. 아래에 쓰인 기능, 명령, 기종은 전부 저장소 README와 공식 사이트 원문에 대응하며, 들은 것은 하나도 없다.
이틀에 2천 star가 어떤 개념인가—대부분의 개인 오픈소스 프로젝트는 1년이 지나도 도달하지 못한다. 이것이 소수 취미용 장난감이 아니라 많은 사람이 같은 문제로 불편을 겪고 있음을 보여준다.
그것이 도대체 무엇을 바꾸는가
분명히 말하자면: Aerial은안드로이드 TV의 데스크톱(Launcher)이며, Apple tvOS를 참조해 만들었다. 그것이 관리하는 것은 Home 키를 눌러 돌아가는 그 화면이고, 콘텐츠는 관리하지 않는다.
그것이 제공하는 것은 매우 절제되어 있다: 배경화면 위에 큰 시계, 한 줄에 다섯 개 App의 그리드, 신호 소스(HDMI/AV/안테나)를 타일로 만들기, 길게 눌러 App 이동 또는 숨기기, 리모컨 위 키를 눌러 오른쪽 상단의 제어 센터로 진입(포커스가 거기 있을 때 메뉴 키를 직접 눌러도 됨). 화면 보호기는 114개의 Apple TV 항공 촬영 영상이며, 장면 전환 시 지명을 표시한다. 배경화면은 Bing 일일精选을 사용한다.
它不하는 일도 분명히 말해야 한다: 어떤 TV 채널도 포함하지 않고, 영상 리소스도 포함하지 않으며, 플레이어를 내장하지 않고, 당신의 계정을 건드리지 않는다. 당신이 설치한 그 영상 App들은 그대로 있고, 다만 문을 여는 그 자리의 주인이 바뀌었을 뿐이다.
그리고 먼저 말해야 할 것이 하나 더 있는데, 헛수고를 하지 않기 위해서다:부팅 광고는 없앨 수 없다. 공식 FAQ의 원문은 「부팅 광고는 펌웨어에서 재생되며, 없앨 수 없다」이다 — 그 몇 초는 TV 시스템이 Aerial 시작 전에 재생하는 것이고, 데스크톱을 바꿔도 그 층까지는 관여할 수 없다. 그것이 정리할 수 있는 것은 부팅 후 당신 눈앞의 그 화면이다: 추천 영역, 멤버십 진입점, 자동 재생 예고편. 이 차이가 당신이 이 20분을 써야 하는지 말해준다.
그것이 어떻게 "인수"하는지, 대가는 무엇인지
이 부분이 당신이 설치할지 말지를 결정하니, 끝까지 볼 가치가 있다.
중국산 TV의 펌웨어는 보통 데스크톱을 마음대로 바꾸는 것을 허용하지 않으므로, 그것은 네 가지 방법을 사용했다:
- 정상 신청: 시스템에 HOME 역할을 신청하고 기본 데스크톱으로 설정한다. 순정 Android TV는 여기까지만 하면 충분하다.
- 데스크톱 가디언: 제조사 펌웨어가 자사 데스크톱으로 계속 되돌릴 때, 접근성 서비스로 "어느 창이 포그라운드로 왔는지"를 감시하다가 공식 데스크톱이 고개를 내밀면 Aerial을 다시 끌어온다. 작성자는 이것이 창 전환만 볼 뿐 화면 내용은 읽지 않는다고 선언했다.
- 종료 후 부활: Xiaomi 대기 상태는 서드파티 App을 강제 종료하는데, 그것은 알림 리스너(마찬가지로 알림 내용을 읽지 않는다고 선언)에 의존해 시스템이 다시 바인딩할 때 부활한다.
- 부팅 시 자동 시작, 별도로 선택 가능한 ADB 상시 켜기。
대가는 솔직히 세 가지다: 첫째,ADB 디버깅을 반드시 켜야 한다, 이는 일반인이 가장 불편해하는 단계다; 둘째, 접근성 및 알림 리스너 권한을 부여해야 한다——작성자는 창과 바인딩에만 사용한다고 하지만 이는 작성자의 말일 뿐이니 믿을지는 직접 판단해야 한다; 셋째, ADB 상시 켜기는 같은 LAN에서 잘 아는 사람이 당신의 TV에 연결할 수 있음을 의미한다,나는 설치 후 바로 ADB를 끄고 상시 켜두지 말 것을 권장한다。
장점은 root가 필요 없고 어떤 시스템 앱도 건드리지 않으며 언제든 복원할 수 있다는 것이다.
설치 전에 세 가지를 먼저 확인하라
첫째, TV가 Android TV 시스템이어야 한다. LG의 webOS, 삼성의 Tizen, 화웨이 하모니 스마트 스크린, Android 4.4 및 그 이전 시스템은 모두 지원하지 않으니 시간을 낭비하지 마라.
둘째, 브랜드를 보라. 작성자가 실측하여 일상 사용 중인 것은 Xiaomi MiTV-MFTR0(Android 14 / HyperOS TV)와 TCL MT5879 중국 정식판이며; 커뮤니티에서 통과 피드백이 있는 것은 Redmi X65 2026, Sony XRJ-77A80J / BRAVIA VH1, Skyworth Coocaa K3 Pro, Konka 2861, PPTV K55U27, Tencent Aurora Box 7S, 다수의 Xiaomi TV, XGIMI 프로젝터, OPPO K9이다.
설치 불가로 알려진 것: Thunderbird 55S595C Ultra(ADB 인증 불가, HOME 점유 불가), Vidda / Hisense / Thunderbird Crane 6 2025 Ultra(설치는 되지만 부팅 진입 불가). 이 몇 가지는 억지로 시도하지 마라.
셋째, TV와 당신의 컴퓨터(또는 휴대폰)가같은 LAN。
1단계: TV의 ADB 열기 (브랜드마다 다름)
Xiaomi / Redmi: 설정 → 정보 → 「제품 모델명」 연속 탭 → 계정 및 보안 → 「ADB 디버깅」과 「알 수 없는 출처의 앱 설치」 켜기.
TCL / FFALCON: 설정 → 정보 → 본체 정보 → 리모컨으로 「상하좌우」 빠르게 누르기 → 더보기 → ADB 켜기.
Haier / MOOKA: TV 본체의 신호원 버튼 누르기 → 리모컨 「좌좌상우」 → 공장 메뉴 진입 → ADB 켜기.
OPPO: 설정 → 시스템 → 본체 정보 → 기기 모델명 → 「상상우우」 + 확인.
기타 Android TV: 「빌드 번호」 일곱 번 연속 탭 → 개발자 옵션 → USB 디버깅 켜기.
브랜드별 메뉴 이름은 펌웨어에 따라 바뀌므로, 찾을 수 없으면 설정에서 「ADB」 또는 「개발자」를 검색.
2단계: TV의 IP 확인
설정 → 네트워크 (또는 「정보 → 상태」)에서 현재 Wi-Fi의 IP를 볼 수 있으며, 형식은 192.168.1.20와 같다. 기록해 두자, 이후 세 단계 모두에서 필요하다. 다음에 IP가 바뀌어 다시 찾지 않도록 router에서 고정 할당을 해두는 것을 권장.
3단계: 설치, 세 가지 방법 중 하나 선택
방법 A: 명령을 실행할 수 있는 AI Agent에 맡기기(작성자 추천). WorkBuddy, Doubao, Qwen, Trae, Claude Code처럼 명령을 실행할 수 있는 도구가 있다면, 공식에서 제공한 프롬프트와 TV IP를 함께 넘기면 알아서 설치를 완료한다.
방법 B: 한 줄 명령 (macOS / Linux)
curl -fsSL https://aerial.qust.me/install.sh | KEEP_ADB=1 TV=192.168.1.20 bash把 192.168.1.20 자신의 TV IP로 바꿔서 사용.KEEP_ADB=1 설치 후 ADB를 끄지 않는 것을 의미한다——앞서 설치 후에는 끄는 것을 권장한다고 했으므로, 이 줄은 제거해도 된다.
방식 C: 수동 ADB (Windows 사용자는 이 방법을 따른다)
PC에 Android platform-tools(공식 SDK에 포함된 패키지)를 설치하고, 압축을 푼 뒤 명령줄에서 해당 디렉터리로 이동하여 순서대로 실행한다:
adb connect 192.168.1.20:5555
adb install -r aerial-standard.apk
adb shell pm grant app.orchard.tv android.permission.WRITE_SECURE_SETTINGS
adb shell cmd notification allow_listener app.orchard.tv/app.orchard.tv.guard.RevivalListener
adb shell appops set app.orchard.tv SYSTEM_ALERT_WINDOW allow
adb shell am start -n app.orchard.tv/.MainActivityAPK는 프로젝트의 Releases 페이지에서 다운로드하며, 다음을 확인한다 aerial-standard.apk(일반 버전) 및 aerial-guard.apk(데몬 버전). TV에 처음 연결할 때 TV에 「디버깅 허용」 팝업이 뜨면 반드시 허용을 눌러야 한다.
단계 4: 설치 후 이 단계들을 빠뜨리지 말 것
Aerial을 열고 안내에 따라 기본 런처로 설정한다; TV 펌웨어가 자꾸 런처를 되돌린다면 다음으로 교체한다 aerial-guard.apk 다시 설치한다(명령에서 파일명만 바꾸면 된다). TCL 사용자는 설치 시 「다중 화면 상호작용」 권한 부여 창이 뜨는데, 리모컨의 「오른쪽」을 누른 후 확인해야 하며, 누르지 않으면 실패한다.
마지막으로 설정으로 돌아가ADB를 끈다. 일상 사용에는 켜둘 필요가 없다.
문제가 생겼을 때 되돌리는 방법
이것이 내가 가장 중요하게 여기는 점이다: 복원 가능하다. macOS / Linux에서 실행:
curl -fsSL https://aerial.qust.me/install.sh | TV=192.168.1.20 bash -s restoreWindows에서 수동 설치한 경우, TV에서 Aerial을 제거하고 기본 런처를 시스템 기본 런처로 되돌리면 된다. 롬 플래싱도, 공장 초기화도 필요 없다.
제 판단: 누가 설치해야 하고, 누가 굳이 고생하지 말아야 하는가
설치해야 하는 사람은 이런 사람이다: 매일 부팅할 때 광고와 추천 영역에 짜증이 나고, 위의 모든 단계를 이해할 수 있으며, 20분 정도 한 번 투자할 의향이 있는 사람. 설치 후 그 TV는 확실히 "당신의 TV"가 된다.
설치하지 말아야 하는 경우는 이런 몇 가지다: TV가 HarmonyOS / webOS / Tizen인 경우; 집안 어르신이 "켜면 바로 보는" 것만 할 줄 아는 경우, 설정이 한 겹 더 늘어나는 것 자체가 재앙이다; 그리고 ADB를 켜기를 꺼리는 사람—이 단계는 우회할 수 없고, 억지로 설치하면 중간에 막힐 뿐이다.
그리고 세 가지 리스크를 미리 말해둬야 한다. 첫째는펌웨어 업그레이드로 인해失效할 수 있다는 점이고, 그때는 다시 설치하면 된다, 놀라지 마라. 둘째는항공 촬영 영상의 저작권은 Apple에 있다는 점이며, 프로젝트는 공개 주소로 재생할 뿐, 영상을 집으로 가져오는 것이 아니니 이 점을 "무료로 영상 소스 제공"으로 오해하지 마라. 셋째는 이런 데스크톱을 깊이接管하는 도구가 보증에 영향을 주는지 여부는 직접 제조사에 문의하라, 나는 제조사를 대신해 결론을 내리지 않는다.
만약 단지 광고를 덜 보고 싶고 시스템은 건드리고 싶지 않다면, 더 가벼운 방법을 먼저 시도하라—예를 들어Xiaomi 휴대폰의 광고 끄는 그 사고방식처럼, TV 쪽에도 유사한 스위치가 있다. 정말로 데스크톱을 완전히 깨끗하게 하고 싶다면, 그때 Aerial을 적용하라.
덧붙이자면: 데스크톱을 바꾼 후, 많은 사람의 다음 단계는 영상을 다시 자기 집에 저장하는 것이다.NAS로 가정 영상 서비스를 구축하는 것이 더 안정적인 장기 방안이다; 만약 손에 아직 구형 박스가 있다면, 먼저그 하드디스크가 얼마나 더 버틸 수 있는지 확인하라계속 사용할지 다시 결정하세요.
프로젝트 정보와 명령은 모두 작성자의 공개 저장소(2026-10-21 버전 v1.22)를 기준으로 하며, 버전 업데이트가 빠르므로 실행 전 저장소의 현재 설명을 기준으로 하세요.
