free-my-tv 딥다이브
— TV의 첫 화면을 그리는 법, 다시 돌려놓는 법

1프로젝트 한줄 요약

free-my-tv는 즐겨 쓰는 스트리밍 앱, 작품 추천, 날씨와 시세를 배치하는 TV용 홈 화면입니다. 이 저장소의 학습 가치는 화면을 빠르게 그리는 코드와, 그 화면이 실패해도 TV를 계속 쓸 수 있게 하는 코드가 함께 있다는 데 있습니다.

홈 화면에서 Netflix 같은 앱을 고르면 해당 앱을 실행합니다. 영화 자체를 전송하거나 재생하는 서비스는 아닙니다. 작품 정보는 TMDB에서 받고, Android에서는 선택적으로 Watchmode의 링크를 이용해 작품 페이지를 엽니다. 시청에는 각 스트리밍 앱과 해당 서비스의 이용 조건이 그대로 적용됩니다.

1-1. 같은 이름, 서로 다른 설치 방식

Android 앱은 app/AndroidManifest.xml에서 HomeActivity를 HOME으로, SettingsActivity를 일반 앱 목록의 진입점으로 선언합니다. LG·Samsung의 앱 실행 기능은 web/tv.js가 각 운영체제의 API에 연결합니다.

1-2. 처음 읽을 때 잡아 둘 질문 세 가지

1. 무엇을 그릴까? HomeView는 현재 선택 위치, 작품 목록, 날씨를 화면으로 바꿉니다.
2. 언제 다시 그릴까? 데이터가 바뀌거나 애니메이션이 움직일 때 필요한 레이어를 갱신합니다.
3. 실패하면 어디로 갈까? HomeMode와 Watchdog가 원래 화면으로 가는 경로를 관리합니다.

2왜 주목받는가

2-1. 사용자가 바로 이해할 수 있는 문제를 푼다

README는 광고성 추천 행, 광고 배너, 자동 재생 홍보가 없는 홈 화면을 약속합니다. 앱 선반을 직접 편집하고, 추천은 설치된 스트리밍 앱에 맞추며, 낮과 밤에 따라 색을 바꿉니다. 기능 설명을 읽기 전에 “TV 첫 화면을 내 취향으로 정리한다”는 목적을 이해할 수 있습니다.

다만 “광고 없음”의 범위는 이 홈 화면입니다. 실행한 외부 앱의 광고나 TV 펌웨어 전체의 통신을 없애는 기능으로 확대 해석하면 안 됩니다. 소스의 HomeMode.DEBLOAT도 알려진 패키지 목록과 보호 조건을 이용합니다.

2-2. 만들어진 지 나흘 만에 수천 개의 별

저장소 소개와 README는 Claude Code로 만들었다고 밝힙니다. AGENTS.md와 CLAUDE.md에는 설치 안내, 기기별 예외, 복구 원칙이 적혀 있습니다. AI 도구로 만든 결과물을 실제 하드웨어 제약과 연결한 사례라는 점이 관심을 끌 만합니다. 다만 이것은 제품과 소스에서 읽어 낸 해석이며, 스타 증가 원인을 검증한 조사 결과는 아닙니다.

2-3. Projectivy와 비교하면 장점의 위치가 보인다

대체 런처 자체는 새로운 발명이 아닙니다. Projectivy도 광고 없는 화면, 카테고리·채널 구성, 배경화면과 플러그인, 기본 런처 대체 기능을 소개합니다. 비교 기준은 Projectivy 공식 README입니다.

free-my-tv의 차별점은 광고 없는 화면이라는 약속에 더해, 그 화면과 전환·복구 과정을 소스 수준에서 함께 공부할 수 있다는 점입니다. 이 비교표는 각 앱의 소개와 구현을 바탕으로 하며, 같은 TV에서 성능이나 호환성의 우열을 검증한 결과는 아닙니다.

2-4. 성능 수치는 조건까지 읽는다

