An IINA plugin for tagging and organizing your media files. Create tags, assign them to videos and images while watching, and manage your library — all without leaving the player.
- Tag management — create, delete, and assign tags to media files
- Video overlay — see and toggle tags directly on the video player
- Keyboard shortcuts — configurable hotkeys for quick tag toggling
- SQLite-backed — lightweight local database per media directory
- Metadata extraction — automatically captures duration, resolution, file size, and more via ffprobe
- macOS with IINA installed
- Node.js (for building)
sqlite3(included with macOS)ffprobefrom FFmpeg — install viabrew install ffmpeg
git clone https://github.com/roboloop/media-manager.git
cd media-manager
npm install
npm run buildThen symlink the plugin into IINA's plugin directory:
ln -s "$(pwd)" ~/Library/Application\ Support/com.colliderli.iina/plugins/media-manager.iinapluginRestart IINA and enable the plugin in Settings → Plugins.
Open IINA plugin preferences to configure:
| Setting | Description |
|---|---|
| Media manager path | Absolute path to bin/main in this repo |
| Context directories | Semicolon-separated directories containing your media files (a SQLite DB is created in each) |
| Key binding prefixes | Modifier combos for tag hotkeys, key binding format |
npm run build # Bundle TypeScript → dist/
npm run watch # Watch mode with auto-rebuild