Saltar a contenido

Novedades para quienes escriben plugins

Lo que cambió en Kino y que importa cuando escribes un plugin, por versión de la app. Cada número está en el contrato y en los archivos de referencia.

Kino 0.9.88: títulos listos por adelantado, en vivo por reloj, imágenes http en las pantallas

Disponible desde Kino 0.9.88

El apiVersion 27 (clockLive) llega con Kino 0.9.88: un Kino anterior rechaza "apiVersion": 27 e ignora un bloque enhancements["27"]. Todo lo demás de aquí es aditivo, sin apiVersion nuevo: un Kino anterior ignora resolveAhead, nunca llama prepare, no tiene kino.pluginApiVersion ni kino.screen.httpImages, y descarta las imágenes http de una pantalla.

  • Dejar listo un título por adelantado. El "resolveAhead": true del manifiesto deja que Kino llame resolve para una película o un episodio cuando la persona lleva unos 0,3 s en la página del título, y que reproduzca esa respuesta si aprieta reproducir dentro de 20 minutos; solo para un plugin cuyo resolve no puede preguntarle nada a la persona (un "fetchHosts": "any" aprobado y video desde cualquier servidor). Dejar listo un título.
  • Prepararse antes de reproducir. El export opcional prepare(ref), para un plugin cuyo resolve nunca debe correr para títulos que nadie reproduce (un cupo por cuenta, reproducciones contadas): Kino lo llama en el mismo momento e ignora su respuesta, así puede preparar una sesión o un token. 15 s, en segundo plano, una vez por ref cada 5 minutos, 6 por minuto; node sdk/run.mjs . prepare <ref>. Prepararse antes de reproducir.
  • En vivo por reloj (apiVersion 27). Un stream en vivo puede llevar clockLive: la plantilla, la serie de duraciones y el ancla de un CDN que nombra sus segmentos con un reloj de medios, y Kino arma la ventana HLS él mismo, sin llamar a tu plugin mientras se ve. Kino lo lee de tu apiVersion efectivo, así que un "enhancements": { "27": {} } vacío lo enciende sin subir el tuyo. En vivo por reloj.
  • kino.pluginApiVersion. Tu apiVersion efectivo en este Kino: tu apiVersion o la clave más alta de enhancements aplicada. Revísalo, no kino.apiVersion, antes de enviar clockLive. kino.pluginApiVersion.
  • Imágenes http en las pantallas. Las imágenes de una pantalla (una Image, la imagen y el logo de un heroCard, un CircleAvatar, los pósters de titleCard, titleRail y titleGrid) pueden ser http en un host público, como un póster del Inicio: se ven los logos de los canales de IPTV. Revisa kino.screen.httpImages === true; los headers siguen yendo solo con https. Imágenes http.
  • Identidad. kino.identity.telegram da el token solo a las llaves de autor de kinoIdentity.tokenAuthors, ahora dos; cualquier otro autor recibe el id y, con un desafío, la atestación, donde Kino 0.9.87 respondía permission_denied. Identidad.
  • Pantallas. En la TV el botón de un plugin mide 40 dp de alto con 14 dp a cada lado (eran 52 dp y 22 dp), y su propio padding reemplaza ese espacio (Botones); cada destino de la NavigationBar de un Scaffold conserva su desplazamiento, como cada pestaña de un TabBar (NavigationBar).
  • Lo que ve la persona. Una tarjeta de "Continuar viendo" abre la página del título, y la confirmación de instalación dice "Abrir <name>" cuando abre tu pantalla (Lo que ve la persona).

Kino 0.9.87: temas que pintan, y los datos guardados del sitio en la ventana del navegador

Disponible desde Kino 0.9.87

Los temas llegan con "apiVersion": 26, que un Kino anterior rechaza entero; collect.localStorage y doneWhen.localStorage son aditivos dentro de apiVersion 20, así que un Kino anterior los ignora y responde sin localStorage.

  • Temas que pintan (apiVersion 26). Un tema puede declarar surfaces (un relleno, un contorno y un resplandor para los botones, el menú, el riel, los botones redondos, las tarjetas, el aro de foco, el héroe y la barra de progreso), style.gloss, layout (un héroe enmarcado y un riel flotante, solo en la TV), assets (una imagen de fondo y una fuente que viajan en tu repositorio, con su hash comprobado al instalar), background.image, typography.fontFamily, y los tokens shape.heroRadius y shape.railItemRadius. Siete interruptores en Ajustes ▸ Experiencia visual dejan que la persona quite cada efecto por separado. Superficies pintadas, capas y archivos.
  • kino.visualBrowser: el localStorage de la página. collect.localStorage: ["clave", …] te entrega los valores de las claves que nombras, leídas de la página donde termina la ventana, y doneWhen.localStorage cierra la ventana cuando la página las guardó. La hoja lista las claves; storeAs sigue cubriendo solo las cookies. Las reglas y una receta.

Kino 0.9.85 y 0.9.86: streams protegidos en lista, y subtítulos con su propio texto

  • ClearKey y una lista de opciones de DRM (apiVersion 24, Kino 0.9.85). El drm de un stream puede ser una lista, la mejor opción primero, y un bloque puede ser type: "clearkey" con sus keys. En un teléfono con Widevine L1, una licencia rechazada por protección de salida se reintenta una vez en L1. Kino 0.9.85 también cambia el zoom del reproductor por un botón de formato de imagen.
  • Un subtítulo con su propio texto (apiVersion 25, Kino 0.9.86). Una entrada subtitles de un stream puede llevar su propio text descifrado (con format vtt o srt, hasta 2.000.000 de bytes) en lugar de una url; Kino lo reproduce desde un archivo local.

Kino 0.9.84: tarjetas para compartir, quién llama a una puerta y miniaturas

Disponible desde Kino 0.9.84

No hay apiVersion nuevo: un Kino anterior descarta go.plugin, ignora openFrom dentro de enhancements["20"], no tiene ctx ni kino.image e ignora la operación fullscreen.

  • go.plugin (apiVersion 20). Un botón de tu pantalla abre la pantalla de otro plugin, o su búsqueda, a partir de su repositorio: { plugin: { repo, route?, args?, query? } }, solo desde la pulsación o el envío de la persona. Kino ofrece instalarlo si falta, respeta el candado +18, pregunta «¿Activar?» si está apagado, abre la route solo si el destino la lista en openFrom.routes y, si no, busca la query en ese plugin o abre su sección. go.plugin.
  • openFrom.routes en el manifiesto (apiVersion 20, también en enhancements["20"]). De 1 a 16 rutas de tu pantalla que las tarjetas de otros plugins pueden abrir; tu pantalla lee route.args en su evento open. openFrom.
  • ctx.caller para los proveedores. Cada exportación proto_ recibe un segundo argumento, ctx, con el plugin que llama: { id, repo, name, adult } (quita el @ref de repo antes de usarlo en go.plugin). ctx.caller.
  • kino.image.thumbnail(url, { maxWidth?, maxBytes? }). Kino descarga una imagen con las reglas de red de tu plugin y responde un JPEG pequeño como data: (32 a 400 de ancho, 2.048 a 32.768 bytes, 20 por minuto). Revisa typeof kino.image === "object". kino.image.thumbnail.
  • Compartir en Kino Social. Kino Social mostrará las tarjetas en una versión posterior; hasta entonces, un plugin comparte con la llamada share de su puerta wall (Kino 0.9.81 y Kino Social 0.9.7), que deja un borrador que la persona revisa y publica. Compartir.
  • Pantalla completa. La operación ui { fullscreen: true } esconde la barra de título de Kino y las barras del teléfono para un lienzo de borde a borde, y { fullscreen: false } las devuelve. Solo tu pantalla la cambia, así que dibuja tu propia salida; el Atrás del teléfono siempre cierra la pantalla. Operaciones ui locales.
  • La «Letra» también en los podcasts. El botón «Letra» del reproductor de música sale también en los ítems podcast: la transcripción de un episodio, el texto de un audiolibro o de una lectura. Letras.

Kino 0.9.83: guardar dónde va la persona, el hueco del reproductor, e imágenes que necesitan un Referer

Disponible desde Kino 0.9.83

Un Kino anterior rechaza "apiVersion": 22 y 23, e ignora los headers de una Image.

  • Guardar dónde va la persona (apiVersion 22). La capacidad progress y kino.progress (set, get, list, clear): Kino guarda hasta dónde va la persona en un capítulo o un libro, por perfil, sincronizado entre sus aparatos y en las copias de seguridad; resume son hasta 1024 bytes de tu propio JSON que Kino nunca lee. Kino no dibuja nada: tu plugin arma su propio estante "Seguir leyendo" con list. Sin línea de consentimiento; se rechaza en un trabajo que corre para otro perfil; se puede declarar en enhancements["22"]. Guardar dónde va la persona.
  • El hueco del reproductor (apiVersion 23). La capacidad playerSlot y el bloque slot del manifiesto: hasta tres elementos pequeños (un texto, un ícono, una imagen, un botón) en la esquina superior derecha del reproductor de la TV, en películas, series y canales de En vivo, que llena tu export playerSlot(context) y que se aprietan con playerSlotAction({ id, context }). Los elementos overlay salen con los controles; uno fixed se queda y le pregunta a la persona en rojo, en cada aparato. El ejemplo es un reloj. Un texto también puede decir su size, weight, color y background, y cualquier elemento su left y top, para que la persona vista el reloj desde los ajustes del plugin (la zona horaria incluida). El hueco del reproductor.
  • La tipografía nueva de Kino, tus pantallas sin cambios. Las pantallas propias de Kino pasan a pesos más livianos en esta versión; las pantallas de los plugins conservan la escala de texto con la que se diseñaron (los encabezados siguen en negrita), así que nada cambia en tu pantalla.
  • Imágenes que necesitan un Referer. Una Image acepta headers: { Referer?, User-Agent? } (sin apiVersion nuevo), que se envían solo cuando el host de la imagen, y el del Referer, están en los hosts de tu manifiesto: lectores de manga cuyas imágenes le responden 403 a cualquier otro. Imágenes que necesitan un Referer.

Kino 0.9.82: archivos del aparato, deslizar y bordes de temas

  • Archivos del aparato (apiVersion 21). La capacidad files y kino.files: la persona elige archivos o una carpeta, el plugin recibe handles opacos, los lee por rangos o los reproduce con kino-file:<id>. No sube nada. Archivos del aparato.
  • Deslizar. onSwipeLeft y onSwipeRight en cualquier nodo (sin apiVersion nuevo; un Kino anterior los ignora); en la TV responden a Derecha e Izquierda cuando el foco no tiene más a dónde ir. Deslizar.
  • Imágenes data:. Una Image acepta data:image/png|jpeg|webp|gif;base64,… de hasta 200.000 caracteres (la portada de un libro leída de su archivo). Un Kino anterior dibuja el fallback. Image.
  • Barras y héroes. AppBar y TabBar aceptan divider: false; heroCard acepta logo (https) y h (alto); dense también aprieta la barra en la TV (8 dp); las pestañas de la TV son texto con una línea bajo la elegida.
  • Temas de la app. Bordes opcionales (colors.border y shape.dialogBorder, menuBorder, headerBorder, cardBorder, panelBorder), logo.decor y fondos claros cuando el tema trae su propio texto legible. Temas de la app.

Kino 0.9.81: una sola barra compacta y bloques de lector para las pantallas

Sin apiVersion nuevo

Estas funciones de pantalla son aditivas: necesitan la versión de Kino que las trae y nada en el manifiesto. Un Kino que no conoce una propiedad la ignora (un AppBar dibuja dos barras con su altura normal, una Image lee todo fit como cover). mergeWithKinoBar y onBack son las funciones de apiVersion 19 que se documentan abajo.

  • Recomendado para cada pantalla: una sola barra compacta. Pon mergeWithKinoBar: true y dense: true en el AppBar de cada pantalla, con un leading que sea una salida real ({ close: true } en la portada). En un celular es una barra de 56 dp en vez de unos 150 dp de encabezado; la TV ignora dense y un panel del reproductor ignora las dos. Una sola barra compacta.
  • AppBar: dense (4 dp arriba y abajo de la fila en un celular) y mergeWithKinoBar (una barra: tu leading donde estaba Cerrar, tu title donde estaba el nombre del plugin). Scaffold: onBack (Atrás te lo envía a ti en vez de salir). AppBar.
  • Lectores (manga, cómics, documentos largos): Image fit (cover, contain, width), focus y cualquier w:h en aspect; SingleChildScrollView zoom y onScroll; pages reverse (de derecha a izquierda) y progress (segments, bar, none; hasta 250 páginas con bar o none). Scroll, Image, pages.
  • Rutas: route.name es "main" cuando la pantalla se abre sin una ruta (el Home de Kino, una tarjeta, el menú). Rutas.
  • Seis recetas nuevas: una vista de búsqueda que Atrás cierra primero, un lector, un carrusel, una tarjeta del Home de Kino que abre tu pantalla, buscar dentro del campo y filtros en una hoja inferior.

  • Los tipos de plugin son dinámicos: un tipo nuevo en una entrada del catálogo, de una tienda o en un manifiesto (manga, audio-books: de 2 a 24 letras minúsculas, dígitos y guiones, empezando por una letra) aparece solo como chip de filtro, con el nombre sacado de su id. Decláralo en la entrada del catálogo: un Kino anterior a la regla rechaza un manifiesto que nombra un tipo nuevo. categories.

Kino 0.9.81: apiVersion 20, plugins que se usan entre sí y una ventana de navegador que la persona maneja

Disponible desde Kino 0.9.81

El apiVersion 20 llega con Kino 0.9.81. Todo Kino anterior rechaza un manifiesto con "apiVersion": 20 con «Este plugin necesita una versión más nueva de Kino»; un provides o un consumes dentro de enhancements["20"], en cambio, ahí se ignora. contract.json dice maxApiVersion 20.

Novedad Desde Cómo saberlo
provides en el manifiesto: hasta 4 puertas que otros plugins pueden usar, cada una con llamadas y flujos, que responden las exportaciones proto_<puerta>_<nombre> apiVersion 20, o enhancements["20"] con cualquier apiVersion un Kino anterior rechaza el apiVersion 20 e ignora el enhancement
consumes en el manifiesto y kino.plugins.call(alias, llamada, arg): usar la puerta de otro plugin a través de Kino, con siete códigos de error lo mismo typeof kino.plugins === "object"
Flujos: state.protocol.<alias>.<flujo> = true en una pantalla y el evento protocol en screenEvent apiVersion 20, con screen lo mismo
Un plugin que solo tiene provides: sin capacidades, "hosts": [] apiVersion 20 un Kino anterior rechaza el apiVersion 20
Un consumidor solo de pantalla (un consumes no vacío, capabilities exactamente ["screen"]): "hosts": [] apiVersion 20 un Kino anterior rechaza el apiVersion 20
visualBrowser en el manifiesto y kino.visualBrowser.open: una ventana web que la persona ve y maneja (para iniciar sesión, resolver una verificación), con la hoja de consentimiento propia de Kino en cada apertura apiVersion 20, o enhancements["20"] con cualquier apiVersion kino.visualBrowser es undefined en un Kino anterior; kino.visualBrowser.available es false sin WebView
storeAs.spill: una lista de cookies de más de 500 caracteres se reparte en hasta 3 ajustes password más, en un solo guardado; y el timeoutMs propio de la ventana reemplaza el límite de tiempo de la llamada que la abrió mientras está abierta apiVersion 20, con visualBrowser lo mismo
storeAs.thenEvent: cuando Kino escribe las cookies en un ajuste password, le envía a tu pantalla abierta un evento que tú eliges apiVersion 20, con screen lo mismo
La línea de consentimiento «Usa datos de <proveedor> (<resumen de la puerta>)» en la hoja de instalación de un consumidor Kino 0.9.81 —
  • El protocolo entre plugins: un plugin abre puertas (TMDB 1.3.0 y posteriores abre movies), otro las usa (el juego Cine Trivia). Kino es el único intermediario: revisa cada petición con rigor y cada respuesta con holgura contra los tipos que declaró el proveedor, máximo 64 KB en cada sentido, 10 s por llamada y 30 llamadas en cualquier ventana de 10 s por puerta. El contenido 18+ nunca llega a un plugin que no es 18+, los secretos sellados no pasan nunca y nada se instala solo: el consumidor ofrece al proveedor con go.installPlugin. Protocolo entre plugins.
  • El kit: node sdk/run.mjs --provider <carpeta> responde las llamadas de un consumidor desde un proveedor en tu computador; screenEvent protocol <alias>.<flujo> consulta un flujo una vez. Probar sin conexión.
  • Una ventana de navegador que la persona maneja: con "visualBrowser": true, kino.visualBrowser.open({ url, title, doneWhen, collect, userAgent, timeoutMs }) abre sobre tus propios hosts una ventana web que la persona ve y usa, en teléfono y tableta Android y, de forma experimental, en Android TV. Kino pregunta en su propia hoja en cada apertura, empieza con un almacén de cookies limpio, devuelve cookies, el HTML de la página o su última dirección y, con collect.storeAs, escribe las cookies directo en uno de tus ajustes password (thenEvent le avisa a tu pantalla cuándo). La receta "Vincular cuenta" está en la página; enhancements ahora puede llevar visualBrowser. Una ventana de navegador que la persona maneja.

Kino 0.9.81: apiVersion 19, letras y go.installPlugin

Disponible desde Kino 0.9.81

El apiVersion 19 llega con Kino 0.9.81. Todo Kino anterior rechaza un manifiesto con "apiVersion": 19 con «Este plugin necesita una versión más nueva de Kino». contract.json dice maxApiVersion 19.

Novedad Desde Cómo saberlo
La capacidad lyrics y la exportación lyrics(query): la letra sincronizada o en texto plano de una canción, para la «Letra» del reproductor de música apiVersion 19 un Kino anterior rechaza el apiVersion 19
go.installPlugin: un botón en tu pantalla que abre la hoja de instalación propia de Kino para el repositorio de otro plugin apiVersion 19, con screen por debajo de 19 el go se descarta, con registro
recommends en el manifiesto e installed en screen y screenEvent: si cada plugin recomendado está instalado ahora Kino 0.9.81, con cualquier apiVersion un Kino anterior ignora el campo; installed no llega
  • Letras: un plugin responde { synced?, plain?, label?, instrumental?, matchDurationMs? } para la canción que suena; la persona elige la fuente cuando varios plugins responden. Letras para el reproductor de música.
  • Instalar otro plugin desde el tuyo: go.installPlugin abre la hoja de instalación de siempre de Kino encima de tu pantalla, y solo el Instalar de la propia persona lo instala; con recommends, tu pantalla sabe cuáles de esos plugins están instalados y Kino la vuelve a dibujar cuando eso cambia. go.installPlugin.
  • Pantallas: Scaffold.onBack y AppBar.mergeWithKinoBar son funciones de apiVersion 19 (una sola barra compacta), y un TextField esconde el teclado cuando se envía.

Kino 0.9.81: apiVersion 18, temas de la app

Disponible desde Kino 0.9.81

apiVersion 18 llega con Kino 0.9.81. Todo Kino anterior rechaza un manifiesto con "apiVersion": 18 con «Este plugin necesita una versión más nueva de Kino». contract.json dice maxApiVersion 18.

Función Desde Cómo saberlo
appThemes en el manifiesto: de 1 a 8 temas para toda la app, como datos (39 tokens, un fondo, tv/phone, adjustable, pluginColors) apiVersion 18 un Kino más viejo rechaza apiVersion 18; por debajo de 18 el campo se ignora
El price de un tema (kinos de 1 a 1000, payTo la cuenta de kinos del autor, 64 hex), que se compra una vez por cuenta en la hoja propia de Kino apiVersion 18 lo mismo
La experience de un tema ("light" o "full"), que se pregunta con el consentimiento de la persona al activar el tema apiVersion 18 lo mismo
El logo vectorial de un tema (wordmark, mark) en el menú, la cabecera y el riel del TV apiVersion 18 lo mismo
go.useTheme y go.setExperience en la pantalla propia del plugin; activeTheme en screen y screenEvent apiVersion 18, con screen lo mismo
La categoría themes de la tienda; "hosts": [] en un plugin que solo trae appThemes apiVersion 18 para hosts: [] lo mismo
  • Temas de la app: un plugin puede cambiar el aspecto de toda la app (colores, fondo, esquinas, tamaño del texto, sombras, movimiento, tamaño de los controles del reproductor, su propio logo). Kino mantiene los pares de legibilidad (texto 4,5:1, acento y foco 3:1, un fondo oscuro por ahora), deja que mande el aparato (efectos reducidos, esquinas redondeadas apagadas) y nunca cambia sus pantallas de decisión, la puerta de entrada ni la pantalla de inicio. La persona elige un tema por perfil en Ajustes ▸ Apariencia, ajusta lo que el autor permite, y la elección se sincroniza. Temas de la app.
  • Vender un tema: con price, Kino le pide a la persona comprarlo antes de activarlo, le muestra el precio y su saldo, y le paga al autor; el plugin no necesita la capacidad coins y nunca ve la compra. Temas con precio.
  • Pantallas: un botón en la pantalla propia del plugin activa o desactiva uno de sus temas (go.useTheme, con el aviso de Kino «Tema aplicado») o pide la experiencia ligera o completa (go.setExperience, Kino pregunta antes). screen y screenEvent reciben activeTheme. go.useTheme.

Kino 0.9.81: apiVersion 17, tu mes en Kino, trabajos por perfil y más pantallas

Disponible desde Kino 0.9.81

apiVersion 17 llega con Kino 0.9.81. Una versión anterior rechaza un manifiesto con "apiVersion": 17 con «Este plugin necesita una versión más nueva de Kino». contract.json dice maxApiVersion 17.

Función Desde Cómo saberlo
kino.library.stats: los números de un mes (month como yyyy-mm, el actual por defecto), nada más fino; top de hasta 20 títulos; comparte las 30 llamadas por minuto de watched y saved; nunca +18 apiVersion 17, con la capacidad library un Kino más viejo rechaza apiVersion 17
Trabajos con perProfile apiVersion 17 lo mismo
kino.tmdb dentro de un trabajo apiVersion 17 lo mismo
Corridas de IA de 60 s y 20 peticiones apiVersion 17, con ai aprobada lo mismo
El widget pages y el estilo de texto hero apiVersion 17 lo mismo (un Kino anterior dibuja hero como p)
Las respuestas share y enableJob apiVersion 17 lo mismo
go.search con "scope": "all" y go.syncProvider apiVersion 17 lo mismo
  • Tu mes en Kino: kino.library.stats deja leer los hábitos de un mes de la persona (agregados, no filas) con su aprobación de library. Salas, biblioteca y control del reproductor.
  • Trabajos por perfil: un trabajo con perProfile corre una vez por cada perfil del aparato. El consentimiento es una fila propia de Kino (cada perfil puede quedar fuera), el trabajo entrega su resultado con kino.shared y se salta el trabajo si ya llegó uno fresco. Un manifiesto con perProfile y un apiVersion menor se rechaza. Trabajos, resultados compartidos e IA.
  • kino.tmdb en un trabajo y más espacio para la IA: un plugin con ai aprobada tiene corridas de 60 s y 20 peticiones (antes, 20 s y 10). Trabajos, resultados compartidos e IA.
  • Pantallas: el widget pages (páginas a pantalla completa bajo la barra de progreso de Kino, que se pasan con el dedo en el celular y con Izquierda y Derecha en el TV), el estilo de texto hero (un número grande, un paso encima de h1), la respuesta share (Kino dibuja un nodo como imagen y abre el menú de compartir del sistema, solo tras un toque de la persona), la respuesta enableJob (enciende la fila de Kino de un trabajo, solo tras un toque), go.search con "scope": "all" (la búsqueda normal de Kino en todas las fuentes) y go.syncProvider (abre los ajustes del proveedor de sincronización). Pantallas y componentes.

Kino 0.9.78: apiVersion 16, monedas de Kino, y kino.sync.setActive

Disponible con Kino 0.9.78

apiVersion 16 y kino.sync.setActive llegan con Kino 0.9.78. Una versión anterior rechaza un manifiesto con "apiVersion": 16.

Función Desde Cómo saberlo
La capacidad coins y kino.coins.balance() / kino.coins.give({ to, postId }) apiVersion 16 typeof kino.coins === "object"
kino.sync.active() y kino.sync.setActive(on), con la capacidad syncProvider Kino 0.9.78, con cualquier apiVersion del manifiesto typeof kino.sync.setActive === "function"
  • Monedas de Kino (coins): las monedas de Kino son una moneda gratuita compartida por todo Kino: la persona gana 1 cada 10 minutos que ve, hasta 20 por día UTC, y las regala de una en una. kino.coins.balance() responde { balance, earnedToday, capToday } y kino.coins.give({ to, postId }) regala UNA moneda a la cuenta to por la publicación postId. Es una capacidad declarativa que no va sola, no se ofrece con enhancements y se aprueba con una línea de consentimiento en rojo. Si la persona apaga las monedas en los ajustes de Kino, el plugin no debe mostrar nada de ellas. El cliente de Kino habla con el servicio de monedas: tu plugin nunca conoce su dirección ni su sesión.
  • Cambiar de proveedor desde el plugin: kino.sync.active() dice si este plugin es el proveedor de sincronización de este aparato y kino.sync.setActive(on) lo cambia. Encender pregunta a la persona con el diálogo de Kino (rechazar responde false y no cambia nada); apagar no pregunta y vuelve a la sincronización local de Kino. Solo corre desde un toque de la persona, nunca desde un trabajo. No es un apiVersion: detéctalo con typeof kino.sync.setActive === "function". Proveedores de sincronización.

Kino 0.9.77: apiVersion 15, identidad, avisos y tiendas de plugins

Disponible con Kino 0.9.77

Disponible con Kino 0.9.77. Una versión anterior rechaza estos plugins con «Este plugin necesita una versión más nueva de Kino»; ninguna de las novedades se ofrece con enhancements.

Documentado el 2026-10-29. contract.json dice maxApiVersion 15; apiVersion 15 llega con Kino 0.9.77. El kit de Node ya lo conoce todo (Probar en local).

Función Desde Cómo saberlo
La capacidad identity y kino.identity.telegram apiVersion 15 typeof kino.identity === "object"
La capacidad notifications, kino.notifications.post y clear apiVersion 15 typeof kino.notifications === "object"
La capacidad pluginStore, el bloque pluginStore del manifiesto y los exports storeSync, storeList y storeSearch apiVersion 15 un Kino más viejo rechaza apiVersion 15
season y episode en kino.library.watched() de una serie Kino 0.9.77, con la capacidad library los campos solo están en una serie vista
  • Identidad: el servidor de tu plugin sabe quién es la persona sin un registro, con un seudónimo por plugin y un token firmado, ligado a este aparato y a tu código con un desafío. Solo responde a plugins firmados con la llave de autor de Kino. Identidad.
  • Avisos: tu plugin deja avisos cortos en la campanita de Inicio, desde una pantalla o su trabajo en segundo plano. Avisos en la campanita.
  • Tiendas de plugins: un plugin que es una fuente de plugins para la tienda de Kino (local, con una lista que entrega en segundo plano, o en vivo, con su propia API). Kino pinta la tienda desde un índice local, mezcla las tiendas, aplica su lista de bloqueo y el código +18, y instala con su hoja de consentimiento. La vista de la tienda tiene las pestañas «De Kino», «De la comunidad» e «Instalados»; un ícono de recargar termina con un aviso. Un plugin por id en todas las tiendas; una tienda cuyas filas perdió Kino se sincroniza desde cero (sin since ni state: responde la lista completa); la lista de bloqueo se refresca con cada sincronización. Con Kino Plugins, la tienda que viene en la app, la app ya no busca en GitHub por su cuenta. Tiendas de plugins y dos tiendas de ejemplo; node sdk/init.mjs mi-tienda --store local|live.
  • La biblioteca: una serie vista trae season y episode. Salas, biblioteca y control del reproductor.

Kino 0.9.74: apiVersion 14, pantallas del plugin

Disponible con Kino 0.9.74

Disponible desde Kino 0.9.74. Una versión anterior de Kino rechaza estos plugins con «Este plugin necesita una versión más nueva de Kino»; para seguir llegando a quien tiene una versión anterior usa enhancements (ver Pantallas sin subir tu apiVersion).

Documentado el 2026-10-28. apiVersion 12, 13 y 14 llegan juntos con Kino 0.9.74: contract.json dice maxApiVersion 14 y apiVersionFromApp da 0.9.74 para las tres. El kit de Node ya lo conoce todo (Probar en local).

Función Desde Cómo saberlo
La capacidad screen, los exports screen y screenEvent y el bloque screen del manifiesto apiVersion 14 kino.screen es undefined en un Kino anterior
playerPanelTab (una pestaña en el panel del reproductor de cualquier título, también en canales en vivo con "kinds": ["live"]), el panel en modo pantalla y el panel fijo apiVersion 14 un Kino más viejo rechaza apiVersion 14
library, playerControl y room (kino.library, kino.room) apiVersion 14 lo mismo
schedule (el bloque jobs y el export job), shared (kino.shared) y ai (kino.ai) apiVersion 14 lo mismo
unlockWith en un toggle o un select apiVersion 14 por debajo la clave se ignora
maxBytes y stopAt en kino.fetch, r.truncated apiVersion 14 por debajo las opciones se ignoran
El bloque enhancements del manifiesto Kino 0.9.74, con cualquier apiVersion un Kino anterior lo ignora
kino.qr.scan desde un screenEvent que sigue a un toque de la persona apiVersion 14 —
Exportar e importar un plugin como archivo .kinoplugin Kino 0.9.74, cualquier apiVersion nada que revisar
  • Pantallas: tu plugin dibuja una pantalla completa dentro de Kino con un árbol JSON de componentes al estilo Flutter (Scaffold, AppBar, TabBar, ListTile, Card, formularios, el nodo settings, tablas, acordeones, ventanas emergentes ancladas, toasts, banners, las tarjetas y filas de pósteres de Kino), con valores por tamaño, en el celular y en el TV desde el mismo árbol. Kino guarda el estado, valida el árbol y descarta lo que está mal sin cerrarse. Pantallas, y el catálogo: diseño, contenido y acciones, formularios, ventanas y navegación, estado, estilo y recetas.
  • Panel del reproductor: el panel puede usar el kit de pantallas, una pestaña puede ir en el panel del título de otro plugin o de un canal en vivo, y el panel se puede fijar al lado del video. Panel del reproductor.
  • Salas, biblioteca y control del reproductor: kino.room abre salas por internet alojadas en el aparato de la persona, kino.library lee lo que vio y guardó, playerControl deja pausar y mover el video desde el panel. Salas, biblioteca y control del reproductor.
  • Trabajos en segundo plano, resultados compartidos e IA: job(ctx) corre cada cierto tiempo, kino.shared sincroniza unos pocos resultados entre los aparatos de la persona, kino.ai.ask le hace una pregunta corta a la IA de texto de Kino. Trabajos, resultados compartidos e IA.
  • Sin subir tu apiVersion: enhancements ofrece todo esto a quien tiene Kino 0.9.74 y deja tu plugin igual para los demás. Pantallas sin subir tu apiVersion.
  • Un ajuste que guarda el código +18: "unlockWith": "adultCode". Formulario de ajustes.
  • Leer solo la cabecera de una página: kino.fetch con maxBytes y stopAt. API kino.
  • Un plugin como archivo: Kino exporta un plugin instalado como .kinoplugin y lo importa como plugin local. Exportar e importar un plugin.
  • Plugins más grandes: src/ empaquetado con esbuild, con check:built. Estructurar un plugin grande.
  • Ejemplos: kino-plugin-ui-gallery, kino-plugin-news (Solo noticias) y kino-plugin-watch-party (Party Chat).

Kino 0.9.74: apiVersion 13, sockets, bytes e imágenes que sirve el plugin, un catálogo, códigos QR

(Publicada el 29 de octubre de 2026.) apiVersion 13 = Kino 0.9.74, junto con apiVersion 12 (abajo). El contrato (contract.json) dice maxApiVersion 13 y apiVersionFromApp da 0.9.74 para las dos. Todo Kino anterior a 0.9.74 rechaza un manifiesto con "apiVersion": 13 ("Este plugin necesita una versión más nueva de Kino"), así que declara 13 solo si usas una de sus funciones. El kit de Node ya lo conoce todo.

Función Desde Cómo saberlo
La capacidad socket y kino.ws (frames hex/base64) apiVersion 13 no hay nada que revisar: un Kino más viejo rechaza apiVersion 13
La capacidad byteSource, los streams { source: "plugin", handle, size, mime } y el export read apiVersion 13 lo mismo
La capacidad storageLarge (kino.storage de 16 MB, solo en el aparato) apiVersion 13 lo mismo
La capacidad catalog y kino.catalog apiVersion 13 lo mismo
La capacidad qrScan, kino.qr.scan y el tipo de ajuste qr apiVersion 13 lo mismo
La capacidad imageSource, las imágenes { source: "plugin", handle } y el export image apiVersion 13 lo mismo
kino.crypto.aesIge, aesIgeVerify, modPow, gunzip, convert Kino 0.9.74 (kino.apiVersion 13), con cualquier apiVersion en el manifiesto typeof kino.crypto.convert === "function"
"sync": false en un ajuste password (se queda en este aparato) apiVersion 13 nada que revisar: un Kino más viejo ignora la clave y sincroniza la contraseña
Las respuestas de kino.* con await se liberan cuando tu código las tiene; recolección de basura después de una llamada que pasa la mitad de los 64 MB; atob/btoa más rápidos Kino 0.9.74, cualquier apiVersion nada que revisar
  • Sockets (socket): kino.ws.open("wss://…") a un host que declaras, solo por el puerto 443, máximo 4 sockets, 8 MiB en cola por socket, 786.000 bytes por frame; frames como Uint8Array o, mucho más rápido, como textos hex/base64. Sockets y bytes del plugin.
  • Bytes que sirve el plugin (byteSource): resolve() responde un stream sin URL y Kino le pide a tu read 1 MiB a la vez, lo reproduce en su reproductor y lo envía a Chromecast y DLNA desde el teléfono. Un ejemplo completo sobre un WebSocket, con su prueba: Sockets y bytes del plugin.
  • Un catálogo propio (catalog): kino.catalog guarda hasta 100.000 ítems en un archivo SQLite por plugin y busca en ellos (cada palabra, sin mayúsculas ni tildes, sin SQL de tu lado); solo en el aparato, nunca se sincroniza, no va en las copias de seguridad. storageLarge deja kino.storage en 16 MB para unos pocos valores grandes, también solo en el aparato. Catálogo y almacenamiento grande.
  • Códigos QR: el tipo de ajuste qr dibuja un QR con lo que devuelve tu settingsStatus() y lo refresca cada refreshMs; kino.qr.scan() (qrScan) abre el lector de cámara del teléfono desde una acción de los ajustes o del panel. Una receta de inicio de sesión entre dos aparatos: Códigos QR.
  • Imágenes del plugin (imageSource): un poster, un backdrop, un still o la image del encabezado de una sección puede ser { source: "plugin", handle }; Kino le pide los bytes a tu export image (máximo 256 KB, JPEG, PNG o WebP) cuando la tarjeta aparece en pantalla, una a la vez, nunca mientras se reproduce uno de tus streams de bytes. Imágenes del plugin.
  • Operaciones de bytes en kino.crypto: AES-256-IGE, un descifrado revisado con su MAC SHA-256 en una sola llamada, modPow de números grandes, gunzip y un convert nativo entre utf8, hex y base64. Dependen de la versión de Kino, no de tu manifiesto (Kino 0.9.74 tiene las cinco, un Kino más viejo ninguna): revisa cada una. Operaciones de bytes.
  • El kit: run.mjs . resolve acepta streams de bytes, run.mjs --size <bytes> . read … y run.mjs --out <archivo> . image … llaman tus exports como Kino (askRead, askImage desde las pruebas), e init.mjs --with byteSource,images,catalog,socket arma un plugin de apiVersion 13. Probar en local.
  • Una contraseña que se queda en un aparato: un ajuste password puede decir "sync": false (una contraseña de verificación en dos pasos que se manda una vez y se borra): nunca se envía a un aparato emparejado, no va en copias de seguridad ni en kits. Formulario de ajustes.
  • Memoria del motor (Kino 0.9.74, cualquier apiVersion): la respuesta de una llamada kino.* con await ya no se queda en tus 64 MB hasta que se cierra el sandbox, y Kino recoge la basura después de una llamada que deja el motor por encima de la mitad de su límite. Cómo vive tu código.

Agregado a apiVersion 13 el 2026-10-25: proveedores de sincronización y el formulario de ajustes

Sigue siendo apiVersion 13 y Kino 0.9.74, agregado para el proveedor de sincronización con cuenta Sync-Gram Cuenta. Un Kino más viejo rechaza apiVersion 13, así que no hay nada que revisar.

Función Desde
syncProvider (o subtitles, tracking, segments) junto a socket, storageLarge, catalog y qrScan no necesita resolve, search ni home apiVersion 13
El setSettings de una acción puede llenar uno de tus propios ajustes password apiVersion 13
sync.provision puede nombrar una contraseña con "sync": false, un secreto de un solo uso para el aparato nuevo apiVersion 13
sync.generateKey: true: Kino crea él mismo el valor de keySecret apiVersion 13
Una respuesta de settingsStatus puede llevar hide: [claves de ajustes]; un ajuste qr sin texto no dibuja nada apiVersion 13
Un ajuste text puede decir "sync": false apiVersion 13
  • Independiente con espacio de ejecución: un proveedor de sincronización que habla por un WebSocket declara ["syncProvider", "socket"] (y storageLarge, catalog o qrScan si los necesita) y sigue sin exportar resolve, search ni home. El manifiesto.
  • setSettings llena una contraseña: se guarda sellada como una escrita, nunca se registra y se borra del message y del link de la respuesta; el kit la muestra con asteriscos. Llenar una contraseña.
  • Un secreto de un solo uso en provision: una contraseña con "sync": false (una contraseña de dos pasos que el TV no debería escribir) va con "Enviar configuración" solo mientras tiene valor, la pantalla que envía la nombra en una línea y el aparato que recibe la guarda sellada y solo ahí; nunca como keySecret. Proveedores de sincronización.
  • sync.generateKey: para un proveedor cuyo servicio no tiene secreto compartido (la propia cuenta de la persona), Kino escribe 32 bytes aleatorios en hexadecimal en el ajuste keySecret vacío cuando se enciende el proveedor y cuando se toca "Enviar configuración"; sin paso "Crear clave". Una llave que crea Kino.
  • hide en settingsStatus: hasta 32 claves de tus ajustes que el formulario no dibuja mientras esa respuesta sea la vigente (los valores se quedan); un qr sin texto no dibuja nada. Esconder lo que no hace falta.
  • Un text que se queda en el aparato: "sync": false en un text (un número de teléfono que se ve tal cual): nunca se sincroniza, no va en copias de seguridad ni en sync.provision. Un valor que se queda en este aparato.
  • Lo que ve la persona (sin cambio de contrato): los botones para pasar los ajustes ahora son "Enviar configuración" y "Recibir configuración", el botón de ajustes en la tarjeta de un proveedor es "Configurar" en celular y TV, las tarjetas siguen el estado del proveedor (en un aparato al que le faltan los ajustes, "Recibir configuración" va primero), la línea roja de consentimiento se queda en la hoja de instalación y en la confirmación al encenderlo, una cámara rechazada dice cómo activarla, y desinstalar el proveedor activo avisa que la sincronización se apaga.
  • Un tercer proveedor de ejemplo: Sync-Gram Cuenta sincroniza por la propia cuenta de Telegram de la persona (MTProto sobre kino.ws), firmado, en ningún catálogo: se instala pegando kinotvapp/kino-plugin-sync-gram-account. Los tres proveedores de ejemplo.

Kino 0.9.74: apiVersion 12, proveedores de sincronización, link y help, setSettings y "¿Eres tú?"

(Publicada el 29 de octubre de 2026.) apiVersion 12 = Kino 0.9.74. El contrato (contract.json) dice ahora maxApiVersion 13 y kino.apiVersion informa 13, porque apiVersion 13 sale en la misma versión. Kino 0.9.73 y anteriores rechazan un manifiesto con "apiVersion": 12 ("Este plugin necesita una versión más nueva de Kino"), así que declara 12 solo si usas algo de esta versión.

Qué Desde Cómo saberlo
La capacidad syncProvider (syncPull, syncPush, syncStatus opcional) y el bloque sync del manifiesto Kino 0.9.74, apiVersion 12 nada que revisar: un Kino anterior rechaza apiVersion 12
Los tipos de ajuste link y help Kino 0.9.74, apiVersion 12 nada que revisar: un Kino anterior rechaza apiVersion 12
devices en los ajustes y linkOnly en una acción Kino 0.9.74, apiVersion 12 nada que revisar: un Kino anterior rechaza apiVersion 12
kino.sync.remoteChanged() para un proveedor realtime Kino 0.9.74 typeof kino.sync === "object"
Las respuestas setSettings y link de una acción Kino 0.9.74, cualquier apiVersion nada que revisar: un Kino anterior ignora las dos, así que di también en message qué hacer
Topes de kino.fetch ampliados dentro de syncPull/syncPush Kino 0.9.74 solo dentro de esas dos llamadas
  • Proveedores de sincronización (apiVersion 12): un plugin puede ser el transporte de la sincronización entre los aparatos de la persona. Kino se queda con la lógica, cifra la copia y le pasa a tu syncPush un blob opaco en base64 (como mucho sync.maxBlobBytes, 4 MiB) para guardarlo, y tu syncPull lo devuelve byte por byte, con una version tuya; kino.error("conflict", …) hace que Kino traiga, combine y vuelva a enviar. El bloque sync del manifiesto fija cada cuánto (poll o realtime), el tamaño del blob, el keySecret obligatorio (Kino deriva la llave de sincronización de uno de tus ajustes password en cada aparato, así que ninguna llave viaja y el plugin y su servicio pueden leer los datos) y el provision obligatorio (los ajustes que "Enviar configuración" le pasa a un segundo aparato, por la red local o por un túnel rápido de Cloudflare). La capacidad puede ser la única de un plugin. Proveedores de sincronización.
  • Consentimiento: una línea en rojo, "Sincronizará tus datos a través de su servicio: el plugin y su servicio podrán leerlos". Una actualización que agrega la capacidad siempre espera la aprobación de la persona.
  • Ayudas para configurar (apiVersion 12): un ajuste link (un botón que abre una dirección https por el sistema solo cuando la persona lo toca; en un TV, la dirección y un QR) y un ajuste help (un botón que abre tus instrucciones en texto plano en una ventana), máximo 4 de cada uno. Ayudas para configurar.
  • devices (apiVersion 12): cualquier elemento de los ajustes puede dibujarse solo en el celular (["phone"]) o solo en el TV (["tv"]); el valor sigue guardado, sincronizado y provisionado. Ajustes para un tipo de aparato.
  • linkOnly (apiVersion 12): una acción que nunca se dibuja y solo corre como confirm de un link. Acciones que solo corre un link.
  • Lo que Kino agrega a un proveedor: la página de cada proveedor empieza con el botón "Sincronización ▸ Proveedor"; cada proveedor es su propia tarjeta en esa lista, con "Sincronizar cada" (1 a 60 minutos, por aparato; pullEveryMs es solo el valor de partida). Proveedores de sincronización.
  • setSettings (Kino 0.9.74, aditivo): una acción puede llenar hasta 8 de tus ajustes text o select, guardados como si la persona los hubiera escrito; nunca un url, y un password solo desde apiVersion 13. Llenar ajustes propios.
  • "¿Eres tú?" (action.link, Kino 0.9.74, aditivo): una acción responde link: { candidate, confirm } y Kino le pregunta a la persona con sus propias palabras antes de correr la acción confirm. Vincular.
  • El registro de las peticiones de un plugin guarda solo el host: la línea de Kino por cada kino.fetch de un plugin ahora lleva el método, el host, el estado, el tamaño y el tiempo, nunca la ruta ni la query (un token de bot en la ruta, como en la Bot API de Telegram, nunca llega a un registro).
  • Dos proveedores de ejemplo, repositorios públicos: Sync-Gram (kinotvapp/kino-plugin-sync-gram, un bot de Telegram de la persona, recomendado) y Sync Servidor (kinotvapp/kino-plugin-sync-server, un servidor que corre la persona, no listado). Los dos proveedores de ejemplo.

Kino 0.9.71: apiVersion 11, kino.nuvio

  • Un plugin puede usar los scrapers de un repositorio de Nuvio. Declaras la capacidad nuvio y nuvioRepos (de 1 a 4 repositorios) y, dentro de tus funciones, llamas a kino.nuvio.available, use, scrapers y streams: Kino instala los scrapers como la importación, sin pantallas, les pregunta por un título y tú ordenas, mezclas y etiquetas las copias. Los scrapers quedan bajo tu plugin y se quitan con él; los de solo torrents nunca se instalan. Experimento: detéctalo con typeof kino.nuvio === "object". Plugins que usan scrapers de Nuvio.

Home por categorías, genre abierto en las filas

  • genre en una fila de Inicio acepta cualquier categoría. Antes eran diez ids cerrados. Ahora un id o alias conocido (en español o inglés: "Action", "Acción", "Thriller", "Sci-Fi & Fantasy"…) se lleva al id base, y cualquier otra cosa se guarda como un slug (minúsculas ASCII [a-z0-9-], hasta 40 caracteres) que se agrega al final, después de las conocidas. Las categorías en vivo y las listas siguen con los diez ids. Las versiones anteriores de Kino ignoran un valor fuera de esos diez. Home por categorías.
  • Home por categorías (opcional para la persona): una sola lista de filas por categoría (filas de género con todos los tipos mezclados, una fila completa por tipo temático como Anime o Infantil, sin pestañas), una tarjeta por título, armado solo con lo que tus filas de Inicio ya dejaron guardado. Declara genre en cada fila y genres en cada ítem, de preferencia con los ids del vocabulario, y manda ids/TMDB y year para que un título sea una sola tarjeta entre fuentes. Qué hace el Inicio con tus categorías.

Kino 0.9.66: apiVersion 11, apps resolutoras externas, media y portable

apiVersion 11 = Kino 0.9.66. El contrato (contract.json) dice ahora maxApiVersion 11 y kino.apiVersion informa 11. Kino 0.9.65 y anteriores rechazan un manifiesto con "apiVersion": 11 ("Este plugin necesita una versión más nueva de Kino"), así que declara 11 solo si usas externalResolve.

  • externalResolve (apiVersion 11): una capacidad declarativa (no hay nada que exportar). Una respuesta de resolve(), o una entrada de las alternatives de un Stream, puede ser { external: { protocol, ref, resolver? } } en vez de una url reproducible: Kino le pasa ref a una app instalada por separado que declara resolver protocol, después de que la persona permite esa app para tu plugin, y reproduce la respuesta que recibe (validada como la tuya, con los hosts juzgados como en la respuesta de cualquier resolutor). Tu plugin nunca sabe qué app lo atendió. Aplicaciones resolutoras externas, el contrato.
  • externalResolver (campo del manifiesto, apiVersion 11): { package, apk?: { url, sha256, label? }, fdroid?: true, downloader?: { code } } nombra la única app que quieres (a ninguna otra se le pregunta) y dónde puede Kino ofrecer descargarla, de un release de GitHub, comprobada contra el sha256; fdroid: true y un code de Downloader (se muestra, Kino nunca lo instala) son dos formas más, opcionales, de conseguirla. El manifiesto.
  • media (la descripción opcional e informativa de un stream sobre el archivo: contenedor, video, pistas de audio y subtítulos, si se convirtió) y portable (una copia HLS universal del mismo video, hecha bajo demanda, que Kino puede enviar a la TV): se leen de la respuesta de cualquier plugin o resolutor, en cualquier apiVersion; un Kino más viejo ignora las dos. Las reglas del Stream.
  • Lo que ve la persona: una pregunta de consentimiento la primera vez que se necesita una app, "Abriendo con ..." con el progreso en vivo de la app y Cancelar y, cuando falla, la frase corta de la propia app junto al código ("No se pudo resolver este contenido (timeout): ..."). Lo que ve la persona.
  • Enviar a la TV un título de un resolutor pasa por el proxy de cast de Kino; está cubierto por pruebas con un resolutor falso y se probó con un Chromecast real (un archivo directo, un HLS convertido con renditions, una copia portable); DLNA se probó en una TV LG webOS: el HLS reproduce (la ruta de TS continuo no). Enviar a la TV un título de un resolutor.

Kino 0.9.65: apiVersion 10, la capacidad playlists

apiVersion 10 = Kino 0.9.65. El contrato (contract.json) dice ahora maxApiVersion 10 y kino.apiVersion informa 10. Kino 0.9.64 y anteriores rechazan un manifiesto con "apiVersion": 10 ("Este plugin necesita una versión más nueva de Kino"), así que declara 10 solo si usas la capacidad playlists.

  • playlists (apiVersion 10): el SDK ahora acepta que un plugin declare esta capacidad -- el contrato para que, el día que la interfaz de Kino se conecte a ella, un plugin pueda exponer, dentro de "Mis listas", las listas que la persona ya tiene en la cuenta de tu servicio, junto a las suyas. Por ahora ningún plugin instalado ni anunciado la usa, y esa conexión con la interfaz todavía no existe. Seis exports, todos independientemente opcionales -- a diferencia de channels, que exige dos --, ni siquiera playlists() mismo: playlists(), playlistItems({ playlistId, cursor }), playlistCreate({ title }), playlistAddItem({ playlistId, ref }), playlistRemoveItem({ playlistId, ref }) y playlistReorder({ playlistId, refs }). No tiene nada que ver con KinoPlaylist (la lista M3U/IPTV de En vivo) ni con el kind: "playlist" que firma sign(). Playlists.

Kino 0.9.55: apiVersion 9, panel del reproductor, fetchHosts en plugins escritos a mano, textos en inglés, kino.meta por título

(Publicada el 8 de octubre de 2026.) apiVersion 9 = Kino 0.9.55. El contrato (contract.json) ahora dice maxApiVersion 9 y kino.apiVersion informa 9. Kino 0.9.54 y anteriores rechazan un manifiesto con "apiVersion": 9 («Este plugin necesita una versión más nueva de Kino»), y todas las novedades piden apiVersion 9: por debajo, Kino las ignora como lo hace una versión anterior.

Novedad Desde Cómo saberlo
Panel del reproductor: panel, panelAction, playerEvent, el campo panel y las propiedades del reproductor Kino 0.9.55, apiVersion 9 nada que revisar: un Kino anterior rechaza apiVersion 9; no dependas de él para reproducir
settingsLayout: filas, columnas y tarjetas en tus ajustes Kino 0.9.55, apiVersion 9 nada que revisar: por debajo de 9, o en un Kino anterior, se ve la lista de siempre
"fetchHosts": "any" en un plugin escrito a mano Kino 0.9.55, apiVersion 9 kino.fetchAnyHost === true (aprobado por la persona)
Textos de ajustes y de section en inglés (labelEn, hintEn, confirmEn) Kino 0.9.55, apiVersion 9 nada que revisar: por debajo de 9, o en un Kino anterior, se ven los de siempre
kino.meta({ type, title, year? }) sin ids Kino 0.9.55, apiVersion 9 kino.meta.byTitle === true
kino.device: "tv" o "phone", la interfaz que Kino muestra en este aparato Kino 0.9.55, todo apiVersion kino.device === "tv" (undefined antes)
kino.seed(session): compartir una sesión de invitado anónima de tu fuente (requiere el consentimiento de telemetría de la persona) Kino 0.9.55, todo apiVersion typeof kino.seed === "function"
  • El panel del reproductor (apiVersion 9). Un botón junto al de subtítulos, solo mientras suena un título tuyo, abre un panel que armas con panel(context): texto, imágenes, botones, interruptores, listas y campos, en filas, columnas y tarjetas, con pestañas, y con valores que se guardan por video o para todo tu plugin y se sincronizan. panelAction(event, context) responde a cada botón o campo (con panel, patch, values, save, focus, message y player), y el manifiesto lleva "panel": { "label", "icon" | "iconFile" } (un PNG de 96×96). El panel del reproductor.
  • Propiedades del reproductor (apiVersion 9): player en la respuesta de panelAction y playerEvent mueve el reproductor: seekToMs, seekStepMs (5 a 120 s), speed, resize, skip, markers (hasta 30 puntos en la barra) y autoNext (cuenta regresiva al siguiente episodio, o { enabled: false }). Lo que la persona hace a mano gana. Controlar el reproductor.
  • playerEvent(event, context) (apiVersion 9): te avisa de started, paused, resumed, ended, failed y copyChanged mientras suena un título tuyo; sin esperar tu respuesta, 5 s, uno a la vez. playerEvent.
  • settingsLayout (apiVersion 9): acomoda los ajustes que ya declaraste en filas, columnas y tarjetas, sin quitar ninguno. settingsLayout.
  • "fetchHosts": "any" para tu plugin (apiVersion 9): hasta ahora solo lo respetaba en los scrapers de Nuvio que convierte. Desde Kino 0.9.55 un plugin escrito a mano con "apiVersion": 9 y "fetchHosts": "any" puede llegar con kino.fetch a hosts que no declaró (redirecciones incluidas), solo por https en el puerto 443 y a un nombre con punto o una IPv4 pública, para sitios y extractores que cambian de dominio. Esas peticiones gastan un cupo por plugin (60 por minuto a un mismo sitio, 600 cada 10 minutos; pasado el cupo, rate_limited); tus hosts declarados conservan sus reglas y no lo gastan, así que declara tus sitios principales. La persona lo aprueba en rojo ("Puede conectarse a cualquier servidor público de internet (solo https, nunca tu red local)") y una actualización que lo agrega espera su aprobación otra vez, también la primera vez que se abre Kino después de actualizarlo; la red de la casa sigue rechazada y un secreto sellado solo va a tus hosts. En las páginas ocultas, la dirección inicial y cada navegación principal siguen la misma regla. Un host_not_allowed de kino.fetch trae ahora e.host. kino.fetchAnyHost es true cuando está activo (false si no; undefined en un Kino anterior). Por debajo de apiVersion 9 nada cambia. Conectarse a cualquier servidor.
  • Tu formulario de ajustes y tu sección, también en inglés (apiVersion 9). Cada ajuste puede llevar labelEn y hintEn (un action con confirm, también confirmEn), cada opción de un select y cada campo de una list su labelEn, y section del manifiesto su labelEn, con los mismos límites que el texto de siempre. Con la app en inglés Kino los muestra; el texto de siempre sigue siendo el español y el de respaldo donde falte uno. Por debajo de apiVersion 9 son claves desconocidas: se ignoran sin revisarlas. Textos en inglés.
  • kino.meta por título (apiVersion 9). Si tu fuente solo te da el nombre y el año, kino.meta({ type, title, year }) busca el título en TMDB (es-MX, comparando también con el título original, el año exacto o a un año) y responde lo mismo que con un id, ids incluidos. Si dos resultados empatan o ninguno coincide responde null: nunca adivina. Revisa kino.meta.byTitle === true antes; por debajo de apiVersion 9, o en un Kino anterior, el título no llega y la consulta responde invalid_request. Por título, sin ids.

Kino 0.9.54: apiVersion 8, música y podcasts, plugins de solo catálogo

(Publicada el 2026-10-06.) apiVersion 8 = Kino 0.9.54. El contrato (contract.json) ahora dice maxApiVersion 8 y kino.apiVersion informa 8. Kino 0.9.53 y anteriores rechazan un manifiesto con "apiVersion": 8 («Este plugin necesita una versión más nueva de Kino»), así que declara 8 solo si devuelves ítems music o podcast o exportas details. Todo lo demás de esta lista es aditivo (vale en cualquier apiVersion y un Kino anterior lo ignora), y nada de esto te obliga a cambiar tu plugin. Cómo usar cada cosa y seguir corriendo en un Kino anterior:

Novedad Desde Cómo saberlo
Ítems music / podcast, export details Kino 0.9.54, apiVersion 8 declara "apiVersion": 8 (un Kino anterior rechaza el plugin)
"catalogOnly": true Kino 0.9.54, cualquier apiVersion un Kino anterior lo ignora: conserva resolve y search o home
captureAll, alsoMatch, waitForCookie, returnCookiesOnTimeout en kino.browser.capture Kino 0.9.54, apiVersion 6 con "browser": true kino.browser.captureAll === true
rating/runtimeMinutes en episodes().series, ids.mal/anilist/kitsu Kino 0.9.54, cualquier apiVersion nada que revisar: un Kino anterior los ignora
kino.lang en el idioma de la app Kino 0.9.54 lee kino.lang; antes siempre era "es-CO"
  • Música y podcasts (apiVersion 8): un ítem puede ser kind: "music" (un álbum, una lista o una sola pista) o kind: "podcast" (un programa o un audiolibro), con un artist opcional. Con episodes declarada, Kino le pide las pistas o los episodios; sin ella, el ref del ítem va directo a resolve. La persona recibe portadas cuadradas en filas propias, páginas de álbum y de podcast con «Reproducir» y «Aleatorio», un reproductor de audio, «Seguir escuchando» para podcasts en el Inicio, descargas de audio (con download) y envío de audio a Chromecast y DLNA. search puede recibir type: "music" o "podcast", y migrate puede responder uno. Música y podcasts.
  • details(ref) (apiVersion 8, opcional, sin capacidad): tu propia sinopsis, arte, géneros, año, nota y duración para la página de una película, pedida junto con TMDB con sus propios 20 s y con permiso para usar kino.browser.page. Desde apiVersion 8 details es un nombre de export reservado: renombra una función tuya que lo tenga. episodes().series también acepta rating y runtimeMinutes, y los ids pueden llevar los mal, anilist y kitsu de un anime, con los que se consultan AniList y los plugins meta. La página del título sigue ahora un orden fijo por campo sin importar quién responda primero, con TMDB primero para la sinopsis, el año, los géneros, la nota y la duración. Los detalles propios de un título.
  • "catalogOnly": true en kino-plugin.json: tu plugin muestra y describe títulos, pero no reproduce ninguno (un catálogo de TMDB, una lista de estrenos, calificaciones). Kino 0.9.54 manda sus títulos a «Buscar dónde verlo» (las otras fuentes de la persona) en vez de abrir el reproductor, nunca lo usa como fuente de un título (la búsqueda, «Ver en otros plugins», «Buscar por fuente», el «Servidor» del reproductor), nunca llama su resolve, no lo cuenta como fuente en «Elige tus fuentes» y la ventana de instalación dice «Solo catálogo: no reproduce videos». Con el campo, resolve deja de ser obligatorio y basta una de home, browse, search o meta; se rechazan download, drm, channels, streamHosts y "browser": true ("pages" sí vale).
  • Es aditivo: vale en cualquier apiVersion, y un Kino anterior ignora el campo como ignora cualquier clave que no conoce. Para que tu plugin se siga instalando y actualizando en Kino 0.9.53 y anteriores, sigue declarando y exportando resolve (que falle con kino.error("not_found", …, { userMessage })) y search o home: esas versiones los exigen. node sdk/validate.mjs te dice si tu manifiesto sirve también para ellas, y node sdk/run.mjs . resolve <ref> recuerda que Kino 0.9.54 ya no lo llama. Plugins de solo catálogo.
  • kino.browser.capture atrapa cada coincidencia: captureAll junta cada petición que coincide (máximo 20) hasta que la página se calma, alsoMatch agrega hasta 10 patrones más, waitForCookie espera una cookie como cf_clearance (sin match, una página solo de cookie) y returnCookiesOnTimeout responde lo que la página tenía en vez de lanzar timeout. La respuesta agrega entonces requests, cookies, userAgent y timedOut. Sin apiVersion nuevo: revisa primero kino.browser.captureAll === true; un Kino anterior ignoraba estos nombres, 0.9.54 revisa sus tipos (invalid_request). Navegador oculto.
  • kino.lang sigue el idioma de la app. Kino 0.9.54 habla español o inglés (Ajustes ▸ App ▸ Idioma), y kino.lang es "es-CO" o "en-US" según eso (antes siempre "es-CO"). Un cambio de idioma cierra tu sandbox y la siguiente llamada abre uno con el valor nuevo; la caché de kino.meta se vacía y las filas de los plugins en el Inicio se vuelven a pedir. Escribe los títulos de tus filas y tu userMessage en ese idioma. La API kino.
  • Los mensajes de error de Kino para tu código están en inglés (el e.message de una falla de kino.fetch, kino.storage, kino.html, las reglas de la firma) y pueden cambiar: compara con e.code, nunca con el texto. Los rechazos del manifiesto que la persona lee al instalar quedan como estaban. Errores que tu código puede atrapar.
  • telemetry: true tiene una nueva línea de consentimiento, «Comparte con Kino registros de errores y datos técnicos de algunas reproducciones para corregir fallas», y también envía una pequeña muestra de reproducciones que salieron bien (una de cada veinte, máximo 6 hasta que Kino se reinicie), solo después de que la persona aceptó esa redacción. La pestaña de tu plugin en Ajustes tiene un interruptor «Enviar registros de errores y de reproducción», encendido por defecto. Los registros de reproducción agregan el códec, la forma de entrega, la causa probable de cada pausa y el tipo de red. Registro y telemetría.
  • Copias: el mismo video, el mismo idioma. Cada entrada de alternatives tiene que ser el mismo video en el mismo idioma (Kino cambia entre ellas por su cuenta). Después de varias pausas para cargar, Kino puede pasar una vez, por su cuenta, a una copia claramente más liviana cuando las etiquetas nombran la resolución ("720p", "Full HD"). Las reglas del Stream.
  • Las descargas que no se pueden guardar ahora terminan como «Este contenido no se puede descargar» (antes «Este video no se puede descargar»). Descargas.
  • «De la comunidad» lee 100 plugins por página (antes los 30 con más estrellas), ordenados por «Populares» o «Recientes», con «Cargar más» y «Buscar en GitHub» para el texto escrito: un nombre y una descripción claros en tu repositorio ayudan a que te encuentren. Publicar.
  • Plugins de CloudStream: la persona puede agregar un repositorio de CloudStream y Kino convierte cada plugin que elige en un plugin de Kino que corre a través de una app complemento aparte; Music/Audio pasan a music y Podcast/AudioBook a podcast. No tienes nada que escribir: es lo que puede esperar quien mantiene un repositorio de CloudStream. Los plugins generados reciben un objeto kino.cloudstream que el tuyo nunca tiene. Un repositorio también se agrega con su código corto de CloudStream (cutt.ly, o py.md con ! al principio), y la pantalla de ajustes propia de un plugin se abre en el teléfono. Plugins de CloudStream.
  • Corregido: kino.tmdb y kino.meta después de una llamada abandonada. Cuando Kino abandonaba una llamada tuya (una pantalla que se cerró, un límite de tiempo) pero igual usaba su respuesta tardía, cada kino.tmdb o kino.meta que esa llamada hacía después fallaba con not_allowed, así que un catálogo de TMDB podía mostrar una sola fila en el Inicio en vez de todas hasta reiniciar. Desde 0.9.54 siguen respondiendo hasta que termina la evaluación de esa llamada. La API kino.
  • La frase de no_tmdb_key para la persona ahora es «Agrega tu llave de TMDB en Ajustes ▸ Tu llave de TMDB» («Add your TMDB key in Settings ▸ Your TMDB key»); la de 0.9.53 también mencionaba un addon de TMDB de Stremio. El Kino de hoy dice «Agrega tu llave de TMDB en Ajustes de todos los perfiles ▸ Llaves», que es donde vive ahora la llave. No hay nada que cambiar: compara e.code, nunca el texto. La API kino.

Kino 0.9.53: kino.meta y kino.tmdb

Sin apiVersion nuevo: sigue siendo 7, y nada de esta lista te obliga a cambiar tu plugin. Las dos llamadas nuevas existen solo desde Kino 0.9.53, así que compruébalas antes de usarlas (typeof kino.meta === "function", typeof kino.tmdb === "function"); node sdk/validate.mjs avisa si tu código llama alguna sin esa comprobación.

  • kino.meta(query): pregúntale a Kino qué sabe de un título ({ type, ids: { imdb, tmdb, tvdb, kitsu, mal, anilist }, lang }) y recibe sinopsis, año, póster, fondo, logo, géneros, duración, capítulos con sus ids, la equivalencia de todos los ids, notas y reparto, o null. Kino responde con su propia consulta de TMDB, AniList para el anime y los demás plugins meta de la persona, combinados igual que en la ficha; tu plugin nunca toca una llave de TMDB, y nunca se le pregunta a sí mismo. 30 llamadas por minuto, máximo 8 s, en caché 30 minutos. La API kino.
  • kino.tmdb(path, params): la API v3 de TMDB, solo lectura, sin una llave en tu plugin. Primero va la llave propia de Kino, detrás de la caché de TMDB de Kino (en disco, la misma de sus pantallas, con una copia de hasta 7 días cuando TMDB no responde) y de límites propios (20 llamadas cada 10 s por plugin, 60 cada 10 s entre todos los plugins), para que los plugins no gasten la cuota de Kino. Solo cuando la llave de Kino falla (TMDB le responde 401/403/429, o se agota uno de esos límites) la misma petición sale otra vez con la llave de la persona: la que escribe en Ajustes ("Tu llave de TMDB", hoy en Ajustes de todos los perfiles ▸ Llaves; opcional, sincronizada entre sus aparatos) o, si no hay, la que configuró en un addon de Stremio instalado, si acepta usarla. Una llave que tu plugin guarda en sus propios ajustes nunca se usa. Kino pone la llave; tu código nunca ve ninguna, y TMDB no necesita una entrada en tus hosts. no_tmdb_key (con la frase de Kino para la persona en e.userMessage: "Agrega tu llave de TMDB en Ajustes, o instala un addon de TMDB de Stremio configurado con tu llave.") queda para una versión de Kino sin llave propia y una persona sin llave. Solo rutas de lectura permitidas, 40 llamadas cada 10 s por plugin conteste la llave que conteste, en caché 10 minutos. Un catálogo hecho con TMDB ya no necesita su propio ajuste de llave (déjalo solo como respaldo para versiones anteriores). La API kino, un ejemplo completo.
  • El kit de Node corre las dos: KINO_META_FIXTURE, KINO_TMDB_KEY (o "tmdbKey" en sdk/config.json) y KINO_TMDB_FIXTURE. Probar en local.

Kino 0.9.51: apiVersion 7

apiVersion 7 = Kino 0.9.51. El contrato (contract.json) dice ahora maxApiVersion 7 y kino.apiVersion reporta 7. Un manifiesto con "apiVersion": 7 se rechaza en Kino 0.9.50 y anteriores ("Este plugin necesita una versión más nueva de Kino"), así que declara 7 solo si usas tracking o segments. Nada más de esta lista te obliga a cambiar tu plugin.

  • tracking (apiVersion 7): tu plugin exporta track(event) y Kino le cuenta qué película o capítulo suena en ese aparato, de cualquier fuente: start, progress, stop y watched, con los ids propios del capítulo y los de la serie aparte. Se aprueba en rojo ("Le contará a … qué ves y cuándo lo terminas"), trae el interruptor "Enviar lo que veo" en tu pestaña de Ajustes, y los eventos esperan en una cola que sobrevive sin conexión y con la app cerrada (reintentos ordenados, 200 por plugin, 7 días). Devuelve { skipped: true } para un evento que a tu servicio no le sirve. Contarle a un servicio de seguimiento qué ve la persona.
  • segments (apiVersion 7): tu plugin exporta segments(query) y le dice a Kino dónde están la intro y los créditos de cualquier película o capítulo; los botones "Saltar intro" y "Saltar outro" y el salto automático los usan en celular y TV. Sin aprobación en rojo. Dónde están la intro y los créditos.
  • Subtítulos por archivo: subtitles() recibe file: { hash?, size?, name? }, lo que Kino sabe del archivo que suena (el hash de OpenSubtitles, su tamaño, su nombre, o uno al estilo de un release armado con el título), para poner primero la versión exacta. Un addon de Stremio lo recibe como los extras videoHash, videoSize y filename. Sin apiVersion nuevo. Subtítulos para cualquier título, Addons de Stremio.
  • meta con logo, notas y reparto: la respuesta de meta puede traer logo (se muestra en lugar del nombre en la ficha), ratings (hasta 6, de IMDb, Rotten Tomatoes, Letterboxd…) y cast (hasta 20); un addon de Stremio al estilo de AIOMetadata los da con su logo, imdbRating y app_extras.cast. Sin apiVersion nuevo: las versiones anteriores los ignoran. Describir otros títulos.
  • Los enlaces stremio:///detail/… abren el título en Kino (el "Open in Stremio" de Seenr y similares), en vez de ignorarse. Addons de Stremio.
  • "Tu servidor" 1.5.0, el plugin de referencia, ahora muestra todo lo que un servidor propio puede usar hasta apiVersion 7: tracking, segments, subtitles con file, meta con logo, notas y reparto, y lo de apiVersion 6 (sección, categorías, firma por petición, copias, el formulario de ajustes completo, una lista con resolve: true, liveSearch y paginación de canales). Plugins de ejemplo.

  • Compatibilidad de Nuvio v2: Kino convierte muchos más scrapers de Nuvio. Scrapers de varios archivos (los hermanos se leen del mismo repositorio, máximo 16 archivos y 1 MiB), un subconjunto de Node (path, url, util, events, querystring, timers, buffer y http/https/undici sobre kino.fetch; setInterval, queueMicrotask), el onSettings de cada scraper como formulario de ajustes que se sincroniza entre aparatos, y cada copia reproducible ofrecida como alternativa con etiqueta en el menú Servidor (las páginas de embed de últimas). Una dirección al estilo Kodi url|User-Agent=… se vuelve encabezados. Los scrapers P2P y de debrid se rechazan ("No compatible"). Nada de esto es para tu propio plugin: es lo que puede dar por hecho un scraper de Nuvio. Scrapers de Nuvio.

  • Formulario de ajustes: el hint de una section puede tener hasta 300 caracteres y se parte en varias líneas (sectionHintMaxChars en contract.json). Las versiones anteriores a 0.9.51 rechazan uno de más de 80, así que mantenlo corto si tu plugin tiene que instalarse en ellas. Formulario de ajustes.
  • Un % en el texto de un error ya no tumba la app. Hasta 0.9.50, un error de tu plugin cuyo texto llevaba un % (una URL codificada como ?q=Inception%20s en un "fetch failed") podía cerrar Kino de golpe. Ahora el texto de un error puede ser cualquiera; si tu plugin tiene que correr en 0.9.50 y anteriores, no metas direcciones codificadas en sus mensajes de error. Errores que tu código puede atrapar.
  • Recomendados suma addons de Stremio de utilidad (subtítulos como OpenSubtitles v3 y Subtis, catálogos como Cinemeta, TMDB e IMDb) y canales gratis y legales (Pluto TV, Radios). La lista ya no se publica en npm: Kino la lee de este repositorio en GitHub, luego de archive.org y luego de la copia de jsDelivr del mismo archivo de GitHub. Un addon que reproduce video sigue sin recomendarse. Addons de Stremio.
  • La tarjeta de tu plugin ya no lleva la insignia "Kino" (parecía hecho por Kino); los addons de Stremio y los scrapers de Nuvio conservan la suya.
  • Un addon de Stremio cuya descripción niega los torrents ya no se oculta ("no incluye streams, torrents ni contenido P2P"); el id y el nombre siguen estrictos. Lo que Kino rechaza.

Kino 0.9.50: apiVersion 6

apiVersion 6 = Kino 0.9.50. El contrato (contract.json) dice ahora maxApiVersion 6 y kino.apiVersion reporta 6. Un manifiesto con "apiVersion": 6 se rechaza en Kino 0.9.49 y anteriores ("Este plugin necesita una versión más nueva de Kino"), así que declara 6 solo si usas algo de esta lista. Todo lo que un plugin ahora puede cambiar de cómo lo muestra Kino está reunido en Personaliza tu plugin.

  • Secretos sellados más grandes y con tipo: hasta 8.192 bytes, y llaves de cifrado con tipo (use: "cipher-key") que sirven también para des-ede3. Manifiesto.
  • migrate: pasar a tu plugin lo que la persona tenía guardado y Kino ya no puede abrir. Pasar lo guardado.
  • Streams firmados por petición: signing: "request", signContext, el export sign, resolve(ref, { retry }) y alternateHosts. Firma por petición.
  • El formulario de ajustes: tipos section, status y action (hasta 16, además de los 12 con valor), settingsStatus, action con clearSettings, validateSettings, la pestaña propia en Ajustes y la sincronización entre aparatos. Formulario de ajustes.
  • debug y telemetry (true o "verbose"), kino.log.report, la página Registro, las etiquetas de logcat KinoPlugin/<id> y KinoPlay, y las métricas de reproducción. Registro y telemetría.
  • Modo debug en todo plugin: todo plugin instalado (el tuyo, un addon de Stremio convertido, un scraper de Nuvio) tiene un interruptor "Modo debug" en su pestaña de Ajustes, sin que hagas nada: encendido, sus fallas se ven en pantalla y su Registro se puede copiar o compartir, así que una persona te puede mandar una captura o su Registro. "debug": true ahora solo lo deja encendido de entrada; sin él arranca apagado. La decisión de la persona se conserva en las actualizaciones y se sincroniza con sus otros aparatos. Modo debug.
  • Los rechazos tempranos se atajan: un throw en una función async antes de su primer await lo ataja el try/catch de quien la llama (o un .catch(), un Promise.all), como en Node; solo un rechazo que nadie maneja nunca sigue haciendo fallar la llamada. Sigue haciendo el await primero si tu plugin tiene que correr en 0.9.49 y anteriores. La trampa del rechazo.
  • section, categories y theme: una sección propia, un grupo en Categorías y tus colores. Sección, categorías y colores.
  • scopedSearch: responder tú la búsqueda dentro de un "Ver más". Contrato.
  • kino.error(code, message, { userMessage }): tu propia frase para la persona, con reglas de seguridad y atribuida a tu plugin. Contrato.
  • Entradas adult: true detrás del código +18 de la persona (antes se descartaban). Contenido +18.
  • Canales en tus filas de Inicio (kind: "live" en home; antes se quitaban). Canales en vivo.
  • Pares de llaves en kino.crypto: generateKeyPair, sign, verify, importKey, deriveSharedSecret. API kino.
  • El navegador oculto: "browser": true (aprobado en rojo, "Puede abrir páginas web ocultas para encontrar el video") y kino.browser.capture, que abre un embed en una WebView oculta dentro de la app, en un resolve que empezó la persona, y devuelve las peticiones de video que hizo, retenidas para que sus tokens sigan frescos, con los encabezados y cookies para reproducirlas. Todo su tráfico pasa por un proxy con una credencial por captura e IP revisadas y fijas; la red de la casa nunca; una página a la vez; cookies y almacenamiento borrados. Una página que pide una persona termina con blocked: Kino nunca resuelve un captcha. El resolve de un plugin aprobado tiene 75 s. También, con "browser": "pages" (su propia línea roja), kino.browser.page, que lee el HTML de una página a través del mismo navegador oculto cuando la revisión automática del sitio pasa sola (nunca desde categories; el documento principal tiene que quedarse en tus hosts, revisando cada salto de redirección, o la lectura termina en blocked). Navegador oculto.
  • Stream.label y copias perezosas con etiqueta: nombra cada copia ("Latino · Servidor 1") para el nuevo menú Servidor del reproductor, y lista copias como { label, ref } que Kino resuelve con resolve(ref) solo cuando la persona escoge una, el cambio automático llega a ella (máximo 20 s cada una) o la elección de copia de una descarga la prueba. Si la escogida falla, se vuelve a la copia que se estaba viendo. Copias con etiqueta y perezosas.
  • meta: describir títulos que listaron otras fuentes (sinopsis, imágenes, capítulos) cuando TMDB y AniList no tienen nada. Describir otros títulos.

Sin apiVersion nuevo (sirve para cualquier plugin):

  • alternatives en un Stream: hasta 8 copias del mismo video; Kino pasa a la siguiente cuando una no se puede reproducir en el aparato. Contrato.
  • Reproducir en el TV desde el celular, capítulos nuevos de las series seguidas y "Para ti" funcionan para títulos de cualquier plugin. Lo que ve la persona.
  • Actualizaciones: revisión al abrir la app (máximo cada 12 h), insignia de pendientes, y una llamada fallida con una actualización pendiente lo dice. Publicar.
  • Un plugin firmado en dos repositorios cuenta como el mismo con el mismo id y la misma llave. Plugins firmados.
  • Export subtitles: responder la "Buscar subtítulos en línea" del reproductor para cualquier título que Kino conozca por id de IMDb o TMDB, junto a tus videos o como proveedor de subtítulos ("capabilities": ["subtitles"] sola). Subtítulos para cualquier título.
  • Stream.skip: dónde están la entrada y el cierre de este archivo, para "Saltar intro" / "Saltar outro"; los tuyos le ganan a AniSkip, una corrección a mano le gana a los tuyos. Contrato.
  • El campo categories del manifiesto (movies, series, anime, live, radio, subtitles, utilities, adult): los chips de categoría de la tienda de plugins. Manifiesto.
  • Formulario de ajustes: settingsStatus() se vuelve a pedir después de cada acción, así que refresh: true ya no hace falta. Formulario de ajustes.
  • Registros: solo un plugin que declara telemetry envía líneas de kino.log con una falla, recomendado o no; por ahora no hay interruptor para apagarlo. Registro y telemetría.
  • "De la comunidad" es su propia pestaña de la pantalla Plugins. Publicar.
  • Addons de subtítulos de Stremio (OpenSubtitles v3, traductores como GTSubs) se instalan como proveedores de subtítulos; las traducciones automáticas salen como "Español (traducido)". No tienes nada que escribir. Addons de Stremio.
  • Ids reservados: live, local, unknown, plugin, own, subtitle-keys, subtitle-prefs (la lista cambió: las versiones anteriores reservan algunos más, así que si una dice "El id … está reservado por Kino", escoge otro).
  • Reclamos y retiro de plugins de la comunidad: community-blocklist.json.
  • Enviar a la TV: todo HLS pasa por el celular; un archivo sin headers va directo y, si la TV no puede, por el celular. Enviar a la TV.
  • genre en una fila de Inicio, una categoría en vivo o una lista (peliculas, series, anime, infantil, documentales, deportes, noticias, musica, entretenimiento, otros): Categorías agrupa por él las filas navegables de todos los plugins, y En vivo filtra por él entre proveedores. Opcional; sin él, Kino lo adivina por el título. Contrato.
  • streamHeaders en una lista: el User-Agent o el Referer que el reproductor manda para cada canal de la lista, aparte de los headers de descarga de la propia lista. Canales en vivo.
  • Una llamada kino.* síncrona que falla se puede atajar (un kino.storage lleno, un error de kino.crypto): tu try/catch recibe un Error normal; Kino 0.9.49 terminaba ahí la llamada entera. Errores que tu código puede atrapar.
  • Después de actualizar Kino, las actualizaciones de plugins que esperan aprobación se instalan una vez, desde la dirección del propio plugin, con un aviso único "Se actualizaron tus plugins" que dice lo que cada uno puede hacer ahora. Publicar.
  • El formulario de ajustes, documentado entero: cada tipo de campo, atributo y valor por defecto, con un ejemplo completo. Formulario de ajustes.

(Las versiones de Kino anteriores a genre y streamHeaders los ignoran; no se revisó la versión exacta en que salió cada uno.)

También en esta versión (ya documentado antes en esta página como "próxima versión"):

  • Instalar desde la URL del manifiesto. La gente puede pegar la URL https de un kino-plugin.json en cualquier servidor público, no solo un owner/repo de GitHub. Una instalación url: así lee entry e icon al lado del manifiesto, no puede usar secrets sellados, siempre cuenta como no firmada y nunca sale en "De la comunidad" (el descubrimiento sigue usando el topic de GitHub). Una URL de kino-plugin.json en GitHub, raw.githubusercontent.com o jsDelivr (cdn.jsdelivr.net/gh/owner/repo@<ref exacta>/…; @latest es la rama por defecto, un rango de versiones se rechaza) se vuelve owner/repo como antes. Instalar desde la URL del manifiesto, Publicar.
  • liveSearch, un export opcional nuevo para canales en vivo (sin apiVersion nuevo: sigue siendo 3 con channels). Kino lo pide desde la búsqueda de En vivo mientras algunos de tus canales nunca se han listado; devuelve canales como una página de liveChannels, máximo 100 conservados, desde 2 caracteres escritos, 15 s. Canales en vivo.
  • Los catálogos en vivo grandes siguen paginando. liveChannels recibe 10 páginas al comienzo, y 5 más cada vez que la persona se acerca al final, hasta 10.000 canales (200 páginas) por categoría. Las versiones anteriores se quedan en 10 páginas. Pruébalo con node sdk/run.mjs . live search <consulta>.
  • Listas M3U en UTF-8, Latin-1 o UTF-16; los atributos de #EXTINF pueden ir con comillas simples o sin comillas; una lista de más de 20 MB o una guía de más de 50 MB se corta en su última línea completa en vez de rechazarse. Canales en vivo.
  • Addons de Stremio: la gente los puede instalar desde el mismo campo (Kino genera el plugin; no tienes nada que escribir). Su resolve, como el de un scraper de Nuvio convertido, tiene 75 s. Qué se admite, qué se rechaza (torrents y P2P siempre) y cómo hacer que un addon funcione bien: Addons de Stremio.
  • ditu ya no es un id de plugin reservado (las versiones anteriores lo siguen rechazando, así que evítalo).

Kino 0.9.46 a 0.9.49

  • Se acepta un ./ al principio de entry e icon. Kino lo quita e instala el plugin. Kino 0.9.45 y anteriores lo siguen rechazando (El campo "entry" debe ser una ruta relativa a un archivo .js), así que sigue escribiendo "plugin.js" e "icon.png". El validate.mjs del kit rechaza "./plugin.js" por eso. Detalles.
  • Tus logs ayudan cuando falla un plugin recomendado. En un plugin del catálogo recomendado de Kino, las últimas 30 líneas de kino.log de una llamada fallida (depuradas, 2 KB) van con el reporte del error como plugin_log. Registra pasos y estados, nunca lo que la persona escribió ni un secreto. kino.log.
  • Un canal en vivo nunca muestra el botón de descarga, aunque el plugin declare download.

Sobre la versión de cada punto

Estos puntos están en las versiones publicadas como 0.9.46 a 0.9.49; no se comprobó la versión exacta en la que apareció cada uno.

Kino 0.9.45

Contrato (contract.json, maxApiVersion 5):

  • Plugins firmados, apiVersion 5. Firma opcional del autor en kino-plugin.json (node sdk/seal.mjs --keygen, --sign; validate.mjs la comprueba), clave fijada en la primera instalación, "Firmado por su autor" en la hoja de consentimiento, insignia "Firmado", la clave del autor en los detalles. Necesita Kino 0.9.45+; las apps más viejas rechazan un manifiesto con apiVersion 5. Borradores anteriores de estos documentos decían 0.9.46: salió en 0.9.45. Plugins firmados.
  • Sin máximo de hosts. El límite de 20 desapareció (solo lo acota el manifiesto de 16 KB). Kino 0.9.44 y anteriores siguen rechazando más de 20, y el kit avisa. Manifiesto.
  • kino.apiVersion reporta 5.

Comportamiento que puedes notar (sin cambio de manifiesto):

  • Enviar a la TV (Chromecast y DLNA) funciona para títulos de plugins. Directo para mp4/webm y HLS sin headers; por el celular cuando pones headers; nunca para DRM, DASH, MPEG-TS progresivo o un formato que nada identifica. Enviar a la TV.
  • Los plugins acompañan a la persona entre sus aparatos (celular y TV): instalaciones, encendidos, aprobaciones, ajustes y contraseñas (cifradas) se sincronizan, y el otro aparato instala tu plugin desde la misma dirección. Plugins en otros aparatos.
  • Direcciones de instalación: también sirve una URL raw.githubusercontent.com/.../kino-plugin.json (o manifest.json, para Nuvio) o una github.com/.../blob/...; una ref que solo viene de una URL pegada no es un pin. Inicio, Scrapers de Nuvio.
  • Descargas HLS: EXT-X-DISCONTINUITY se deja tal cual salvo que el formato cambie en él; una llave mala o un segmento vacío terminan como "Este video no se puede descargar"; un reintento solo retoma con el mismo contenido. Las descargas siguen siendo declarativas: "download" en capabilities, nada que exportar. Descargas.
  • Headers de canales M3U: se leen #EXTHTTP, url|User-Agent=... y los headers de #KODIPROP; solo se conservan User-Agent, Referer, Origin y Cookie. Canales en vivo.
  • kino.fetch: los saltos de redirección rechazados cuentan para las 60 peticiones, máximo 6 fetch en vuelo, máximo 3 preguntas de host por llamada, se rechazan las formas IPv6 de direcciones privadas, sin proxy del dispositivo. Un plugin convertido desde un scraper de Nuvio tiene 250 peticiones y 75 s de resolve. Límites.

Sobre la versión de cada punto

El archivo del contrato fija la versión solo para los plugins firmados y el límite de hosts (0.9.45). Los demás puntos están en la compilación que se publicó como 0.9.45; no se verificó en qué versión exacta apareció cada uno.

Ya estaba antes de 0.9.45

streamHosts: "any" (apiVersion 4), liveStreamHosts: "any" (apiVersion 3 más la capacidad channels), fetchHosts: "any" (lo escribe Kino solo en scrapers de Nuvio convertidos, nunca para tu plugin), y la pregunta que Kino le hace a la persona la primera vez que un stream usa un host que no declaraste. Están documentados en el manifiesto, canales en vivo y el contrato.