README는 Android 14를 쓰는 98인치 TCL TV에서 홈 화면 메모리 96 MB 대 242 MB, 약 60% 감소와 60 fps를 제시합니다. 이는 README의 특정 기기 측정 주장입니다. 모든 TV의 실측 결과나 최소 메모리 요구량으로 사용할 수 없습니다.

소스에는 그 주장을 뒷받침할 설계 흔적이 있습니다. HomeView.doFrame()은 바뀐 레이어만 갱신하고, HomeMode.measureMemory()와 measureHomeTime()은 기기에서 측정하는 경로를 갖습니다. 최적화 코드가 있다는 사실과 특정 숫자를 재현했다는 사실은 구분해서 읽으세요.

3기술 스택 전체 지도

이 저장소에는 package.json, build.gradle, Cargo.toml, pyproject.toml, go.mod, Dockerfile이 없습니다. 웹 서비스의 전형적인 프론트엔드·백엔드 구성을 억지로 대입하기보다, 화면·데이터 처리·패키징으로 나눠야 정확합니다.

3-1. 프론트엔드: Android 직접 그리기와 ES5 웹 화면

위 표의 Java 파일은 모두 app/src/io/freemytv/ 아래입니다. JDK 버전, Java 언어 수준, Android 최소 실행 버전은 서로 다른 숫자이며 각각 다른 문제를 결정합니다.

3-2. 백엔드에 해당하는 역할: 앱 내부 데이터 계층

자체 운영 API 서버나 SQL 데이터베이스는 없습니다. HomeData와 Recs가 TV 안에서 외부 API에 직접 요청하고, SharedPreferences와 파일에 결과를 보관합니다. Android JSON 파서는 SDK의 org.json, HTTP 클라이언트는 HttpURLConnection입니다.

“계정·분석 추적 없음”은 README의 개인정보 설명입니다. 네트워크를 전혀 사용하지 않는다는 뜻은 아닙니다. 선택한 기능에 따라 위치 좌표, 작품 정보 요청, 시세 요청이 각 외부 서비스에 전달됩니다.

3-3. 인프라·빌드: Gradle 없이 APK가 만들어지는 순서

build.sh는 SDK 폴더에서 설치된 가장 높은 build-tools와 android.jar를 고릅니다. 반면 CI는 별도 SDK 경로에 지정 버전만 설치합니다. 로컬에서 최신 API를 잘못 호출하면 통과하고 CI에서는 실패할 수 있습니다.

Android 런타임에는 별도 서드파티 라이브러리를 연결하지 않습니다. 그렇다고 프로젝트 전체에 외부 의존성이 없는 것은 아닙니다. Android SDK, 외부 API, CI 도구, Samsung 서명 도구, 폰트와 아이콘 자산에는 각각 별도의 수명과 이용 조건이 있습니다.

4아키텍처 심화 분석

이 도식에서 프로세스 경계는 중요합니다. Prefs의 static 필드는 프로세스마다 따로 존재합니다. HomeData.get() 같은 싱글턴도 기기 전체에 하나라는 뜻이 아니라, 해당 프로세스 안에서 하나입니다.

4-1. 패턴 ① 상태와 렌더링을 나누고, 바뀐 레이어만 갱신한다

app/src/io/freemytv/HomeView.java는 ViewGroup을 상속하며, 내부 Layer extends View가 하늘·작품·버튼·선반·서랍 등을 나눠 그립니다. “Canvas 하나로 모든 화면을 그린다”는 요약보다 여러 사용자 정의 레이어를 직접 그리는 구조가 정확합니다.

onKey()는 방향키를 move()로 보냅니다. 상태가 바뀌면 스프링의 목표값을 조정하고, doFrame()이 위치·속도를 진행시킵니다. Layer.onDraw()는 레이어 종류에 맞는 그리기 함수로 연결합니다.

