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
Download the Plugin
Download the latest release from the GitHub Releases page.
Look for the .iinaplugin file in the release assets.
Install in IINA
Double-click the downloaded .iinaplugin file. 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 the
.iinapluginfile
Verify Installation
Open a video file in IINA and check the sidebar. You should see a Bookmarks section.
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 dist/iina-plugin-bookmarks.iinaplugin. 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. 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
- Cloud sync
Access: Cmd+Shift+B or View → Toggle Sidebar
Overlay
Lightweight overlay for quick bookmark jumping:
- Minimal interface
- Search bookmarks
- Quick jump to timestamp
Access: Configure hotkey in IINA preferences
Standalone Window
Independent window with complete features:
- Same functionality as sidebar
- Can be positioned anywhere on screen
- Useful for multi-monitor setups
Access: Via IINA menu → Plugins → Bookmarks → Open Window
Next Steps
- Learn about Bookmark Management
- Set up Cloud Sync for cross-device access
- Explore Filtering and Search
- 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.