IINA Plugin Development Skill

Build plugins for IINA, the modern macOS media player, using the React/TypeScript starter kit in this repository.

Architecture

IINA plugins have two execution environments:

1. Entry scripts (src/index.ts, src/global.ts) — Run in JavaScriptCore. No DOM. Access IINA APIs via the global iina object.
2. React webviews (src/ui/*/) — Run in WKWebView. Full DOM + React. Communicate with entry scripts via postMessage/onMessage.

┌───────────────────────────────────────────────────┐
│ IINA Player                                        │
│  ┌──────────────┐    postMessage    ┌────────────┐ │
│  │ Entry Script  │ ◄──────────────► │  Webview   │ │
│  │ (JSContext)   │    onMessage     │  (React)   │ │
│  │               │                  │            │ │
│  │ iina.core     │                  │ Overlay    │ │