Repolode
제출하기
corvofeng

corvofeng/atv-core

iPhone 제어 센터의 Apple TV Remote로 로컬 네트워크에서 Android TV, Google TV, Mac을 제어합니다.

GitHub에서 보기
스타
382
포크
19
열린 이슈
6
마지막 커밋
13일 전

어떤 프로젝트인가요?

atv-core는 Android TV, Google TV, macOS 기기를 Apple TV 대상으로 표시해 iPhone이나 iPad의 기본 Apple TV Remote로 제어할 수 있게 해주는 수신기입니다. 제어 센터를 열어 기기를 선택하고 PIN 1111을 입력하면, 휴대폰에 앱을 설치하지 않아도 터치패드로 스와이프하거나 커서를 움직이고 버튼으로 선택, 뒤로 가기, 재생/일시 정지, 볼륨 조절을 할 수 있습니다.

Android TV에서는 로컬 ADB 연결(dadb to 127.0.0.1:5555)을 통해 D-pad 및 미디어 키코드를 주입하고, 전역 뒤로 가기 및 홈 동작은 Accessibility Service를 대체 수단으로 사용합니다. macOS에서는 메뉴 막대 앱과 CLI로 실행되며, 커서 이동과 키 입력에 Accessibility API를 사용합니다. Windows 빌드는 시스템 트레이에서 실행되며 트랙패드 모드와 감도를 설정하는 로컬 웹 콘솔을 제공합니다.

이 프로젝트에는 포트 8765의 웹 인스펙터와 포트 8766의 진단 페이지, Android TV 에뮬레이터에서 테스트하기 위한 브리지 스크립트도 포함되어 있습니다. 컨트롤러와 대상 기기는 같은 LAN에 연결되어야 하며 macOS 앱은 자체 서명되어 있어 Gatekeeper를 한 번 우회해야 합니다.

핵심 기능

  • 01iPhone 제어 센터의 기본 Apple TV Remote를 사용하므로 휴대폰에 앱을 설치할 필요가 없습니다.
  • 02로컬 ADB 키 주입으로 Android TV와 Google TV를 제어하며, Accessibility를 대체 수단으로 제공합니다.
  • 03부드러운 커서 제어와 미디어 키를 지원하는 macOS 메뉴 막대 앱과 CLI를 제공합니다.
  • 04트랙패드 설정용 로컬 웹 콘솔이 포함된 Windows 시스템 트레이 빌드를 제공합니다.
  • 05터치 제스처와 프로토콜 세션 디버깅을 위한 웹 인스펙터 및 진단 페이지를 포함합니다.

활용 사례

  • 전용 리모컨을 구매하지 않고 iPhone으로 Android TV 또는 Google TV 셋톱박스를 제어합니다.
  • 소파에서 iPhone 리모컨으로 Mac의 미디어 재생이나 커서를 조작합니다.
  • Android Studio의 Android TV 에뮬레이터에서 Apple TV Remote 프로토콜 상호작용을 테스트합니다.

빠른 시작

  1. 1

    다운로드 섹션에서 DMG(Mac) 또는 APK(Android TV)를 설치합니다

  2. 2

    iPhone과 대상 기기를 같은 Wi-Fi에 연결하고 AP 격리를 끕니다

  3. 3

    권한을 부여합니다. macOS에서는 손쉬운 사용 권한을, Android TV에서는 네트워크 ADB를 활성화하고 '항상 허용' 메시지에 응답합니다

  4. 4

    iPhone에서 제어 센터를 열고 Apple TV Remote 아이콘을 탭한 다음 대상을 선택하고 PIN 1111을 입력합니다

사용 전 알아둘 점

  • Android TV에서는 네트워크 ADB를 활성화하고 TV에 표시되는 RSA 확인 메시지를 승인해야 합니다.
  • macOS 앱은 자체 서명되어 있어 처음 실행할 때 Gatekeeper 경고가 표시됩니다.
  • 컨트롤러와 대상 기기는 AP 격리가 비활성화된 같은 LAN에 있어야 합니다.
  • 저장소 메타데이터에는 라이선스가 표시되어 있지 않지만 README에는 MIT라고 적혀 있습니다.

토픽

#apple-tv#android-tv#remote-control#adb#macos#rust#companion-link

자주 묻는 질문

atv-core은(는) 무엇인가요?
iPhone 제어 센터의 Apple TV Remote로 로컬 네트워크에서 Android TV, Google TV, Mac을 제어합니다. atv-core는 Android TV, Google TV, macOS 기기를 Apple TV 대상으로 표시해 iPhone이나 iPad의 기본 Apple TV Remote로 제어할 수 있게 해주는 수신기입니다. 제어 센터를 열어 기기를 선택하고 PIN 1111을 입력하면, 휴대폰에 앱을 설치하지 않아도 터치패드로 스와이프하거나 커서를 움직이고 버튼으로 선택, 뒤로 가기, 재생/일시 정지, 볼륨 조절을 할 수 있습니다.
atv-core은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
atv-core에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
atv-core은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. atv-core의 마지막 커밋은 2026년 10월 7일입니다.
atv-core은(는) 어디에 사용할 수 있나요?
전용 리모컨을 구매하지 않고 iPhone으로 Android TV 또는 Google TV 셋톱박스를 제어합니다. 소파에서 iPhone 리모컨으로 Mac의 미디어 재생이나 커서를 조작합니다. Android Studio의 Android TV 에뮬레이터에서 Apple TV Remote 프로토콜 상호작용을 테스트합니다.
atv-core는 어떻게 설치하나요?
다운로드 섹션에서 DMG(Mac) 또는 APK(Android TV)를 설치합니다 iPhone과 대상 기기를 같은 Wi-Fi에 연결하고 AP 격리를 끕니다 권한을 부여합니다. macOS에서는 손쉬운 사용 권한을, Android TV에서는 네트워크 ADB를 활성화하고 '항상 허용' 메시지에 응답합니다 iPhone에서 제어 센터를 열고 Apple TV Remote 아이콘을 탭한 다음 대상을 선택하고 PIN 1111을 입력합니다
atv-core은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/corvofeng/atv-core

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

관련 프로젝트