Saltar a contenido

Plugins de ejemplo

Cuatro plugins publicados, todos públicos, todos instalables en Kino y todos usables como plantilla. Arranca por Internet Archive si quieres la plantilla más simple posible; arranca por Tu servidor, el demo completo de la API, cuando tu fuente sea un servidor de la persona o cuando quieras ver funcionando de punta a punta cada función hasta apiVersion 7; arranca por Internet Archive Audio para música y podcasts (apiVersion 8, Kino 0.9.54).

  • Tu servidor · kinotvapp/kino-plugin-own-server


    El demo completo de la API. Un servidor multimedia en la casa (Jellyfin, Emby, un NAS…): la persona escribe su dirección, su usuario y su contraseña. Versión 1.5.0, apiVersion 7: "hosts": [], todos los tipos de ajuste y el formulario completo, sesión con kino.storage, kino.rank, temporadas, download, copias, firma por petición, channels en todas sus formas, una sección y mosaicos de Categorías, migrate, meta, subtitles, tracking y segments, más un servidor de referencia (server.mjs) para probarlo sin nada propio.

    Usar como plantilla Ver en GitHub

  • Internet Archive · kinotvapp/kino-plugin-archive


    Películas de dominio público y televisión clásica de archive.org. La plantilla más simple de la que partir: un manifiesto, un archivo JavaScript, sin paso de compilación, las cinco capacidades más download, y un ajuste list para las direcciones de archive.org de la persona (apiVersion 4), con el kit sdk/, GUIDE.md, contract.json y kino.d.ts.

    Usar como plantilla Ver en GitHub

  • Internet Archive Audio · kinotvapp/kino-plugin-archive-audio


    El plugin de audio de referencia. Música libre, conciertos en vivo, audiolibros y radio antigua de archive.org, como ítems music y podcast: apiVersion 8, Kino 0.9.54 o más nuevo. episodes responde por cada álbum, audiolibro y programa (aunque sea una sola pista), resolve ofrece cada formato de audio como una copia perezosa con etiqueta, más download, una sección propia y mosaicos de Categorías. Mira Música y podcasts.

    Usar como plantilla Ver en GitHub

  • Vault demo · kinotvapp/kino-plugin-vault-demo


    El ejemplo de kino.vault.get(). El secreto del plugin (una API base, llaves, un token) vive en la bóveda de Kino, no en el código: una llamada, await kino.vault.get(), y Kino resuelve el secreto solo para ESTE plugin y solo para quien está en el grupo de Kino. apiVersion 28 (Kino 0.9.90), capacidades screen + identity + vault, un plugin.js sin compilar y bien comentado, con el manejo de cada estado (not_member, not_found…).

    Usar como plantilla Ver en GitHub

Para probar cualquiera en Kino, abre Ajustes > Plugins y escribe kinotvapp/kino-plugin-archive, kinotvapp/kino-plugin-own-server, kinotvapp/kino-plugin-archive-audio o kinotvapp/kino-plugin-vault-demo (este último necesita Kino 0.9.90 o más nuevo).

Usa la plantilla, no hagas fork. "Usar como plantilla" crea un repositorio nuevo tuyo con los mismos archivos. Un fork también funcionaría como plugin, pero la búsqueda de la comunidad de Kino deja los forks por fuera (Hazte encontrar). Luego cambia id, name, homepage, hosts y capabilities en kino-plugin.json, reescribe plugin.js y conserva sdk/.

Plugins que se usan entre sí (apiVersion 20, Kino 0.9.81): TMDB y Cine Trivia

Cine Trivia (kinotvapp/kino-plugin-cine-trivia) es el consumidor de referencia del protocolo entre plugins: un juego de cine de cinco preguntas (un plugin con screen, para teléfono y TV) que saca cada película de la puerta movies de TMDB, el proveedor de referencia (TMDB 1.3.0 y posteriores, con la puerta en enhancements["20"]). Muestra el patrón completo: consumes + recommends, una pantalla de instalación con go.installPlugin hasta que TMDB esté instalado, kino.plugins.call con cada código de error manejado y un flujo trending en vivo. Los dos necesitan Kino 0.9.81 o más nuevo para la puerta.

Un ejemplo real: un plugin que usa el navegador oculto

Maratón (firmado, apiVersion 6, "browser": "pages") es un plugin real, de otra persona, que encuentra su video con kino.browser.capture y ofrece los otros servidores e idiomas de cada capítulo como copias perezosas con etiqueta. Es un ejemplo solo de esas dos funciones (Kino solo lista los plugins de la comunidad: cada autor responde por el suyo); "Tu servidor" sigue siendo el plugin de referencia completo.

Proveedores de sincronización: Sync-Gram, Sync Servidor y Sync-Gram Cuenta

Las referencias para un proveedor de sincronización (apiVersion 12, Kino 0.9.74) son tres repositorios públicos: Sync-Gram (kinotvapp/kino-plugin-sync-gram, un bot de Telegram de la propia persona; no oficial, sin relación con Telegram; recomendado en Kino) y Sync Servidor (kinotvapp/kino-plugin-sync-server, un servidor de Node de un solo archivo que corre la persona; Kino no lo lista, se instala pegando la dirección de su repositorio) y Sync-Gram Cuenta (kinotvapp/kino-plugin-sync-gram-account, la propia cuenta de Telegram de la persona por un WebSocket, apiVersion 13; no oficial; Kino no lo lista, se instala pegando kinotvapp/kino-plugin-sync-gram-account). Cada uno tiene una guía en español y en inglés y pruebas sin red. Mira Los tres proveedores de ejemplo.

Kino Sync (experimental): sincronizar con tu propio Google Drive

Kino Sync (kinotvapp/kino-plugin-sync-gdrive) es un proveedor de sincronización que guarda la copia cifrada en el Google Drive de la propia persona: sin servidor tuyo y sin pegar tokens. La persona toca Conectar con Google, escribe un código en google.com/device (el mismo paso de las apps de TV) y listo. Es un experimento: no es parte de Kino, no se recomienda y no es oficial ni tiene relación con Google. Muestra una pantalla (settingsIn: "screen") con los pasos, un aviso con «Reintentar», el estado de la copia en Drive y un acordeón de preguntas; la copia vive en una carpeta «Kino Sync» con un solo archivo, kino-sync.bin, con el permiso drive.file (el plugin solo ve lo que creó). El cliente de Google va incorporado como un secreto sellado, y como Drive no sabe escribir «solo si la versión es X», el plugin comprueba, escribe y vuelve a comprobar para detectar un conflict. Trae pruebas de Node sin red, con una imitación de Google.

Pantallas (apiVersion 14, con Kino 0.9.74): tres ejemplos

apiVersion 13 (Kino 0.9.74): un ejemplo de stream de bytes

Ningún plugin de ejemplo publicado usa apiVersion 13 todavía. La guía tiene un plugin completo con socket y byteSource, una biblioteca de videos detrás de un WebSocket, con la prueba de Node que revisa cada rango que sirve: Un ejemplo completo. Las páginas del catálogo, de las imágenes y de los QR también traen cada una un ejemplo completo.

El plugin de referencia

Para lo básico -- search, home, browse, episodes y resolve sobre un sitio público, sin ajustes ni sesión -- la referencia es kino-plugin.json y plugin.js de kinotvapp/kino-plugin-archive, el plugin de Internet Archive, con las cinco capacidades. Se lee más o menos así:

  1. Declara archive.org y *.archive.org: una URL de descarga en archive.org redirige a un nodo de almacenamiento como dn720705.ca.archive.org, y el comodín no cubre el dominio pelado.
  2. getJson hace primero el await y lanza errores después (la regla de la trampa del rechazo).
  3. search limpia lo que escribió la persona: archive.org responde 200 con un cuerpo de error cuando la consulta tiene un /, -, & o ' suelto o un AND/OR/NOT colgando, así que conserva letras, dígitos y apóstrofes dentro de las palabras, quita las palabras de operador, y les pregunta a las dos colecciones (películas y TV clásica) diga lo que diga type, que usa solo para decidir qué grupo va primero; un ítem que está en las dos se lista una vez.
  4. home arma tres filas (películas, TV clásica, animación clásica) y envuelve cada fila en su propio try/catch, para que una fila que falla no haga perder las otras; lo reporta con kino.log. Cada fila lleva su propio id como ref, y browse(ref, cursor) recorre la misma consulta de a 50 con el número de página como cursor ("2", "3", …), y lanza kino.error("not_found") para una fila que no conoce.
  5. episodes lee la lista de archivos del ítem, conserva los videos originales en orden natural (un comparador natural() pequeño, porque no se puede confiar en localeCompare), los numera a partir de un S01E02 en el nombre del archivo o 1, 2, 3, y usa "<item>|<file name>" como ref de cada capítulo.
  6. resolve escoge el mejor archivo reproducible (un mp4 derivado del original, o el mp4/webm mismo), convierte los archivos .vtt/.srt hermanos en subtitles, y pone durationMs.
  7. Cada URL que arma es https en un host declarado; los pósters usan https://archive.org/services/img/<id> y no se revisan contra los hosts.

El README.md de ese repositorio dice lo que no hace (una colección se muestra como una sola película, los capítulos numerados 0 se descartan), así que no copies eso como si fuera lo esperado.

