explaingit

kuameh/iina-store

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

An IINA plugin that adds an in-app store for browsing, searching, and one-click installing other community-made IINA plugins on macOS.

Mindmap

mindmap
  root((IINA Store))
    What it does
      Browse plugins
      One-click install
      Safety checks
    Catalog
      Bundled base list
      Daily GitHub crawl
      Upstash live overlay
    Tech Stack
      TypeScript
      React
      Node.js
    Audience
      macOS users
      Plugin developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse and install IINA plugins from inside the video player without leaving the app.

USE CASE 2

Keep your IINA plugin catalog current via a daily automated GitHub crawl.

USE CASE 3

Submit a community plugin to the curated catalog so other IINA users can find it.

What is it built with?

TypeScriptReactNode.jsParcelUpstash

How does it compare?

kuameh/iina-storeabidoo22/pixelorama-mcpaditya-pandey/slate
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedevelopervibe codergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires IINA 1.4.0 or later (for the bundled iina-plugin CLI) plus Node.js.

ISC license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

IINA Store is a plugin for the IINA video player on macOS. IINA is a popular open-source media player, but it has no official place to discover and install community-made plugins. This project fills that gap by creating a searchable catalog of IINA plugins that lives inside the app itself. Once you install IINA Store, you get a browsable, filterable list of other IINA plugins. You can sort them by name, star count, or how recently they were added. Installing a plugin takes one click, and the same goes for uninstalling. The installer includes safety checks: it guards against malicious or broken packages by verifying file paths and identifiers before anything gets written to disk. The catalog stays up to date automatically. A curated base list ships with every release of IINA Store, and a daily automated scan of GitHub collects new plugins tagged with the iina-plugin topic. That means the catalog can grow without you needing to update IINA Store itself. If the live catalog service is unreachable, the plugin falls back to the bundled list rather than breaking. The project is built with TypeScript and React. The UI has two surfaces: a full window for browsing and a smaller sidebar tab for a quick glance. These two views talk to the underlying plugin logic via a message-passing bridge. The live catalog overlay is fetched from a cloud database and cached locally for 12 hours. Development requires Node.js and the iina-plugin command-line tool, which ships with IINA 1.4.0 and later. You clone the repo, run npm install, build with Parcel, and link the folder as a development plugin in IINA. The project is licensed under the ISC license, a permissive open-source license that allows free use for any purpose.

Copy-paste prompts

Prompt 1
How do I install IINA Store on my Mac and use it to find new IINA plugins?
Prompt 2
I want to build an IINA plugin. How do I set up the development environment using the iina-plugin CLI and Node.js?
Prompt 3
How does IINA Store's daily crawler discover new plugins on GitHub and add them to the catalog?
Prompt 4
How do I submit my IINA plugin to the IINA Store curated catalog?

Frequently asked questions

What is iina-store?

An IINA plugin that adds an in-app store for browsing, searching, and one-click installing other community-made IINA plugins on macOS.

What language is iina-store written in?

Mainly TypeScript. The stack also includes TypeScript, React, Node.js.

What license does iina-store use?

ISC license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is iina-store to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is iina-store for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub kuameh on gitmyhub

Verify against the repo before relying on details.