Skip to content

wyattowalsh/iina-plugin-dev

v0.2.0-a2MIT

User-installed plugin for IINA plugin authors: generate from a Copier source (git URL or ZIP) the author names, then develop in the generated IINA plugin repo.

iina-development

Use when developing, testing, or debugging a typed IINA plugin in a generated IINA plugin repo: JavaScriptCore host (main/global), sidebar/overlay/controller WKWebView UI, shared protocol, Info.json, and pnpm run check. NOT for creating a project from a Copier source (git URL or ZIP), iina-generate (user-installed only), template upgrade, packing a native IINA plugin package, catalog maintainer work, or substituting pnpm pack for pnpm run pack.

iina-generate

Use when creating a new IINA plugin tree from a Copier source (git URL or ZIP) the author names: run copy_argv.py describe, then uvx --from copier==9.18.2 copier copy with the returned argv (--vcs-ref required; --prereleases when argv says so) into an empty destination. NOT for catalog maintainer work, generated IINA plugin repo development/package/upgrade, embedding the Agent Plugins kit, inventing Copier argv, or wrapping Copier in Python.

iina-package

Use when the user asked to pack a generated IINA plugin repo into a native IINA plugin package (.iinaplugin / .iinaplgz) with pnpm run pack after check, build, and verify:stage. NOT for host/UI/Info.json source work, Copier template updates, pnpm pack / npm pack, publishing, gh release, catalog maintainer work, iina-generate, or restarting IINA.

iina-upgrade

Use when applying a reviewed Copier template update in a generated IINA plugin repo: run answers_lineage.py first, refuse fixture or missing answers (ok=false), then copier update or pnpm run template:update pinned to Copier 9.18.2. NOT for creating a new tree from a Copier source (git URL or ZIP), catalog maintainer work, packing a native IINA plugin package, host/UI source work, --overwrite, or --trust/--UNSAFE when lineage unsafe is false.