Catálogos para Cine y Series

Cine y Series, en Frunk.tv, no trae películas ni series: enseña los catálogos que añade cada usuario. Cualquiera puede publicar uno. Esta página explica cómo: un fichero JSON que lo describe, una base de datos SQLite con las películas y los enlaces, y un enlace para instalarlo. Para usar Cine y Series, mira su guía. Para películas, series o canales que se piden por partes a un servidor, mira los addons: este formato es uno de sus casos.

Cómo funciona

• El usuario abre el enlace de instalación del catálogo, o pega su dirección en Cine y Series («＋»), en el coche o enviándola desde el móvil con un código QR.
• Frunk.tv le enseña el nombre, la descripción y el dominio que lo publica, y le pide confirmación.
• El navegador del usuario descarga la base de datos directamente de donde la publicas y la guarda; las búsquedas se hacen en su navegador. Los vídeos se reproducen desde sus enlaces. Nada pasa por el servidor de Frunk.tv.

El manifiesto

Un JSON servido por https con Access-Control-Allow-Origin: * (lo pide el navegador del usuario, desde frunk.tv). GitHub (raw.githubusercontent.com) y GitHub Pages ya lo hacen.

{
  "frunk_catalog": 1,
  "name": "Mi catálogo",
  "description": "Qué tiene, en una o dos frases.",
  "bundle": "catalogo.db",
  "debrid": false
}

• frunk_catalog: la versión del formato, 1.
• name (hasta 60 caracteres) y description (opcional, hasta 400).
• bundle: la base de datos, relativa al manifiesto o absoluta. Una base SQLite tal cual o dentro de un ZIP.
• debrid: true si los enlaces se abren a través de la cuenta de AllDebrid del propio usuario; false (o nada) si son vídeos que se reproducen tal cual. Publica solo enlaces a contenido que tengas derecho a difundir.
• setup (opcional): sentencias SQL que se ejecutan al abrir la base, para crear índices o vistas con el esquema de abajo. Si una tabla tuya se llama como una vista del esquema, nómbrala con main. dentro de la vista.

La base va en claro: un fichero SQLite o un ZIP normal, sin cifrar. Un manifiesto con otros campos de una versión anterior del formato no se puede añadir.

La base de datos

Frunk.tv lee estas tablas (o vistas creadas en setup):

movies        (id, title, year, poster, plot, rating, quality[, category])
movie_links   (movie_id, url, quality, audio)
series        (id, title, year, poster, plot, rating, quality[, category])
episode_links (series_id, season, episode, url, quality, audio)

• poster: URL completa por https. Mejor pequeña (unos 185 píxeles de ancho): en el coche, la memoria cuenta.
• url: un enlace completo por http(s), en claro. Uno que no lo sea no se muestra.
• year: un número. La lista va de más reciente a más antigua.
• category (opcional): con dos valores o más, salen como filtros.
• Sin series no sale la pestaña de series, y lo mismo con movies.
• Un catálogo grande está bien, pero cuanto menos ocupe, antes se descarga y menos memoria usa en el coche.

El enlace de instalación

https://frunk.tv/#/vod/add/ seguido de la dirección del manifiesto, codificada (en JavaScript, encodeURIComponent). Por ejemplo, el catálogo de ejemplo de Frunk.tv:

https://frunk.tv/#/vod/add/https%3A%2F%2Ffrunk.tv%2Fstatic%2Fcatalogs%2Fclasicos.json

Si cambias la base, cambia el fichero: Frunk.tv compara su tamaño y su fecha y avisa a quien lo tenga de que hay una versión nueva. Si mueves la base, cambia bundle en el manifiesto.

Un ejemplo completo

«Clásicos de dominio público», el catálogo de ejemplo, es una base SQLite con el esquema tal cual: su manifiesto y su base de datos. Sus películas son del Internet Archive y se reproducen directamente desde allí.