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 conkino.storage,kino.rank, temporadas,download, copias, firma por petición,channelsen todas sus formas, una sección y mosaicos de Categorías,migrate,meta,subtitles,trackingysegments, más un servidor de referencia (server.mjs) para probarlo sin nada propio. -
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 ajustelistpara las direcciones de archive.org de la persona (apiVersion 4), con el kitsdk/,GUIDE.md,contract.jsonykino.d.ts. -
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
musicypodcast: apiVersion 8, Kino 0.9.54 o más nuevo.episodesresponde por cada álbum, audiolibro y programa (aunque sea una sola pista),resolveofrece cada formato de audio como una copia perezosa con etiqueta, másdownload, una sección propia y mosaicos de Categorías. Mira Música y podcasts. -
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), capacidadesscreen+identity+vault, unplugin.jssin compilar y bien comentado, con el manejo de cada estado (not_member,not_found…).
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
- Galería UI (kinotvapp/kino-plugin-ui-gallery): cada
componente de una pantalla dibujado en el aparato, por siete pestañas (diseño, contenido, acciones,
formularios, ventanas, navegación y datos), incluidas las últimas piezas:
pagesa pantalla completa, un carruselPageView,ListTile,CircleAvatar, el botón flotante, una rutaScaffold, animaciones y unsettingsconautoSave; las capturas del catálogo de componentes salen de ella. - Solo noticias (kinotvapp/kino-plugin-news): una pantalla con
tarjetas de noticias de lo que ves y un trabajo en segundo plano que las actualiza;
código en
src/empaquetado con esbuild (Estructurar un plugin grande). - Party Chat (kinotvapp/kino-plugin-watch-party): una
pestaña del panel del reproductor para ver un título con amigos, con
salas, chat y el video sincronizado con
playerControl.
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í:
- Declara
archive.orgy*.archive.org: una URL de descarga enarchive.orgredirige a un nodo de almacenamiento comodn720705.ca.archive.org, y el comodín no cubre el dominio pelado. getJsonhace primero elawaity lanza errores después (la regla de la trampa del rechazo).searchlimpia lo que escribió la persona: archive.org responde 200 con un cuerpo de error cuando la consulta tiene un/,-,&o'suelto o unAND/OR/NOTcolgando, 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 digatype, que usa solo para decidir qué grupo va primero; un ítem que está en las dos se lista una vez.homearma tres filas (películas, TV clásica, animación clásica) y envuelve cada fila en su propiotry/catch, para que una fila que falla no haga perder las otras; lo reporta conkino.log. Cada fila lleva su propio id comoref, ybrowse(ref, cursor)recorre la misma consulta de a 50 con el número de página como cursor ("2","3", …), y lanzakino.error("not_found")para una fila que no conoce.episodeslee la lista de archivos del ítem, conserva los videos originales en orden natural (un comparadornatural()pequeño, porque no se puede confiar enlocaleCompare), los numera a partir de unS01E02en el nombre del archivo o 1, 2, 3, y usa"<item>|<file name>"comorefde cada capítulo.resolveescoge el mejor archivo reproducible (un mp4 derivado del original, o el mp4/webm mismo), convierte los archivos.vtt/.srthermanos ensubtitles, y ponedurationMs.- Cada URL que arma es
httpsen un host declarado; los pósters usanhttps://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).