// HomeView.java — doFrame()의 일부, 원문 발췌
float dt = lastNanos == 0 ? 1 / 60f
    : Math.min(0.05f, (frameTimeNanos - lastNanos) / 1e9f);
lastNanos = frameTimeNanos;

if (tilesMoving || tilesDirty) tiles.invalidate();

// busy는 움직임과 열린 패널 등 현재 상태를 합친 값
if (busy) Choreographer.getInstance().postFrameCallback(this);
else Choreographer.getInstance().postFrameCallbackDelayed(this, 1000);

활동 중에는 프레임 콜백을 이어 받고, 유휴 상태에는 1초 뒤에 다시 확인합니다. “가만히 있으면 아무 코드도 실행하지 않는다”는 뜻은 아닙니다. 시계 같은 변화도 확인해야 하기 때문입니다. Choreographer 공식 문서에서 프레임 타이밍과 콜백의 관계를 더 살펴볼 수 있습니다.

Spring.step()은 한 번의 시간 간격을 최대 약 4 ms 단위로 나눠 적분합니다. 프레임이 늦어졌을 때 물리 계산이 크게 튀는 일을 줄이려는 장치입니다. HomeView의 서랍 스프링은 new Spring(0.46f, 0.92f, 0)입니다.

// Spring.java — 핵심 계산, 원문 발췌
float omega = (float) (2 * Math.PI / response);
float stiffness = omega * omega, friction = 2 * damping * omega;
int steps = Math.max(1, (int) Math.ceil(dt / 0.004f));
float h = dt / steps;
for (int i = 0; i < steps; i++) {
    float accel = -stiffness * (value - target) - friction * velocity;
    velocity += accel * h;
    value += velocity * h;
}

updateMotion()은 서랍을 여는 동안 이미 그린 레이어의 위치와 투명도를 바꿉니다. 비싼 유리 효과를 매 프레임 다시 만드는 비용을 줄입니다. Recording.create()는 API 29 이상이면 RenderNode, 이전이면 Picture를 선택합니다.

4-2. 패턴 ② 캐시를 먼저 읽고, 비동기로 갱신한 뒤 알린다

HomeData 생성자는 저장된 날씨·시세를 먼저 복원합니다. refreshIfStale()은 유효 기간이 지난 데이터만 단일 작업 스레드에 맡깁니다. notifyListeners()는 메인 스레드로 돌아와 화면의 onData()를 호출합니다.

Recs도 Listener와 별도 실행기를 사용합니다. README의 “매시간 새 추천 세 개”는 매시간 전체 목록을 다운로드한다는 뜻이 아닙니다. now(String kind)는 시간 값을 이용해 세 작품을 고르고, refreshIfStale()은 6시간 경과, 오전·오후·밤의 전환, 언어·키·설치 앱 변화 등으로 목록 재수집을 판단합니다.

fetchList()는 지역의 제공 사업자와 설치된 앱을 맞추고, 주간 인기 작품과 최근 공개 작품을 섞습니다. 설치된 앱을 안다고 유료 구독 여부까지 아는 것은 아닙니다. 기본 탑재 앱을 구독하지 않는 사용자는 hide_services로 추천 대상을 줄일 수 있습니다.

4-3. 패턴 ③ 변경 기록을 남기는 전환과 장애 격리

HomeMode.request()는 ModeJob.schedule()로 작업을 넘깁니다. ModeJob.onStartJob()은 작업 스레드에서 HomeMode.applyNow() 등을 실행하고, 기본 프로세스에서 전환을 진행합니다. 화면 프로세스가 죽어도 별도의 복구 경로를 둘 수 있습니다.

1. applyFree()가 원래 홈·화면보호기를 조사해 home-state.json에 기록합니다.
2. wifiOwners()로 Wi-Fi를 저장한 앱을 확인합니다. 끄려는 앱과 겹치거나 확인이 불가능하면 조건에 따라 중단합니다.
3. 새 HOME과 화면보호기를 지정한 뒤, 보호 목록·TV 입력 기능·기존 비활성 상태를 고려해 끌 앱을 고릅니다.
4. pm disable-user --user 0 성공을 확인할 때마다 disabled 목록을 저장합니다.
5. applyOriginal()은 이 기록과 keptOff를 이용해 원복을 시도합니다.

