Repolode
Enviar
corvofeng

corvofeng/atv-core

Permite controlar dispositivos Android TV / Google TV y Mac por la red local con el Apple TV Remote integrado en el Centro de control del iPhone.

Ver en GitHub
Estrellas
382
Forks
19
Issues abiertos
6
Último commit
hace 13 días

¿Qué es?

atv-core es un receptor que hace que los equipos con Android TV, Google TV y macOS aparezcan como destinos de Apple TV para el Apple TV Remote nativo de un iPhone o iPad. Los usuarios abren el Centro de control, seleccionan el dispositivo, ingresan el PIN 1111 y pueden usar el panel táctil para deslizar y mover el cursor, y los botones para seleccionar, volver, reproducir o pausar y ajustar el volumen, sin instalar una app en el teléfono.

En Android TV, el proyecto inyecta códigos de tecla del D-pad y multimedia mediante una conexión ADB local (dadb a 127.0.0.1:5555), con un Accessibility Service como alternativa para las acciones globales de volver e inicio. En macOS, funciona como una app de la barra de menús y una CLI, y usa la Accessibility API para controlar el cursor y las pulsaciones de teclas. Las compilaciones para Windows se ejecutan desde la bandeja del sistema e incluyen una consola web local para configurar el modo de panel táctil y su sensibilidad.

El proyecto también incluye un inspector web en el puerto 8765 y diagnósticos en el puerto 8766, además de un script de puente para probarlo con un emulador de Android TV. El controlador y el dispositivo de destino deben estar en la misma LAN, y la app de macOS está autofirmada, por lo que Gatekeeper requiere una solución alternativa que solo hay que aplicar una vez.

Funciones clave

  • 01Usa el Apple TV Remote nativo del Centro de control del iPhone, así que no hace falta instalar una app en el teléfono.
  • 02Controla Android TV y Google TV mediante la inyección local de teclas por ADB, con Accessibility como alternativa.
  • 03Ofrece una app para la barra de menús de macOS y una CLI, con control fluido del cursor y teclas multimedia.
  • 04Incluye una versión para la bandeja del sistema de Windows, con una consola web local para configurar el panel táctil.
  • 05Incluye páginas de inspección web y diagnóstico para depurar gestos táctiles y sesiones del protocolo.

Casos de uso

  • Controlar un dispositivo Android TV o Google TV desde un iPhone sin comprar un control remoto dedicado.
  • Controlar desde el sofá la reproducción multimedia o el cursor de una Mac con el control remoto del iPhone.
  • Probar interacciones del protocolo Apple TV Remote con un emulador de Android TV en Android Studio.

Inicio rápido

  1. 1

    Instala el DMG (Mac) o el APK (Android TV) desde la sección de descargas

  2. 2

    Conecta el iPhone y el dispositivo de destino a la misma red Wi-Fi y desactiva el aislamiento de AP

  3. 3

    Concede los permisos: Accesibilidad en macOS; en Android TV, activa ADB por red y acepta el aviso «Permitir siempre»

  4. 4

    En el iPhone, abre el Centro de control, toca el icono de Apple TV Remote, selecciona el dispositivo de destino e introduce el PIN 1111

Antes de usarlo

  • En Android TV hay que activar ADB por red y aceptar un aviso RSA en el televisor.
  • La app para macOS es autofirmada, por lo que Gatekeeper muestra una advertencia la primera vez que se abre.
  • El controlador y el dispositivo de destino deben estar en la misma LAN, con el aislamiento de AP desactivado.
  • Los metadatos del repositorio no indican ninguna licencia, aunque el README menciona MIT.

Temas

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

Preguntas frecuentes

¿Qué es atv-core?
Permite controlar dispositivos Android TV / Google TV y Mac por la red local con el Apple TV Remote integrado en el Centro de control del iPhone. atv-core es un receptor que hace que los equipos con Android TV, Google TV y macOS aparezcan como destinos de Apple TV para el Apple TV Remote nativo de un iPhone o iPad. Los usuarios abren el Centro de control, seleccionan el dispositivo, ingresan el PIN 1111 y pueden usar el panel táctil para deslizar y mover el cursor, y los botones para seleccionar, volver, reproducir o pausar y ajustar el volumen, sin instalar una app en el teléfono.
¿atv-core es gratuito? ¿Qué licencia tiene?
atv-core no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿atv-core sigue mantenido?
Mantenimiento activo. El último commit de atv-core fue el 7 oct 2026.
¿Para qué puedo usar atv-core?
Controlar un dispositivo Android TV o Google TV desde un iPhone sin comprar un control remoto dedicado. Controlar desde el sofá la reproducción multimedia o el cursor de una Mac con el control remoto del iPhone. Probar interacciones del protocolo Apple TV Remote con un emulador de Android TV en Android Studio.
¿Cómo se instala atv-core?
Instala el DMG (Mac) o el APK (Android TV) desde la sección de descargas Conecta el iPhone y el dispositivo de destino a la misma red Wi-Fi y desactiva el aislamiento de AP Concede los permisos: Accesibilidad en macOS; en Android TV, activa ADB por red y acepta el aviso «Permitir siempre» En el iPhone, abre el Centro de control, toca el icono de Apple TV Remote, selecciona el dispositivo de destino e introduce el PIN 1111
¿Dónde consigo atv-core?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/corvofeng/atv-core

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados