Repolode
제출하기
simbasjungles

simbasjungles/free-my-tv

Google TV와 Android TV용 오픈소스 광고 없는 홈 화면 대체 앱으로, 설치한 앱의 인기 콘텐츠와 날씨, 암호화폐 시세를 보여줍니다.

GitHub에서 보기웹사이트
스타
1,020
포크
112
열린 이슈
6
마지막 커밋
6시간 전

어떤 프로젝트인가요?

Free My TV는 Google TV와 Android TV 기기의 기본 홈 화면과 화면 보호기를 스폰서 행, 배너, 자동 재생 프로모션이 없는 런처로 대체합니다. 선반에는 사용자가 선택한 스트리밍 앱이 표시되며, TV에서 원하는 순서로 정렬할 수 있습니다. 인기 콘텐츠는 이미 설치된 앱에서 이용할 수 있는 작품만 가져옵니다. 영화와 TV 프로그램은 각각 별도의 탭으로 제공되며, 드로어에서는 시간대별 예보와 일출·일몰 시간, 선택 사항인 Binance 암호화폐 시세를 확인할 수 있습니다.

이 앱은 Java로 작성된 순수 Android 프로젝트로, Gradle이나 서드파티 라이브러리를 사용하지 않습니다. 셸 스크립트가 aapt2, javac, d8, zipalign, apksigner를 실행해 APK를 빌드합니다. 설치할 때는 TV 자체의 ADB를 사용하고, 기기에서 생성한 키로 로컬 루프백 주소에 연결한 뒤 홈 액티비티 지정이나 패키지 비활성화 같은 표준 명령을 실행합니다. 비활성화된 앱은 삭제되지 않으며, 반복적으로 충돌하면 감시 프로세스가 기본 홈 화면을 복구합니다.

설정은 config.properties 파일이나 TV의 설정 메뉴에서 할 수 있으며, 프로젝트는 Claude Code에 요청해 수정하도록 설계되어 있습니다. 인기 콘텐츠를 가져오려면 무료 TMDB API 키가 필요하고, 날씨 정보는 Open-Meteo에서 가져옵니다.

핵심 기능

  • 01광고나 스폰서 콘텐츠가 없는 홈 화면 및 화면 보호기 대체 기능.
  • 02사용자가 선택하고 TV에서 순서를 정하는 스트리밍 앱 선반.
  • 03설치된 앱에서 가져오는 시간별 인기 콘텐츠와 영화·TV 프로그램 탭.
  • 04드로어에서 확인하는 날씨, 일출·일몰 시간, 선택 가능한 암호화폐 시세.
  • 05현지 일몰 시간에 맞춰 전환되는 낮·밤 테마.
  • 06앱을 삭제하지 않고 한 단계로 기본 홈 화면으로 되돌리는 기능.

활용 사례

  • Google TV 또는 Android TV 홈 화면에서 프로모션 행과 자동 재생 광고를 없애기.
  • 자주 쓰는 스트리밍 앱을 한곳의 눈에 잘 띄는 선반에 모아두기.
  • AI 어시스턴트를 사용해 앱 목록을 조정하여 공식 지원 목록에 없는 TV 브랜드에서 Google TV 스트리머 사용하기.
  • Java로 작성된 작고 의존성이 없는 Android 런처 살펴보기.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/simbasjungles/free-my-tv && cd free-my-tv
  2. 2

    Mac에 Android 빌드 도구를 설치합니다

    brew install --cask temurin android-commandlinetools android-platform-tools
  3. 3

    Android SDK 플랫폼과 build-tools를 설치합니다

    sdkmanager "build-tools;34.0.0" "platforms;android-34"
  4. 4

    APK를 빌드합니다(config.properties에서 도시와 TMDB 키를 설정한 다음 다시 실행하세요)

    ./build.sh

사용 전 알아둘 점

  • TV에서 개발자 모드와 USB 디버깅을 사용 설정해야 합니다.
  • 인기 콘텐츠를 표시하려면 무료 TMDB API 키가 필요합니다.
  • 수동 설치를 하려면 컴퓨터에 JDK, Android SDK, adb가 필요합니다. Windows 사용자는 WSL도 필요합니다.

토픽

#android-tv#google-tv#launcher#home-screen#no-ads#java#adb#claude-code#open-source#tmdb

자주 묻는 질문

free-my-tv은(는) 무엇인가요?
Google TV와 Android TV용 오픈소스 광고 없는 홈 화면 대체 앱으로, 설치한 앱의 인기 콘텐츠와 날씨, 암호화폐 시세를 보여줍니다. Free My TV는 Google TV와 Android TV 기기의 기본 홈 화면과 화면 보호기를 스폰서 행, 배너, 자동 재생 프로모션이 없는 런처로 대체합니다. 선반에는 사용자가 선택한 스트리밍 앱이 표시되며, TV에서 원하는 순서로 정렬할 수 있습니다. 인기 콘텐츠는 이미 설치된 앱에서 이용할 수 있는 작품만 가져옵니다. 영화와 TV 프로그램은 각각 별도의 탭으로 제공되며, 드로어에서는 시간대별 예보와 일출·일몰 시간, 선택 사항인 Binance 암호화폐 시세를 확인할 수 있습니다.
free-my-tv은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
free-my-tv은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
free-my-tv은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. free-my-tv의 마지막 커밋은 2026년 10월 20일입니다.
free-my-tv은(는) 어디에 사용할 수 있나요?
Google TV 또는 Android TV 홈 화면에서 프로모션 행과 자동 재생 광고를 없애기. 자주 쓰는 스트리밍 앱을 한곳의 눈에 잘 띄는 선반에 모아두기. AI 어시스턴트를 사용해 앱 목록을 조정하여 공식 지원 목록에 없는 TV 브랜드에서 Google TV 스트리머 사용하기. Java로 작성된 작고 의존성이 없는 Android 런처 살펴보기.
free-my-tv는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/simbasjungles/free-my-tv && cd free-my-tv Mac에 Android 빌드 도구를 설치합니다: brew install --cask temurin android-commandlinetools android-platform-tools Android SDK 플랫폼과 build-tools를 설치합니다: sdkmanager "build-tools;34.0.0" "platforms;android-34" APK를 빌드합니다(config.properties에서 도시와 TMDB 키를 설정한 다음 다시 실행하세요): ./build.sh
free-my-tv은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/simbasjungles/free-my-tv

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트