save()는 임시 파일에 쓰고 FileDescriptor.sync() 후 이름을 바꿉니다. 잘리다 만 JSON을 읽을 가능성을 줄이는 방식입니다. 다만 여러 시스템 명령 전체가 하나의 DB 트랜잭션처럼 원자적으로 처리되는 구조는 아닙니다.

되돌리기 버튼은 반대 명령 하나로 완성되지 않습니다. 변경 전 상태, 실제 성공한 변경, 복원 순서를 함께 기억해야 합니다.

targets()는 Google TV 초기 설정 앱을 원래 런처보다 앞에 둡니다. 복원 시에는 원래 런처를 먼저 살립니다. 코드 주석은 설정 앱의 복구 화면이 HOME을 가져가는 기기 문제를 설명합니다. Build.DEVICE가 R3_GTV이면 전환을 거부하는 방어 조건도 있습니다.

4-4. 패턴 ④ 공통 화면과 플랫폼 어댑터를 분리한다

web/tv.js는 TV.apps(), launch(), inputs(), settings(), back() 같은 공통 인터페이스를 제공합니다. LG에서는 Luna 서비스, Samsung에서는 tizen.application 등을 호출합니다. web/home.js는 운영체제별 세부 API를 매번 알 필요가 줄어듭니다.

// web/tv.js — launch() 내부 분기, 원문 발췌
if (samsung) {
    if (id.indexOf('source:') === 0) samsungSource(id, done);
    else samsungLaunch(id, done);
    return;
}
if (!webos) {
    if (done) setTimeout(function () { done(true); }, 0);
    return;
}
luna('luna://com.webos.applicationManager/launch',
    params ? {id: id, params: params} : {id: id}, function (res) {
        if (done) done(!!res);
    });

일반 브라우저 분기는 실제 TV 앱을 실행하는 대신 성공 콜백을 돌려주는 모의 동작입니다. 웹 화면이 브라우저에 잘 보인다는 사실만으로 HDMI 전환이나 TV 앱 실행까지 검증되는 것은 아닙니다.

공유 범위에도 경계가 있습니다. Android의 HomeView.java와 웹의 home.js는 별도 구현입니다. Python의 tools/webapp.py가 공유하는 것은 설정·번역·폰트·기호와 LG·Samsung 웹 파일입니다. 화면 로직까지 한 번 작성해 세 플랫폼에서 그대로 실행하는 구조는 아닙니다.

5디렉토리 구조 해부

저장소는 Android 앱, 공유 웹 앱, 플랫폼별 포장 도구, 소개 사이트로 나뉩니다. 같은 이름의 build.py가 두 개 있지만, 만드는 패키지 형식과 서명 절차가 다릅니다. 루트 기준 주요 구조는 다음과 같습니다.

5-1. 줄 수가 알려 주는 무게 중심

공백과 주석을 포함한 텍스트 줄 수입니다. 생성 결과와 Git 내부 데이터는 제외했습니다. 한 줄에 많은 데이터가 든 파일도 있어 줄 수를 기능 복잡도나 개발 시간으로 그대로 환산할 수는 없습니다.

5-2. 초보자에게 권하는 읽기 순서

1. Spring.java 41줄: 입력·상태·계산·종료 조건을 한 번에 이해합니다.
2. HomeActivity.java 80줄: 화면이 언제 생기고 멈추는지 봅니다.
3. HomeData.java 452줄: HTTP 요청과 캐시·Listener를 연결합니다.
4. HomeView.onData() → doFrame() → Layer.onDraw(): 큰 파일을 호출 경로로 나눕니다.
5. ModeJob.java 58줄 → Watchdog.java 84줄 → HomeMode: 복구 흐름을 따라갑니다.
6. web/tv.js → tools/webapp.py: 운영체제 연결과 패키징의 차이를 봅니다.