Para todo lo demás, hasta apiVersion 7 (Kino 0.9.51) -- ajustes, sesión, descargas, ítems live, channels, lo de apiVersion 6, tracking y segments -- la referencia es kinotvapp/kino-plugin-own-server ("Tu servidor" 1.5.0): su kino-plugin.json y su plugin.js usan casi todo lo que existe, y su README.md relaciona cada función con el título de su servidor de prueba que la ejercita:

Lo que muestra Dónde en el código Guía
"hosts": [], el servidor que escribe la persona y sus otras direcciones (una list de campos url) kino-plugin.json; base(), addresses(), reach() Los servidores propios de la persona
Todos los tipos de ajuste: url, text, password, toggle, select, list, section (con explicación de 300 caracteres), status, action kino-plugin.json: settings Formulario de ajustes
Líneas de estado, botones (confirm, clearSettings) y una revisión antes de guardar settingsStatus(), action(), validateSettings() Formulario de ajustes
Login y un token guardado en kino.storage, reintentado una vez ante un 401; kino.sleep con un Retry-After corto token(), api() kino.storage
Errores tipados (kino.error) y una frase propia (userMessage) api(), resolveCopy() Errores que la gente entiende
Una caché con el ttlMs que escoge la persona, y la última copia si el servidor se cae; telemetry + kino.log.report home(), reach() kino.storage, Telemetría
Búsqueda por título sobre un backend que compara cualquier palabra; una Page con next; scopedSearch search(), kino.rank.* kino.rank, Buscar dentro de un "Ver más"
Paginación con cursor, filas con genre browse(), refFilter(), ROWS Paginación
Temporadas como títulos separados episodes() Temporadas
ids.tmdb + ids.imdb, campos del ítem, entradas adult: true item(), categories() ids.tmdb, Contenido +18
Una sección con pestañas y destacado, mosaicos de Categorías, theme section(), categories(); kino-plugin.json Sección, categorías y colores
Descargas (download) kino-plugin.json; resolve() devuelve un mp4 progresivo Descargas
audioTracks, subtitles, durationMs y skip en el Stream resolve() Las reglas del Stream
Copias con etiqueta y perezosas, el mismo archivo en las otras direcciones withCopies(), resolveCopy(), withAddresses() Copias con etiqueta y perezosas
Firma de cada petición (signing, signContext, sign, alternateHosts, resolve(ref, { retry })) signedStream(), sign(), resolve() Firma por petición
Ítems live (apiVersion 2) item(), resolve() Canales en vivo (apiVersion 2)
channels: un ref, un stream en línea, una lista M3U con guía XMLTV, una lista con resolve: true, liveSearch, paginación liveCategories(), channel(), liveChannels(), liveSearch(), resolveListEntry() Canales en la pestaña En vivo, Tres recetas
Un User-Agent que los canales exigen: headers en un Stream, streamHeaders en una lista agentHeaders() Canales en la pestaña En vivo
Una guía para canales propios guide() Las funciones de canales
Pasar lo guardado con los ids viejos del servidor migrate(), movedTable() Pasar lo guardado
meta con logo, ratings y cast (Kino 0.9.51) meta() Describir otros títulos
subtitles con la pista file (Kino 0.9.51) subtitles() Subtítulos para cualquier título
tracking (apiVersion 7): idempotencia con event.id, { skipped: true } track() Contarle a un servicio de seguimiento
segments (apiVersion 7) segments() Dónde están la intro y los créditos

Su núcleo, línea por línea, está en el recetario: El servidor propio de la persona.

Instálalo y compruébalo

kinotvapp/kino-plugin-own-server trae un servidor de referencia sin dependencias (node server.mjs [--port 8096] [--user ana] [--password s3cr3t] [--live-agent VLC]) cuyo catálogo ejercita una función por título, así que puedes instalar el plugin en Kino y ver cada fila de la tabla de arriba funcionando, sin necesitar un servidor real.

Algunos poderes no están a propósito, porque un servidor en la casa nunca los necesita: DRM Widevine (receta), un host declarado por http plano (receta), streams en cualquier servidor (receta), secretos sellados (kino.secret), la firma del autor (Plugins firmados), el navegador oculto y kino.html.select (Navegador oculto) y los pares de llaves (Pares de llaves).

Tiendas de plugins de ejemplo

Para publicar tu propia tienda (apiVersion 15, con Kino 0.9.77) hay dos plugins completos y copiables: una tienda local cuya lista es un archivo JSON estático y una tienda en vivo con su propia API. Los dos pasan el kit y traen pruebas sin red: Tiendas de ejemplo. La tienda que viene en la app, Kino Plugins, es otro ejemplo real (Tiendas de plugins).