Configurar Xtream Codes en Apple TV lleva menos de dos minutos si tienes los datos correctos a mano. Xtream Codes es el formato que usan hoy la mayoría de los proveedores IPTV: con una URL, un usuario y una contraseña, la app recibe los canales, la guía EPG, las películas y las series en un solo paquete. Aquí tienes los cuatro pasos y los problemas que más a menudo hacen fallar una primera instalación.
Recuerda que OneTV Connect es un reproductor. No vende ni incluye canales, contenidos ni suscripción: los datos de acceso te los da el proveedor con el que ya tienes contrato.
Antes de empezar
Necesitas tres datos de tu proveedor:
- La URL del portal, con el formato
http://servidor:puerto. Sin barra al final y sin rutas como/get.php. - Tu usuario.
- Tu contraseña.
Si tu proveedor solo te ha dado un enlace M3U largo, fíjate en él: suele contener
username= y password=. La parte anterior a /get.php es la URL
del portal. Usar Xtream en lugar de M3U tiene ventajas: carga más rápida, categorías más completas y
guía automática. Las diferencias entre los formatos están explicadas en
Xtream, M3U o Stalker (en inglés).
1. Instalar OneTV Connect
Abre la App Store en tu Apple TV, busca OneTV Connect e instálala. La app es gratuita e incluye la reproducción IPTV completa. La versión Pro solo es necesaria para Plex, los paneles en directo, Trakt y los temas. Inicia sesión en iCloud antes de continuar: cualquier lista que añadas en el Apple TV aparecerá sola en tu iPhone y en tu iPad. La página del reproductor IPTV para Apple TV resume todo lo que incluye.
2. Abrir el asistente Xtream
Desde la pantalla de inicio, entra en Ajustes → Listas de reproducción → Añadir lista → Xtream Codes. Este asistente no procesa un archivo M3U: habla directamente con la API JSON del proveedor. Es más rápido y ofrece un árbol de categorías más detallado.
Escribir con el mando es lento. Si tienes un iPhone cerca, el teclado de iOS aparece como notificación en cuanto el Apple TV pide un texto: puedes pegar la URL desde allí.
3. Introducir los datos del portal
Escribe la URL, el usuario y la contraseña, y pulsa Validar. La app contacta con el portal, lee los datos de tu cuenta (fecha de caducidad, conexiones permitidas) y empieza a indexar los canales en segundo plano. Para una lista de 5.000 canales suele tardar entre 5 y 30 segundos.
Si la validación falla, revisa por orden: que la URL empiece por http:// o
https://, que el puerto sea el correcto, que no haya espacios al final del usuario y
que tu cuenta no esté ya abierta en otro dispositivo, si solo admite una conexión.
Una vez validada, la cuenta queda guardada. No hace falta volver a escribir nada: la app actualiza los canales y la guía a intervalos regulares, y puedes forzar una actualización desde los ajustes de la lista cuando tu proveedor añade canales nuevos.
4. Comprobar la guía y el vídeo a la carta
Cuando termine la indexación, abre la pestaña En vivo. La programación debería aparecer junto a cada canal. Si un canal muestra «Sin programa», mantenlo pulsado y elige la entrada correcta en la lista de canales de la guía, que tiene buscador. La asociación se sincroniza después por iCloud.
La guía que entrega el portal no siempre es completa. Puedes añadir una fuente XMLTV externa en Ajustes → EPG; las fuentes se apilan y se completan entre sí. Para los canales españoles, hemos probado y medido las fuentes gratuitas en nuestra guía EPG IPTV para España, con los identificadores exactos de cada cadena.
Las películas y las series tienen sus propias pestañas y salen del mismo portal Xtream. En los minutos siguientes, la app completa carátulas y fichas con los datos de TMDB.
Problemas habituales
- Portales HTTPS con certificado autofirmado. Fallan sin mostrar un error claro. OneTV Connect lo resuelve con su capa proxy para MPV, pero VLC y KSPlayer pueden seguir dando error. Si ves errores SSL, cambia a MPV en Ajustes → Reproducción.
- El proveedor bloquea algunos user-agents. Ciertos portales rechazan el identificador por defecto del Apple TV. En Ajustes → Reproducción puedes definir un user-agent personalizado, por ejemplo uno genérico de VLC.
- Las películas devuelven un error HTTP 404. Muchos servidores de vídeo a la carta no aceptan peticiones por rangos. La app lo detecta y desactiva el avance y retroceso. Si todas las películas dan 404, es un fallo de enrutamiento del proveedor: pídele que active las peticiones por rangos.
- La guía va un día por detrás. Algunos proveedores solo actualizan su XMLTV a medianoche UTC. Ajustes → EPG → Actualizar ahora fuerza una nueva descarga.
- Horarios desplazados una hora. Si ves la guía desde Canarias, recuerda que las islas van una hora por detrás de la península. La app usa la zona horaria de tu Apple TV: compruébala en los ajustes del sistema.
- Faltan logotipos. El proveedor no ha rellenado el campo
tvg-logo. OneTV Connect usa entonces el logotipo de la guía. Puedes poner una URL propia desde el menú de pulsación larga del canal.
Eso es todo. Un segundo portal Xtream se añade igual: los dos aparecen en el selector de listas y pasas de uno a otro con un gesto. Si buscas más criterios para elegir app, lee cuál es la mejor app IPTV para Apple TV en 2026. Y si un mensaje de error concreto te bloquea, la página de soporte (en inglés) tiene la lista de comprobaciones completa.