6학습 포인트 (기술별)

각 기술을 따로 외우기보다 사용자 입력이 상태를 바꾸고, 상태 변화가 저장·통신·화면 갱신으로 이어지는 연결을 설명해 보세요.

6-1. Java: 작은 상태 객체로 동작을 모델링하기

Spring은 value, velocity, target 세 상태를 가집니다. snap()은 즉시 이동하면서 속도를 0으로 만들고, step()은 시간에 따라 조금씩 이동합니다. settled()는 거리와 속도가 충분히 작을 때 종료를 결정합니다.

미니 실습: 종이에 초기값 0, 목표값 1을 놓고 response와 damping이 각각 어떤 경험을 바꿀지 예상해 보세요. 목표만 바꾸는 것과 snap()의 차이를 표로 적으면 좋습니다.

6-2. Android: 생명주기와 작업의 수명을 맞추기

HomeActivity.onResume()은 home.resume()으로 연결되고, onPause()는 home.pause()로 연결됩니다. 화면이 사라질 때 Listener·콜백·TV 입력 콜백을 해제하는 코드를 짝으로 찾으세요.

미니 실습: resume()의 등록 작업과 pause()의 해제 작업을 두 열에 적습니다. 해제가 없을 때 오래된 화면을 붙잡거나 불필요한 알림을 받을 수 있는 부분을 설명해 보세요. 이미 시작된 네트워크 작업을 모두 취소하는 것과 Listener 제거도 서로 다른 동작입니다.

6-3. 그래픽: 픽셀을 다시 계산하는 비용과 합성 비용 구별하기

Layer.onDraw()는 직접 그리기를 맡고, updateMotion()은 레이어의 위치·투명도 등을 바꿉니다. Scene은 배경을 축소해 그리는 경로를 두고, Frost는 48×27 픽셀의 작은 이미지를 만듭니다. 작은 이미지를 확대·보간해 흐린 유리 배경에 활용하는 방식입니다.

미니 실습: 서랍을 10픽셀 옮길 때 글자와 배경을 다시 그려야 하는지, 이미 그린 결과를 이동해도 되는지 나눠 보세요. Android 직접 그리기 문서의 Canvas와 Paint 역할을 이 코드에 대응시키면 좋습니다.

6-4. 동시성: 백그라운드 작업과 UI 통지 구분하기

HomeData는 단일 ExecutorService로 I/O를 처리하고, Handler(Looper.getMainLooper())로 UI에 결과를 알립니다. volatile은 스레드 사이에서 값의 변경을 보이게 하는 도구지만, 여러 필드의 변경 전체를 원자적으로 묶어 주지는 않습니다.

미니 실습: 시세와 날씨 요청이 같은 단일 실행기를 쓰면 한쪽의 지연이 다른 쪽에 어떤 영향을 주는지 타임라인을 그려 보세요. 무조건 스레드를 늘리기 전에 순서·중복·서버 부하를 함께 따져 봅니다.

6-5. 국제화: 문장을 이어 붙이지 않고 패턴을 번역하기

Ui.tr()는 영어 키에 대응하는 번역을 찾고, trf()는 이름 있는 자리표시자를 채웁니다. Ui.plural()은 ICU가 고른 복수형 범주를 이용합니다. 한국어에는 하나로 보이는 형태가 다른 언어에서는 수에 따라 여러 개 필요할 수 있습니다.

// Ui.java의 사용 규칙을 보여 주는 호출 예시
Ui.trf("{n} min ago", "n", 12);
Ui.plural("plural|one:{n} season|other:{n} seasons", 3);

// 번역은 문장 순서를 바꿀 수 있어도 {n}은 보존해야 합니다.
// 언어 변경 시 Ui.generation이 증가하여 화면의 글자 캐시를 갱신합니다.

미니 실습: app/assets/i18n/ko.json과 en.json에서 같은 키를 찾아 비교합니다. tools/translate.py의 PLACEHOLDER와 check()가 왜 필요한지 설명해 보세요. 공유 웹 앱은 tools/webapp.py가 실제 사용하는 번역 키만 묶습니다.

6-6. 시스템 프로그래밍: 소켓 위의 메시지를 이해하기

Adb.connect()는 TV 자신의 127.0.0.1:5555에 접속합니다. CNXN·AUTH로 연결과 인증을 진행하고, shell()은 OPEN·WRTE·OKAY·CLSE 메시지를 처리합니다.

미니 실습: Adb.read()가 읽는 24바이트 헤더를 필드별로 분해해 적습니다. “문자열 명령을 보낸다” 아래에 길이·바이트 순서·인증·종료 신호가 있다는 점을 찾는 것이 목표입니다. 명령을 실제 TV로 보내지 않아도 프로토콜 구조는 공부할 수 있습니다.

6-7. 접근성과 구형 웹: 편리한 기본 기능이 없는 환경 다루기

Canvas로 그린 버튼은 화면 낭독기가 자동으로 의미를 알기 어렵습니다. Spoken extends AccessibilityNodeProvider는 가상 항목의 설명·경계·동작을 제공합니다. 리모컨 버튼을 가로채는 RemoteKeyService와는 목적이 다른 코드입니다.

웹 쪽은 오래된 TV를 위해 ES5 문법과 콜백·XMLHttpRequest를 사용합니다. tools/check.sh는 구문 검사 외에 fetch, Promise, Array.from 등 구형 환경에 없는 호출도 찾습니다. 구문이 해석된다고 API가 존재하는 것은 아닙니다.

미니 실습: 화려한 새 문법 하나를 도입할 때 “파싱 가능 여부”와 “런타임 기능 존재 여부”를 별도로 적습니다. 사용자 정의 버튼에는 시각적 포커스뿐 아니라 낭독 이름과 클릭 동작도 함께 정의해 보세요.

7하드웨어 / 시스템 요구사항

최소 Android 버전을 충족해도 GPU, 메모리, 제조사 서비스, 디버깅 방식에 따라 동작과 복구 가능성이 달라집니다.

7-1. OS 버전별로 같은 효과를 다른 방식으로 그린다

• Ui.LEGACY는 API 31 미만, 즉 Android 8~11에서 비용이 낮은 그리기 경로를 선택합니다.
• Recording.create()는 Android 10 이상에서 RenderNode, 그 이전에는 Picture를 씁니다.
• Scene은 RuntimeShader 생성 실패를 잡고 그라데이션·반투명 표현으로 대체합니다. 공식 API 문서상 이 기능은 API 33에 추가됐습니다.
• Android 11은 ScreensaverAlone을 기본 프로세스에서 실행하도록 app/res/values-v30/bools.xml에서 분기합니다. 다른 버전의 화면보호기는 :home 경로입니다.

성능을 생각할 때는 패널의 “4K” 표기와 실제 UI 렌더링 해상도를 구분하세요. HomeView.onMeasure()는 너비를 1920 기준으로 환산하며, Backdrop는 UI 크기를 고려해 이미지 크기를 결정합니다.

7-2. Android 전환은 일반 앱 권한만으로 이루어지지 않는다

Adb.java는 디버깅이 허용된 TV의 로컬 ADB를 이용합니다. 연결 시 사용자 키 승인이 필요할 수 있고, 무선 디버깅의 TLS 요청을 받으면 USB 디버깅 방식을 안내하며 중단합니다. “루트 불필요”와 “권한 승인 불필요”를 같은 뜻으로 읽으면 안 됩니다.

제조사 개발자 모드 조건은 변할 수 있습니다. 기기 설치를 계획할 때는 LG 공식 개발자 모드 문서와 Samsung 공식 TV 연결 문서를 확인하세요.

