Repolode
Enviar
corvofeng

corvofeng/atv-core

Permite controlar dispositivos Android TV / Google TV e Macs pela rede local usando o Apple TV Remote integrado ao Control Center do iPhone.

Ver no GitHub
Estrelas
382
Forks
19
Issues abertas
6
Último commit
há 12 dias

O que é?

atv-core é um receptor que faz dispositivos Android TV, Google TV e macOS aparecerem como alvos Apple TV para o Apple TV Remote nativo de um iPhone ou iPad. O usuário abre o Control Center, escolhe o dispositivo, digita o PIN 1111 e pode usar o touchpad para deslizar e mover o cursor, além dos botões para selecionar, voltar, reproduzir/pausar e ajustar o volume, sem instalar um app no celular.

No Android TV, o projeto envia keycodes de navegação e mídia por uma conexão ADB local (dadb para 127.0.0.1:5555), com um Accessibility Service como alternativa para as ações globais de voltar e início. No macOS, ele funciona como app da barra de menus e CLI, usando a Accessibility API para controlar o cursor e enviar teclas. As versões para Windows são executadas na bandeja do sistema e incluem um console web local para o modo trackpad e o ajuste de sensibilidade.

O projeto também inclui um inspetor web na porta 8765 e diagnósticos na porta 8766, além de um script de bridge para testes com um emulador Android TV. O controle e o dispositivo de destino precisam estar na mesma LAN. Como o app para macOS é autoassinado, é necessário contornar o Gatekeeper uma vez.

Recursos principais

  • 01Usa o Apple TV Remote nativo do Control Center do iPhone, sem precisar de um app no celular.
  • 02Controla Android TV e Google TV por meio do envio local de teclas via ADB, com Accessibility como alternativa.
  • 03Oferece um app para a barra de menus do macOS e uma CLI, com controle fluido do cursor e teclas de mídia.
  • 04Disponibiliza uma versão para a bandeja do sistema do Windows, com um console web local para configurar o trackpad.
  • 05Inclui páginas de inspeção web e diagnóstico para depurar gestos de toque e sessões do protocolo.

Casos de uso

  • Controlar um dispositivo Android TV ou Google TV pelo iPhone, sem comprar um controle remoto dedicado.
  • Controlar a reprodução de mídia ou o cursor de um Mac do sofá, usando o controle remoto do iPhone.
  • Testar interações com o protocolo Apple TV Remote em um emulador Android TV no Android Studio.

Início rápido

  1. 1

    Instale o DMG (Mac) ou o APK (Android TV) na seção de downloads

  2. 2

    Conecte o iPhone e o dispositivo de destino à mesma rede Wi-Fi e desative o isolamento de AP

  3. 3

    Conceda as permissões: Acessibilidade no macOS; no Android TV, ative o ADB pela rede e aceite a solicitação “Sempre permitir”

  4. 4

    No iPhone, abra a Central de Controle, toque no ícone do Apple TV Remote, selecione o dispositivo de destino e digite o PIN 1111

Antes de usar

  • No Android TV, é necessário ativar o ADB pela rede e aprovar uma solicitação RSA na TV.
  • O app para macOS é autoassinado, então o Gatekeeper exibe um aviso na primeira inicialização.
  • O controlador e o dispositivo de destino devem estar na mesma LAN, com o isolamento de AP desativado.
  • Os metadados do repositório não informam uma licença, embora o README mencione MIT.

Tópicos

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

Perguntas frequentes

O que é atv-core?
Permite controlar dispositivos Android TV / Google TV e Macs pela rede local usando o Apple TV Remote integrado ao Control Center do iPhone. atv-core é um receptor que faz dispositivos Android TV, Google TV e macOS aparecerem como alvos Apple TV para o Apple TV Remote nativo de um iPhone ou iPad. O usuário abre o Control Center, escolhe o dispositivo, digita o PIN 1111 e pode usar o touchpad para deslizar e mover o cursor, além dos botões para selecionar, voltar, reproduzir/pausar e ajustar o volume, sem instalar um app no celular.
atv-core é gratuito? Qual é a licença?
atv-core não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
atv-core ainda é mantido?
Manutenção ativa. O último commit de atv-core foi em 7 de out. de 2026.
Para que posso usar atv-core?
Controlar um dispositivo Android TV ou Google TV pelo iPhone, sem comprar um controle remoto dedicado. Controlar a reprodução de mídia ou o cursor de um Mac do sofá, usando o controle remoto do iPhone. Testar interações com o protocolo Apple TV Remote em um emulador Android TV no Android Studio.
Como instalar atv-core?
Instale o DMG (Mac) ou o APK (Android TV) na seção de downloads Conecte o iPhone e o dispositivo de destino à mesma rede Wi-Fi e desative o isolamento de AP Conceda as permissões: Acessibilidade no macOS; no Android TV, ative o ADB pela rede e aceite a solicitação “Sempre permitir” No iPhone, abra a Central de Controle, toque no ícone do Apple TV Remote, selecione o dispositivo de destino e digite o PIN 1111
Onde consigo atv-core?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/corvofeng/atv-core

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados