Película con carátula o sinopsis incorrecta en IPTV: ¿de dónde salen esos datos?

Abres una película y aparece la carátula de otra. O la imagen parece correcta en la biblioteca, pero la sinopsis cambia al entrar en los detalles. Antes de pensar que el vídeo está equivocado, conviene separar tres cosas: la entrada del catálogo del proveedor, la ficha que describe la obra y el contenido que se reproduce. Están relacionadas, pero no son la misma información.

Con Xtream Codes, la aplicación recibe un catálogo estructurado del servidor. Puede incluir carátulas, sinopsis, reparto e identificadores de bases de cine. El reproductor también puede completar la ficha con información externa. Un error en cualquiera de esas asociaciones puede aparecer en pantalla aunque la película se reproduzca con normalidad.

La carátula y la sinopsis son metadatos

Los metadatos describen un contenido: título, año, género, duración, póster, sinopsis y reparto. Piensa en un libro: la portada y el resumen ayudan a elegirlo, pero no son sus páginas. En IPTV, la ficha de una película y la dirección que se usa para reproducir el vídeo también siguen caminos distintos.

Una sinopsis en inglés no demuestra que el audio esté en inglés. Una carátula que diga «4K» no confirma la resolución del archivo. Y una imagen de otra obra no basta para saber si el vídeo también está cambiado. Distinguir estos casos ayuda a explicar mejor el problema.

Cómo llegan los datos a través de Xtream Codes

Al configurar un perfil con servidor, usuario y contraseña, le indicas a Nebula dónde consultar tu catálogo autorizado. La aplicación envía solicitudes a la API del proveedor, normalmente por la ruta /player_api.php. Cada solicitud especifica una acción y el servidor responde con datos estructurados en JSON: campos con nombres y valores que la aplicación puede interpretar.

Xtream Codes es la interfaz de comunicación, no una base universal de películas. Cada proveedor mantiene su propio catálogo y decide qué información incluye. Los nombres que aparecen a continuación son habituales en este entorno y se usan en la integración de Nebula, pero la disponibilidad y la calidad de los campos varían entre servidores compatibles.

1. El servidor entrega las categorías y la lista de películas

Las categorías de películas se pueden consultar con get_vod_categories. La acción get_vod_streams devuelve los títulos de vídeo bajo demanda, o VOD. Esta primera respuesta permite montar la biblioteca sin pedir la ficha completa de cada película a la vez.

• name: el nombre registrado en el catálogo, que puede incluir el año y etiquetas como DUAL o 1080p.
• stream_id: el identificador del elemento dentro del catálogo de ese proveedor.
• stream_icon: la dirección de la imagen que se utiliza como carátula en la lista.
• category_id: la categoría asignada por el proveedor; no tiene por qué coincidir con el género cinematográfico.
• rating y added: una valoración e información de incorporación al catálogo, cuando se incluyen; added no es la fecha de estreno de la película.

Nebula guarda la lista recibida en el dispositivo para permitir la navegación. Por eso, la carátula de la biblioteca puede proceder directamente del stream_icon enviado por el proveedor. La aplicación no necesita ver el vídeo ni reconocer sus escenas para mostrar esa tarjeta.

2. Al abrir la película, la aplicación solicita los detalles

Cuando entras en una película de un perfil Xtream, Nebula solicita get_vod_info y envía el stream_id de ese elemento en el parámetro vod_id. En palabras sencillas, pide «los detalles de esta película de tu catálogo». El nombre vod_id no convierte ese número en un identificador de una base de cine: sigue apuntando al elemento del proveedor.

La respuesta suele separar info, con la ficha descriptiva, y movie_data, con datos del elemento, como el nombre y container_extension, la extensión utilizada para la reproducción. En info, campos como movie_image, plot, cast, director, genre, releasedate y tmdb_id pueden indicar imagen, sinopsis, reparto, dirección, género, estreno y asociación con TMDB.

Por tanto, Xtream puede entregar una ficha completa. Si plot llega vacío o movie_image apunta a una imagen equivocada, esa ausencia o asociación ya llegó por la API. La carátula de la lista y la imagen de los detalles también pueden ser distintas porque proceden de campos y consultas diferentes.

3. Las imágenes se descargan desde las direcciones recibidas

La respuesta suele incluir una URL de la carátula, no la imagen entera. La aplicación tiene que descargarla desde esa dirección, que puede pertenecer al proveedor o a otro servicio. Así, el catálogo puede cargar y el vídeo funcionar mientras la carátula falla por un enlace roto, un servidor de imágenes inaccesible o una copia antigua en caché.

El dominio de la imagen no indica por sí solo quién eligió el póster. El propio proveedor puede haber incluido una dirección de TMDB en la respuesta Xtream. Eso no significa necesariamente que la aplicación haya realizado una búsqueda por su cuenta.

Dónde interviene TMDB en Nebula Player

Además de la ficha Xtream, Nebula puede utilizar información de TMDB, una base de películas y series, para mostrar detalles enriquecidos. En el flujo de películas, cuando esta función está activa, la aplicación intenta usar el identificador TMDB enviado por el proveedor. Cuando no hay un identificador utilizable en el flujo de búsqueda, puede buscar por título, retirando etiquetas técnicas y aprovechando el año cuando está disponible.

Si la consulta de detalles a TMDB funciona, la pantalla enriquecida puede mostrar el título, póster, fondo, sinopsis y reparto de esa base. Si la consulta falla, el flujo de películas puede seguir mostrando la ficha del proveedor. El enriquecimiento depende de las funciones activas y del resultado de las consultas; no garantiza corregir automáticamente todo el catálogo.

Imagina un elemento ficticio llamado «Horizonte (2021) DUAL 1080p». El proveedor puede enviar la carátula correcta en la lista, pero asociar el tmdb_id de otra película llamada «Horizonte». Al abrir los detalles enriquecidos, aparecería la ficha de esa otra obra. El vídeo sigue siendo el elemento del proveedor: enriquecer los metadatos no sustituye el archivo que se reproduce.

La búsqueda por nombre también tiene límites. Las nuevas versiones de una película, los títulos traducidos, los nombres parecidos y los años incorrectos pueden llevar a otra coincidencia. Quitar «DUAL» y «1080p» ayuda a buscar, pero no demuestra la identidad de la obra. Un identificador correcto en el origen evita la ambigüedad de la búsqueda por texto; uno incorrecto puede propagar el error.

¿Y las series y las listas M3U?

En las series, el modelo es similar: get_series devuelve el catálogo y get_series_info consulta una serie por su series_id, pudiendo incluir ficha, temporadas y episodios. Hay más niveles de asociación: la carátula de una temporada no tiene por qué ser el póster general, y la sinopsis de un episodio no es la descripción de toda la serie.

Una lista M3U no realiza esas consultas Xtream. Puede incluir nombre, grupo e imagen, por ejemplo mediante el atributo tvg-logo. En el flujo M3U de Nebula, la ficha inicial se monta con la información importada y el enriquecimiento puede completar los datos mediante una búsqueda por título. El artículo «M3U, M3U8 y Xtream Codes: ¿cuál es la diferencia?» explica con más detalle estos formatos de acceso.

Cómo localizar el problema

• Comprueba el título, el año y el tipo de contenido. Una serie, una película y una nueva versión con nombres parecidos son obras distintas.
• Compara la carátula de la biblioteca con la pantalla de detalles. Si solo cambia la ficha, indícalo: ayuda a investigar la consulta de detalles y el enriquecimiento.
• Comprueba si el vídeo es la película que esperabas. Si también es otra, el proveedor debe revisar el elemento del catálogo y su asociación con el contenido.
• Actualiza el catálogo con la opción disponible en la aplicación y vuelve a abrir el título. Esto puede traer una corrección ya hecha en el origen; no arregla una ficha que sigue estando mal allí.
• Compara con otro reproductor, si tienes uno, usando el mismo acceso. El mismo error refuerza la sospecha sobre el origen; un resultado diferente es una pista, no una prueba, porque las aplicaciones pueden enriquecer y guardar los datos de formas distintas.

Si solo falla la imagen, prueba otra red y otros títulos para distinguir un problema de acceso a las imágenes de un error aislado del catálogo. Si la ficha está en otro idioma, revisa el idioma de la aplicación y comunica el caso al soporte. El texto puede proceder del proveedor o de una base externa sin traducción disponible. Cambiar de idioma no crea una traducción que la fuente no tiene.

¿Quién puede corregir cada parte?

El proveedor puede revisar nombre, año, URL de las imágenes, sinopsis e identificador externo enviados por su API, además de comprobar qué vídeo está asociado al elemento. El soporte del reproductor puede investigar la interpretación de los campos, la selección de datos, la búsqueda de coincidencias y la actualización local. Una descripción incorrecta en la propia base externa debe revisarse en esa base.

Al pedir ayuda, envía el título y el año esperados, la categoría, la versión de la aplicación y capturas de la lista y de los detalles, ocultando los datos de la cuenta. Explica si lo incorrecto es la carátula, la sinopsis o el propio vídeo. Nunca publiques URL de reproducción, usuario, contraseña ni respuestas completas de la API: pueden exponer tus credenciales.

Una ficha fiable depende de una cadena de asociaciones: el elemento correcto en el proveedor, campos bien completados, imágenes accesibles y una coincidencia correcta en la base externa. Entender esa cadena facilita localizar el error y pedir la corrección a quien controla esa etapa.