8직접 해볼 수 있는 실습 과제

다음 과제는 기기 변경 없이 시작할 수 있습니다. 첫 두 과제는 텍스트만 읽어도 완성할 수 있고, 이후 과제는 별도 학습용 사본에서 구현하는 확장 과제입니다. 과제를 끝냈다는 기준을 “코드를 바꿨다”가 아니라 “입력·실패 조건·예상 결과를 설명할 수 있다”로 정하세요.

9관련 기술 심화 학습 로드맵

처음부터 ADB 인증이나 셰이더 수식을 전부 이해할 필요는 없습니다. 값 하나가 화면으로 가는 경로를 익힌 뒤, 수명·성능·실패·플랫폼 차이를 차례로 추가합니다. 일정은 학습 계획의 예시이며 공식 교육 과정이나 숙련 시간을 보장하는 기준은 아닙니다.

로드맵의 마지막 목표는 기능을 하나 더 넣는 것보다, 그 기능이 느려지거나 실패했을 때의 동작까지 설계하는 것입니다.

9-1. 이해가 막히면 내려갈 기초

• Java가 어렵다면: 필드·생성자·인터페이스·예외·람다부터 익힙니다. Spring과 Listener가 작은 예제입니다.
• Android가 어렵다면: Activity, Intent, Service, BroadcastReceiver의 역할을 HomeActivity·ModeJob·HomeReceiver에 하나씩 대응시킵니다.
• 동시성이 어렵다면: 작업 스레드와 UI 스레드 두 줄만 그려 요청·응답·통지 시점을 표시합니다.
• 그래픽이 어렵다면: Canvas를 도화지, Paint를 붓 설정으로 생각한 뒤, 좌표 변환·그리기 결과 저장·합성 순서로 넘어갑니다.
• 프로토콜이 어렵다면: 소켓, 고정 길이 헤더, 페이로드 길이, little-endian을 먼저 공부합니다.

9-2. 이미 경험이 있다면 깊게 볼 갈림길

10핵심 키워드 사전

11참고 링크

11-1. 저장소와 분석 기준

• free-my-tv 공식 저장소 — 설치 안내, 이슈, 변경 내역의 출발점
• 커밋 4d73951의 파일 목록 — 이 글의 코드 기준
• 해당 커밋의 README — 기능·지원 범위·성능 주장·개인정보 설명
• v1.1.0 릴리스 — 2026-10-22 배포 정보
• HomeView.java — 직접 그리는 화면과 리모컨 입력
• HomeMode.java — 전환·보호 조건·복원 순서
• HomeData.java — 캐시·시간 처리·시세 예외
• 앱 검사 CI — JDK·SDK 버전과 검사 작업
• TrendShift — 저장소 관심 흐름을 탐색하는 서비스

11-2. 관련 기술의 공식 문서

• Android 사용자 정의 그리기 — Canvas와 Paint의 책임
• Choreographer API — 프레임 콜백과 타이밍
• RuntimeShader API — AGSL과 API 수준
• Android SDK 버전 선언 — minSdk와 targetSdk의 차이
• AOSP ADB 프로토콜 — 연결·메시지·스트림의 원리
• LG Developer Mode — 개발용 앱 설치와 세션 관리
• Samsung TV 기기 연결 — 개발자 모드와 연결 환경
• TMDB 개발자 문서 — 작품 메타데이터와 인증
• Open-Meteo 문서 — 날씨 변수·좌표·시간대
• Watchmode API 문서 — 스트리밍 제공처와 작품 링크
• Projectivy 공식 소개 — 다른 TV 런처가 해결하는 문제 비교

11-3. 현재 상태 (2026-10-23 확인)

스타·포크·생성일·push·릴리스는 2026-10-23 GitHub 기준이며, 파일·줄 수·함수 동작은 커밋 4d73951 기준입니다. 이후 변경 사항과 전체 커밋 수를 이 수치에서 추정하지 않습니다.