Repolode
corvofeng

corvofeng/atv-core

Позволяет управлять Android TV / Google TV и Mac по локальной сети с помощью встроенного в iPhone пульта Apple TV Remote в Пункте управления.

Звёзды
382
Форки
19
Открытые issues
6
Последний коммит
12 дней назад

Что это?

atv-core — это приёмник, благодаря которому устройства Android TV, Google TV и macOS отображаются как Apple TV и доступны для нативного Apple TV Remote на iPhone или iPad. Пользователь открывает Пункт управления, выбирает устройство, вводит PIN-код 1111 и затем использует тачпад для свайпов и перемещения курсора, а кнопки — для выбора, возврата, управления воспроизведением и громкостью. Устанавливать приложение на телефон не нужно.

На Android TV проект отправляет коды клавиш D-pad и мультимедиа через локальное ADB-подключение (dadb к 127.0.0.1:5555); запасной вариант для глобальных действий Back и Home — Accessibility Service. На macOS приложение работает в строке меню и как CLI, используя Accessibility API для управления курсором и нажатий клавиш. Сборки для Windows запускаются из системного трея и включают локальную веб-консоль для режима тачпада и настройки чувствительности.

Кроме того, в проект входят веб-инспектор на порту 8765, диагностика на порту 8766 и скрипт-мост для тестирования с эмулятором Android TV. Контроллер и устройство должны находиться в одной локальной сети. Приложение для macOS подписано самостоятельно, поэтому для Gatekeeper потребуется один раз обойти проверку.

Ключевые возможности

  • 01Использует нативный Apple TV Remote в Пункте управления на iPhone — приложение на телефон не требуется.
  • 02Управляет Android TV и Google TV, отправляя коды клавиш через локальный ADB; предусмотрен запасной вариант с Accessibility.
  • 03Предоставляет приложение для строки меню macOS и CLI с плавным управлением курсором и мультимедийными клавишами.
  • 04Включает сборку для системного трея Windows с локальной веб-консолью для настройки тачпада.
  • 05Содержит веб-инспектор и страницы диагностики для отладки сенсорных жестов и сеансов протокола.

Сценарии использования

  • Управление приставкой Android TV или Google TV с iPhone без покупки отдельного пульта.
  • Управление воспроизведением медиа или курсором на Mac с дивана с помощью пульта на iPhone.
  • Тестирование взаимодействия по протоколу Apple TV Remote с эмулятором Android TV в Android Studio.

Быстрый старт

  1. 1

    Установите DMG (Mac) или APK (Android TV) из раздела загрузок

  2. 2

    Подключите iPhone и целевое устройство к одной сети Wi-Fi и отключите изоляцию точек доступа

  3. 3

    Предоставьте необходимые разрешения: «Универсальный доступ» в macOS; на Android TV включите сетевой ADB и подтвердите запрос «Всегда разрешать»

  4. 4

    На iPhone откройте Пункт управления, нажмите значок Apple TV Remote, выберите целевое устройство и введите PIN-код 1111

Что важно знать

  • На Android TV необходимо включить сетевой ADB и подтвердить запрос RSA на телевизоре.
  • Приложение для macOS подписано собственной подписью, поэтому при первом запуске Gatekeeper покажет предупреждение.
  • Контроллер и целевое устройство должны находиться в одной LAN, а изоляция точек доступа должна быть отключена.
  • В метаданных репозитория лицензия не указана, хотя в README упоминается MIT.

Темы

Частые вопросы

Что такое atv-core?
Позволяет управлять Android TV / Google TV и Mac по локальной сети с помощью встроенного в iPhone пульта Apple TV Remote в Пункте управления. atv-core — это приёмник, благодаря которому устройства Android TV, Google TV и macOS отображаются как Apple TV и доступны для нативного Apple TV Remote на iPhone или iPad. Пользователь открывает Пункт управления, выбирает устройство, вводит PIN-код 1111 и затем использует тачпад для свайпов и перемещения курсора, а кнопки — для выбора, возврата, управления воспроизведением и громкостью. Устанавливать приложение на телефон не нужно.
atv-core можно использовать бесплатно? Какая у него лицензия?
У atv-core не указана лицензия. Код открыт, но без лицензии нет явного разрешения на его использование — уточните у автора, прежде чем на него полагаться.
atv-core всё ещё поддерживается?
Активно поддерживается. Последний коммит в atv-core — 7 окт. 2026 г..
Для чего можно использовать atv-core?
Управление приставкой Android TV или Google TV с iPhone без покупки отдельного пульта. Управление воспроизведением медиа или курсором на Mac с дивана с помощью пульта на iPhone. Тестирование взаимодействия по протоколу Apple TV Remote с эмулятором Android TV в Android Studio.
Как установить atv-core?
Установите DMG (Mac) или APK (Android TV) из раздела загрузок Подключите iPhone и целевое устройство к одной сети Wi-Fi и отключите изоляцию точек доступа Предоставьте необходимые разрешения: «Универсальный доступ» в macOS; на Android TV включите сетевой ADB и подтвердите запрос «Всегда разрешать» На iPhone откройте Пункт управления, нажмите значок Apple TV Remote, выберите целевое устройство и введите PIN-код 1111
Где скачать atv-core?
Исходный код и инструкции по установке — на GitHub: https://github.com/corvofeng/atv-core

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты