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": truedel manifiesto deja que Kino llameresolvepara 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 cuyoresolveno 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 cuyoresolvenunca 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 porrefcada 5 minutos, 6 por minuto;node sdk/run.mjs . prepare <ref>. Prepararse antes de reproducir. - En vivo por reloj (
apiVersion27). Un stream en vivo puede llevarclockLive: 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: tuapiVersiono la clave más alta deenhancementsaplicada. Revísalo, nokino.apiVersion, antes de enviarclockLive.kino.pluginApiVersion.- Imágenes http en las pantallas. Las imágenes de una pantalla (una
Image, la imagen y el logo de unheroCard, unCircleAvatar, los pósters detitleCard,titleRailytitleGrid) pueden ser http en un host público, como un póster del Inicio: se ven los logos de los canales de IPTV. Revisakino.screen.httpImages === true; losheaderssiguen yendo solo con https. Imágenes http. - Identidad.
kino.identity.telegramda eltokensolo a las llaves de autor dekinoIdentity.tokenAuthors, ahora dos; cualquier otro autor recibe elidy, con un desafío, la atestación, donde Kino 0.9.87 respondíapermission_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
paddingreemplaza ese espacio (Botones); cada destino de laNavigationBarde unScaffoldconserva su desplazamiento, como cada pestaña de unTabBar(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 (
apiVersion26). Un tema puede declararsurfaces(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 tokensshape.heroRadiusyshape.railItemRadius. Siete interruptores en Ajustes ▸ Experiencia visual dejan que la persona quite cada efecto por separado. Superficies pintadas, capas y archivos. kino.visualBrowser: ellocalStoragede 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, ydoneWhen.localStoragecierra la ventana cuando la página las guardó. La hoja lista las claves;storeAssigue 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 (
apiVersion24, Kino 0.9.85). Eldrmde un stream puede ser una lista, la mejor opción primero, y un bloque puede sertype: "clearkey"con suskeys. 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 (
apiVersion25, Kino 0.9.86). Una entradasubtitlesde un stream puede llevar su propiotextdescifrado (conformatvttosrt, hasta 2.000.000 de bytes) en lugar de unaurl; 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(apiVersion20). 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 laroutesolo si el destino la lista enopenFrom.routesy, si no, busca laqueryen ese plugin o abre su sección.go.plugin.openFrom.routesen el manifiesto (apiVersion20, también enenhancements["20"]). De 1 a 16 rutas de tu pantalla que las tarjetas de otros plugins pueden abrir; tu pantalla leeroute.argsen su eventoopen.openFrom.ctx.callerpara los proveedores. Cada exportaciónproto_recibe un segundo argumento,ctx, con el plugin que llama:{ id, repo, name, adult }(quita el@refderepoantes de usarlo engo.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 comodata:(32 a 400 de ancho, 2.048 a 32.768 bytes, 20 por minuto). Revisatypeof 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
sharede su puertawall(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. Operacionesuilocales. - 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 (
apiVersion22). La capacidadprogressykino.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;resumeson hasta 1024 bytes de tu propio JSON que Kino nunca lee. Kino no dibuja nada: tu plugin arma su propio estante "Seguir leyendo" conlist. Sin línea de consentimiento; se rechaza en un trabajo que corre para otro perfil; se puede declarar enenhancements["22"]. Guardar dónde va la persona. - El hueco del reproductor (
apiVersion23). La capacidadplayerSloty el bloqueslotdel 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 exportplayerSlot(context)y que se aprietan conplayerSlotAction({ id, context }). Los elementosoverlaysalen con los controles; unofixedse queda y le pregunta a la persona en rojo, en cada aparato. El ejemplo es un reloj. Un texto también puede decir susize,weight,colorybackground, y cualquier elemento suleftytop, 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
Imageaceptaheaders: { Referer?, User-Agent? }(sinapiVersionnuevo), que se envían solo cuando el host de la imagen, y el del Referer, están en loshostsde 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 (
apiVersion21). La capacidadfilesykino.files: la persona elige archivos o una carpeta, el plugin recibe handles opacos, los lee por rangos o los reproduce conkino-file:<id>. No sube nada. Archivos del aparato. - Deslizar.
onSwipeLeftyonSwipeRighten cualquier nodo (sinapiVersionnuevo; 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:. UnaImageaceptadata: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 elfallback. Image. - Barras y héroes.
AppBaryTabBaraceptandivider: false;heroCardaceptalogo(https) yh(alto);densetambié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.borderyshape.dialogBorder,menuBorder,headerBorder,cardBorder,panelBorder),logo.decory 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: trueydense: trueen elAppBarde cada pantalla, con unleadingque 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 ignoradensey un panel del reproductor ignora las dos. Una sola barra compacta. AppBar:dense(4 dp arriba y abajo de la fila en un celular) ymergeWithKinoBar(una barra: tuleadingdonde estaba Cerrar, tutitledonde 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):
Imagefit(cover,contain,width),focusy cualquierw:henaspect;SingleChildScrollViewzoomyonScroll;pagesreverse(de derecha a izquierda) yprogress(segments,bar,none; hasta 250 páginas conbaronone). Scroll, Image, pages. - Rutas:
route.namees"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 congo.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 propioshostsuna 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, concollect.storeAs, escribe las cookies directo en uno de tus ajustespassword(thenEventle avisa a tu pantalla cuándo). La receta "Vincular cuenta" está en la página;enhancementsahora puede llevarvisualBrowser. 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.installPluginabre la hoja de instalación de siempre de Kino encima de tu pantalla, y solo el Instalar de la propia persona lo instala; conrecommends, tu pantalla sabe cuáles de esos plugins están instalados y Kino la vuelve a dibujar cuando eso cambia.go.installPlugin. - Pantallas:
Scaffold.onBackyAppBar.mergeWithKinoBarson funciones deapiVersion19 (una sola barra compacta), y unTextFieldesconde 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 capacidadcoinsy 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).screenyscreenEventrecibenactiveTheme.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.statsdeja leer los hábitos de un mes de la persona (agregados, no filas) con su aprobación delibrary. Salas, biblioteca y control del reproductor. - Trabajos por perfil: un trabajo con
perProfilecorre 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 conkino.sharedy se salta el trabajo si ya llegó uno fresco. Un manifiesto conperProfiley unapiVersionmenor se rechaza. Trabajos, resultados compartidos e IA. kino.tmdben un trabajo y más espacio para la IA: un plugin conaiaprobada 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 textohero(un número grande, un paso encima deh1), la respuestashare(Kino dibuja un nodo como imagen y abre el menú de compartir del sistema, solo tras un toque de la persona), la respuestaenableJob(enciende la fila de Kino de un trabajo, solo tras un toque),go.searchcon"scope": "all"(la búsqueda normal de Kino en todas las fuentes) ygo.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 }ykino.coins.give({ to, postId })regala UNA moneda a la cuentatopor la publicaciónpostId. Es una capacidad declarativa que no va sola, no se ofrece conenhancementsy 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 ykino.sync.setActive(on)lo cambia. Encender pregunta a la persona con el diálogo de Kino (rechazar respondefalsey 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 unapiVersion: detéctalo contypeof 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
iden todas las tiendas; una tienda cuyas filas perdió Kino se sincroniza desde cero (sinsincenistate: 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
seasonyepisode. 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 nodosettings, 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.roomabre salas por internet alojadas en el aparato de la persona,kino.librarylee lo que vio y guardó,playerControldeja 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.sharedsincroniza unos pocos resultados entre los aparatos de la persona,kino.ai.askle hace una pregunta corta a la IA de texto de Kino. Trabajos, resultados compartidos e IA. - Sin subir tu apiVersion:
enhancementsofrece 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.fetchconmaxBytesystopAt. API kino. - Un plugin como archivo: Kino exporta un plugin instalado como
.kinopluginy lo importa como plugin local. Exportar e importar un plugin. - Plugins más grandes:
src/empaquetado con esbuild, concheck: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 comoUint8Arrayo, mucho más rápido, como textoshex/base64. Sockets y bytes del plugin. - Bytes que sirve el plugin (
byteSource):resolve()responde un stream sin URL y Kino le pide a turead1 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.catalogguarda 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.storageLargedejakino.storageen 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
qrdibuja un QR con lo que devuelve tusettingsStatus()y lo refresca cadarefreshMs;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): unposter, unbackdrop, unstillo laimagedel encabezado de una sección puede ser{ source: "plugin", handle }; Kino le pide los bytes a tu exportimage(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,modPowde números grandes,gunzipy unconvertnativo entreutf8,hexybase64. 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 . resolveacepta streams de bytes,run.mjs --size <bytes> . read …yrun.mjs --out <archivo> . image …llaman tus exports como Kino (askRead,askImagedesde las pruebas), einit.mjs --with byteSource,images,catalog,socketarma un plugin de apiVersion 13. Probar en local. - Una contraseña que se queda en un aparato: un ajuste
passwordpuede 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 llamadakino.*conawaitya 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"](ystorageLarge,catalogoqrScansi los necesita) y sigue sin exportarresolve,searchnihome. El manifiesto. setSettingsllena una contraseña: se guarda sellada como una escrita, nunca se registra y se borra delmessagey dellinkde 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 comokeySecret. 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 ajustekeySecretvacío cuando se enciende el proveedor y cuando se toca "Enviar configuración"; sin paso "Crear clave". Una llave que crea Kino.hideensettingsStatus: hasta 32 claves de tus ajustes que el formulario no dibuja mientras esa respuesta sea la vigente (los valores se quedan); unqrsin texto no dibuja nada. Esconder lo que no hace falta.- Un
textque se queda en el aparato:"sync": falseen untext(un número de teléfono que se ve tal cual): nunca se sincroniza, no va en copias de seguridad ni ensync.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 pegandokinotvapp/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
syncPushun blob opaco en base64 (como muchosync.maxBlobBytes, 4 MiB) para guardarlo, y tusyncPulllo devuelve byte por byte, con unaversiontuya;kino.error("conflict", …)hace que Kino traiga, combine y vuelva a enviar. El bloquesyncdel manifiesto fija cada cuánto (pollorealtime), el tamaño del blob, elkeySecretobligatorio (Kino deriva la llave de sincronización de uno de tus ajustespassworden cada aparato, así que ninguna llave viaja y el plugin y su servicio pueden leer los datos) y elprovisionobligatorio (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ónhttpspor el sistema solo cuando la persona lo toca; en un TV, la dirección y un QR) y un ajustehelp(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 comoconfirmde unlink. 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;
pullEveryMses solo el valor de partida). Proveedores de sincronización. setSettings(Kino 0.9.74, aditivo): una acción puede llenar hasta 8 de tus ajustestextoselect, guardados como si la persona los hubiera escrito; nunca unurl, y unpasswordsolo desde apiVersion 13. Llenar ajustes propios.- "¿Eres tú?" (
action.link, Kino 0.9.74, aditivo): una acción respondelink: { candidate, confirm }y Kino le pregunta a la persona con sus propias palabras antes de correr la acciónconfirm. Vincular. - El registro de las peticiones de un plugin guarda solo el host: la línea de Kino por cada
kino.fetchde 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
nuvioynuvioRepos(de 1 a 4 repositorios) y, dentro de tus funciones, llamas akino.nuvio.available,use,scrapersystreams: 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 contypeof kino.nuvio === "object". Plugins que usan scrapers de Nuvio.
Home por categorías, genre abierto en las filas¶
genreen 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
genreen cada fila ygenresen cada ítem, de preferencia con los ids del vocabulario, y mandaids/TMDB yyearpara 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 deresolve(), o una entrada de lasalternativesde un Stream, puede ser{ external: { protocol, ref, resolver? } }en vez de unaurlreproducible: Kino le pasarefa una app instalada por separado que declara resolverprotocol, 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 elsha256;fdroid: truey uncodede 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ó) yportable(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 cualquierapiVersion; un Kino más viejo ignora las dos. Las reglas delStream.- 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 dechannels, que exige dos --, ni siquieraplaylists()mismo:playlists(),playlistItems({ playlistId, cursor }),playlistCreate({ title }),playlistAddItem({ playlistId, ref }),playlistRemoveItem({ playlistId, ref })yplaylistReorder({ playlistId, refs }). No tiene nada que ver conKinoPlaylist(la lista M3U/IPTV de En vivo) ni con elkind: "playlist"que firmasign(). 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 (conpanel,patch,values,save,focus,messageyplayer), y el manifiesto lleva"panel": { "label", "icon" | "iconFile" }(un PNG de 96×96). El panel del reproductor. - Propiedades del reproductor (apiVersion 9):
playeren la respuesta depanelActionyplayerEventmueve el reproductor:seekToMs,seekStepMs(5 a 120 s),speed,resize,skip,markers(hasta 30 puntos en la barra) yautoNext(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 destarted,paused,resumed,ended,failedycopyChangedmientras 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": 9y"fetchHosts": "any"puede llegar conkino.fetcha hosts que no declaró (redirecciones incluidas), solo porhttpsen 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); tushostsdeclarados 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 tushosts. En las páginas ocultas, la dirección inicial y cada navegación principal siguen la misma regla. Unhost_not_alloweddekino.fetchtrae ahorae.host.kino.fetchAnyHostestruecuando está activo (falsesi no;undefineden 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
labelEnyhintEn(unactionconconfirm, tambiénconfirmEn), cada opción de unselecty cada campo de unalistsulabelEn, ysectiondel manifiesto sulabelEn, 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.metapor 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,idsincluidos. Si dos resultados empatan o ninguno coincide respondenull: nunca adivina. Revisakino.meta.byTitle === trueantes; por debajo de apiVersion 9, o en un Kino anterior, el título no llega y la consulta respondeinvalid_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) okind: "podcast"(un programa o un audiolibro), con unartistopcional. Conepisodesdeclarada, Kino le pide las pistas o los episodios; sin ella, elrefdel ítem va directo aresolve. 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 (condownload) y envío de audio a Chromecast y DLNA.searchpuede recibirtype: "music"o"podcast", ymigratepuede 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 usarkino.browser.page. Desde apiVersion 8detailses un nombre de export reservado: renombra una función tuya que lo tenga.episodes().seriestambién aceptaratingyruntimeMinutes, y losidspueden llevar losmal,anilistykitsude un anime, con los que se consultan AniList y los pluginsmeta. 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": trueenkino-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 suresolve, 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,resolvedeja de ser obligatorio y basta una dehome,browse,searchometa; se rechazandownload,drm,channels,streamHostsy"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 exportandoresolve(que falle conkino.error("not_found", …, { userMessage })) ysearchohome: esas versiones los exigen.node sdk/validate.mjste dice si tu manifiesto sirve también para ellas, ynode sdk/run.mjs . resolve <ref>recuerda que Kino 0.9.54 ya no lo llama. Plugins de solo catálogo. kino.browser.captureatrapa cada coincidencia:captureAlljunta cada petición que coincide (máximo 20) hasta que la página se calma,alsoMatchagrega hasta 10 patrones más,waitForCookieespera una cookie comocf_clearance(sinmatch, una página solo de cookie) yreturnCookiesOnTimeoutresponde lo que la página tenía en vez de lanzartimeout. La respuesta agrega entoncesrequests,cookies,userAgentytimedOut. Sin apiVersion nuevo: revisa primerokino.browser.captureAll === true; un Kino anterior ignoraba estos nombres, 0.9.54 revisa sus tipos (invalid_request). Navegador oculto.kino.langsigue el idioma de la app. Kino 0.9.54 habla español o inglés (Ajustes ▸ App ▸ Idioma), ykino.langes"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é dekino.metase vacía y las filas de los plugins en el Inicio se vuelven a pedir. Escribe los títulos de tus filas y tuuserMessageen ese idioma. La APIkino.- Los mensajes de error de Kino para tu código están en inglés (el
e.messagede una falla dekino.fetch,kino.storage,kino.html, las reglas de la firma) y pueden cambiar: compara cone.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: truetiene 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
alternativestiene 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 delStream. - 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
musicy Podcast/AudioBook apodcast. No tienes nada que escribir: es lo que puede esperar quien mantiene un repositorio de CloudStream. Los plugins generados reciben un objetokino.cloudstreamque 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.tmdbykino.metadespué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, cadakino.tmdbokino.metaque esa llamada hacía después fallaba connot_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 APIkino. - La frase de
no_tmdb_keypara 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: comparae.code, nunca el texto. La APIkino.
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, onull. Kino responde con su propia consulta de TMDB, AniList para el anime y los demás pluginsmetade 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 APIkino.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 tushosts.no_tmdb_key(con la frase de Kino para la persona ene.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 APIkino, un ejemplo completo.- El kit de Node corre las dos:
KINO_META_FIXTURE,KINO_TMDB_KEY(o"tmdbKey"ensdk/config.json) yKINO_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 exportatrack(event)y Kino le cuenta qué película o capítulo suena en ese aparato, de cualquier fuente:start,progress,stopywatched, 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 exportasegments(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()recibefile: { 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 extrasvideoHash,videoSizeyfilename. SinapiVersionnuevo. Subtítulos para cualquier título, Addons de Stremio. metacon logo, notas y reparto: la respuesta demetapuede traerlogo(se muestra en lugar del nombre en la ficha),ratings(hasta 6, de IMDb, Rotten Tomatoes, Letterboxd…) ycast(hasta 20); un addon de Stremio al estilo de AIOMetadata los da con sulogo,imdbRatingyapp_extras.cast. SinapiVersionnuevo: 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,subtitlesconfile,metacon 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 conresolve: true,liveSearchy 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,bufferyhttp/https/undicisobrekino.fetch;setInterval,queueMicrotask), elonSettingsde 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 Kodiurl|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
hintde unasectionpuede tener hasta 300 caracteres y se parte en varias líneas (sectionHintMaxCharsencontract.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%20sen 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 parades-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 exportsign,resolve(ref, { retry })yalternateHosts. Firma por petición. - El formulario de ajustes: tipos
section,statusyaction(hasta 16, además de los 12 con valor),settingsStatus,actionconclearSettings,validateSettings, la pestaña propia en Ajustes y la sincronización entre aparatos. Formulario de ajustes. debugytelemetry(trueo"verbose"),kino.log.report, la página Registro, las etiquetas de logcatKinoPlugin/<id>yKinoPlay, 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": trueahora 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
throwen una funciónasyncantes de su primerawaitlo ataja eltry/catchde quien la llama (o un.catch(), unPromise.all), como en Node; solo un rechazo que nadie maneja nunca sigue haciendo fallar la llamada. Sigue haciendo elawaitprimero si tu plugin tiene que correr en 0.9.49 y anteriores. La trampa del rechazo. section,categoriesytheme: 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: truedetrás del código +18 de la persona (antes se descartaban). Contenido +18. - Canales en tus filas de Inicio (
kind: "live"enhome; 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") ykino.browser.capture, que abre un embed en una WebView oculta dentro de la app, en unresolveque 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 conblocked: Kino nunca resuelve un captcha. Elresolvede 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 desdecategories; el documento principal tiene que quedarse en tus hosts, revisando cada salto de redirección, o la lectura termina enblocked). Navegador oculto. Stream.labely 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 conresolve(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):
alternativesen unStream: 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
idy 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
categoriesdel 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í querefresh: trueya no hace falta. Formulario de ajustes. - Registros: solo un plugin que declara
telemetryenvía líneas dekino.logcon 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
headersva directo y, si la TV no puede, por el celular. Enviar a la TV. genreen 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.streamHeadersen una lista: elUser-Agento elRefererque el reproductor manda para cada canal de la lista, aparte de losheadersde descarga de la propia lista. Canales en vivo.- Una llamada
kino.*síncrona que falla se puede atajar (unkino.storagelleno, un error dekino.crypto): tutry/catchrecibe unErrornormal; 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
httpsde unkino-plugin.jsonen cualquier servidor público, no solo unowner/repode GitHub. Una instalaciónurl:así leeentryeiconal lado del manifiesto, no puede usarsecretssellados, siempre cuenta como no firmada y nunca sale en "De la comunidad" (el descubrimiento sigue usando el topic de GitHub). Una URL dekino-plugin.jsonen GitHub, raw.githubusercontent.com o jsDelivr (cdn.jsdelivr.net/gh/owner/repo@<ref exacta>/…;@latestes la rama por defecto, un rango de versiones se rechaza) se vuelveowner/repocomo antes. Instalar desde la URL del manifiesto, Publicar. liveSearch, un export opcional nuevo para canales en vivo (sinapiVersionnuevo: sigue siendo 3 conchannels). 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 deliveChannels, máximo 100 conservados, desde 2 caracteres escritos, 15 s. Canales en vivo.- Los catálogos en vivo grandes siguen paginando.
liveChannelsrecibe 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 connode sdk/run.mjs . live search <consulta>. - Listas M3U en UTF-8, Latin-1 o UTF-16; los atributos de
#EXTINFpueden 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. dituya no es unidde 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 deentryeicon. 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". Elvalidate.mjsdel 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.logde una llamada fallida (depuradas, 2 KB) van con el reporte del error comoplugin_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,
apiVersion5. Firma opcional del autor enkino-plugin.json(node sdk/seal.mjs --keygen,--sign;validate.mjsla 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 conapiVersion5. 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.apiVersionreporta 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 ponesheaders; 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(omanifest.json, para Nuvio) o unagithub.com/.../blob/...; una ref que solo viene de una URL pegada no es un pin. Inicio, Scrapers de Nuvio. - Descargas HLS:
EXT-X-DISCONTINUITYse 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"encapabilities, nada que exportar. Descargas. - Headers de canales M3U: se leen
#EXTHTTP,url|User-Agent=...y los headers de#KODIPROP; solo se conservanUser-Agent,Referer,OriginyCookie. 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 deresolve. 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.