IINA Plugin BookmarksGetting Started
Installation and setup guide for IINA Plugin Bookmarks
Getting Started
Get up and running with IINA Plugin Bookmarks in minutes.
Prerequisites
Before installing the plugin, ensure you have:
- macOS 10.15 (Catalina) or later
- IINA 1.3.0 or later (download here)
- Basic familiarity with IINA media player
IINA Plugin Bookmarks is specifically designed for IINA and cannot be used with other media players.
Installation
Install from GitHub (Recommended)
Use IINA's built-in GitHub installer:
- Open IINA Preferences (Cmd+,)
- Go to the Plugins tab
- Click Install from GitHub
- Enter
https://github.com/wyattowalsh/iina-plugin-bookmarks
IINA will fetch and install the latest release automatically.
Alternative: Install from Release Asset
Download the latest plugin asset from the GitHub Releases page, then install it in IINA.
Double-click iina-plugin-bookmarks.iinaplgz. IINA will automatically:
- Install the plugin
- Enable it in your preferences
- Load it on next startup
Alternatively, install manually:
- Open IINA Preferences (Cmd+,)
- Go to the Plugins tab
- Click + and select
iina-plugin-bookmarks.iinaplgz
Verify Installation
Open a video file in IINA and check the sidebar. You should see a Bookmarks tab.
If the sidebar isn't visible:
- Press Cmd+Shift+B to toggle the sidebar
- Or go to View → Toggle Sidebar
Building from Source
For development or to use the latest unreleased features:
Clone the Repository
git clone https://github.com/wyattowalsh/iina-plugin-bookmarks.git
cd iina-plugin-bookmarksInstall Dependencies
The project uses pnpm for package management:
# Install pnpm if you don't have it
npm install -g pnpm
# Install project dependencies
pnpm installBuild the Plugin
make buildThis compiles TypeScript, bundles the UI, and prepares the plugin for installation.
Package and Install
make packageThis creates packaging/iina-plugin-bookmarks.iinaplgz. Double-click to install in IINA.
Development builds may contain experimental features. For production use, download official releases.
First Use
Once installed, create your first bookmark:
Open a Video
Launch IINA and open any video file.
Navigate to Desired Timestamp
Play the video and pause at the moment you want to bookmark (e.g., an important scene or quote).
Create Bookmark
In the sidebar, click Add Bookmark. You can also use Plugin menu → Add Bookmark at Current Time or press Ctrl+B for a quick bookmark. The plugin will auto-detect:
- Current timestamp
- Video file path
- Media title (from filename or metadata)
Optionally, add:
- Custom description
- Tags for organization
Click Save.
Jump to Bookmark
Click any bookmark in the list to instantly jump to that timestamp in the video.
UI Modes
IINA Plugin Bookmarks offers three interface modes:
Sidebar (Recommended)
Integrated IINA sidebar with full functionality:
- View all bookmarks
- Add, edit, delete bookmarks
- Filter and search
- Import/export data
Access: Cmd+Shift+B or View → Toggle Sidebar
Overlay
Lightweight overlay for quick bookmark jumping:
- Minimal interface
- Search bookmarks
- Quick jump to timestamp
Access: Plugin menu → Toggle Bookmarks Overlay
Standalone Window
Independent window with complete features:
- Same functionality as sidebar
- Can be positioned anywhere on screen
- Useful for multi-monitor setups
Access: Plugin menu → Manage Bookmarks
Next Steps
- Learn about Bookmark Management
- Explore Filtering and Search
- Review interface details in User Interface
- Import existing bookmarks via Data Management
Troubleshooting
Plugin Not Appearing
- Check that IINA version is 1.3.0 or later
- Restart IINA after installation
- Check Preferences → Plugins to ensure it's enabled
Bookmarks Not Saving
- Check file permissions for IINA's plugin storage directory
- Restart IINA to trigger auto-save
- Try manual backup via Export function
UI Not Loading
- Clear cache: Close IINA, delete
~/Library/Application Support/com.colliderli.iina/plugin_data/ - Reinstall the plugin
- Check Console.app for JavaScript errors
For additional help, open an issue on GitHub.