Skip to content

About

Cómo crear plugins para Kino: guía, contrato, kit y prompt para IA.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Kino plugins

Everything you need to write a plugin for Kino, the Android video app for phones and TVs: the manifest, the contract, the kino API, every limit, how to test with the Node kit, and how to be found in the app's "De la comunidad" list.

Read it at https://kinotvapp.github.io/kino-plugins/ — Spanish by default, English with the language switcher.

  • Start from an example: kinotvapp/kino-plugin-archive (Internet Archive; the simplest starting template, with the sdk/ kit) and kinotvapp/kino-plugin-own-server ("Tu servidor" 1.5.0, the complete API demo: your own media server and every feature up to apiVersion 7 end to end).
  • Sync providers (apiVersion 12, Kino 0.9.74): a plugin can carry the person's Kino sync between their devices through a service: Sync providers, with three example providers in public repositories: Sync-Gram, on a Telegram bot of the person's own, Sync Servidor, on a server they run (not listed), and Sync-Gram Cuenta, on the person's own Telegram account (apiVersion 13, not listed).
  • apiVersion 13 (Kino 0.9.74): sockets and streams the plugin serves itself (Sockets and plugin-served bytes), a SQLite catalog and a larger storage (Catalog and large storage), images the plugin serves (Images from the plugin) and QR codes (QR codes).
  • Screens (apiVersion 14, Kino 0.9.74): a plugin can draw its own full screen inside Kino from a JSON tree of Flutter-style components, the same tree on the phone and the TV, and the preferred way to build a plugin's UI: Screens and the component catalogue (layout, content and actions, forms, overlays and navigation, state, style and recipes); also player-panel tabs on any title, rooms, background jobs, shared results and AI, and enhancements to offer all of it without raising your apiVersion. Examples: kino-plugin-ui-gallery, kino-plugin-news and kino-plugin-watch-party.
  • Identity, notices and plugin stores (apiVersion 15, Kino 0.9.77): a plugin can know who the person is without a sign-up (Identity), leave notices in the Home bell (Notices in the bell) and be a store, a source of plugins for Kino's store, local (a static list) or live (its own API); the store view has the tabs "De Kino", "De la comunidad" and "Instalados", one plugin per id across stores: Plugin stores and two copyable example stores.
  • Kino coins and apiVersion 17 (apiVersion 16 arrives with Kino 0.9.78; apiVersion 17 with Kino 0.9.81): the coins capability (kino.coins), kino.sync.setActive, kino.library.stats, per-profile jobs, the pages widget and more: What's new.
  • Plugins that use each other (apiVersion 20, Kino 0.9.81): a plugin opens named doors (provides) and another uses them through Kino (consumes, kino.plugins.call), validated both ways, with an install button instead of silent installs: The plugin protocol. Example pair: kino-plugin-cine-trivia (consumer) and kino-plugin-tmdb (provider, TMDB 1.3.0 and later). Start one with the kit's scaffold, node sdk/init.mjs my-plugin --kind provider or --kind consumer, and try a provider on its own with node sdk/run.mjs <provider folder> proto <door>.<call> '<json>' (Testing offline with the kit).
  • A browser window the person drives (apiVersion 20, Kino 0.9.81): "visualBrowser": true and kino.visualBrowser.open open a web window on your own hosts that the person uses to sign in or finish a step, and can store the cookies straight into one of your settings: A browser window the person drives.
  • Signed plugins (optional, Kino 0.9.45+): sign your plugin with your own key so people know every update is yours: Signed plugins. What changed for authors, by Kino version: What's new.
  • Building with an AI assistant? Point it at AGENTS.md, or at llms-full.txt (the whole guide in one file). The site has a ready-to-paste prompt.
  • Machine-readable contract: contract.json and kino.d.ts.

Working on the docs

python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
mkdocs serve            # http://127.0.0.1:8000, both languages
mkdocs build --strict   # what CI runs

Each page is a pair: docs/<page>.md (Spanish) and docs/<page>.en.md (English); the build fails if one is missing. hooks/llms.py writes llms-full.txt and copies AGENTS.md to the site root. scripts/sync-from-kino-light.sh refreshes contract.json, kino.d.ts and the generated tables from Kino's repository and reports upstream guide changes to port. Pushing to main publishes the site with GitHub Actions.

License

The documentation, the site tooling and the reference files in this repository are licensed under the Apache License 2.0. Copyright 2026 kinotvapp.

About

Cómo crear plugins para Kino: guía, contrato, kit y prompt para IA.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages