iina/iina

IINA

IINA is the modern video player for macOS.

Website · Releases · Telegram Group

---

Features

• Based on mpv, which provides the best decoding capacity on macOS
• Designed with modern versions of macOS (11.0+) in mind
• All the features you need for video and music: subtitles, playlists, chapters…and much, much more!
• Force Touch, picture-in-picture and advanced Touch Bar support
• Customizable user interface including multiple color schemes and on screen controller (OSC) layout positioning
• Standalone Music Mode designed for audio files
• Video thumbnails
• Online subtitle searching and intelligent local subtitle matching
• Unlimited playback history
• Convenient and interactive settings for video/audio filters
• Fully customizable keyboard, mouse, trackpad, and gesture controls
• mpv configuration files and script system for advanced users
• Command line tool and browser extensions provided
• In active development

Downloading

You can get IINA through several sources. For the latest stable and beta releases, visit the GitHub release page or the IINA official website. If you want to try out the latest features and improvements before they are officially released, you can download the nightly builds from our Nightly Download Page.

[!IMPORTANT]

Nightly builds are generated by GitHub automatically for every commits, which might be buggy and unusable. If you find a bug, please follow the contributing section and file an issue.

Building

IINA uses mpv for media playback. To build IINA, you can either fetch copies of these libraries we have already built (using the instructions below) or build them yourself by skipping to these instructions.

Using the pre-compiled libraries

1. Download pre-compiled libraries by running

./other/download_libs.sh

[!TIP]

- By default the shell script downloads universal binaries. You can download arch-specific binaries using --arch (universal, arm64 or x86_64)

- Files are downloaded in parallel (5 concurrent downloads by default). You can change this using --parallel (from 1 to...)

- If you want to build an older IINA version you must change DYLIBS_DOWNLOAD_PATH in the script to download the corresponding dylibs. For example, https://iina.io/dylibs/1.2.0/universal/fileList.txt.

2. Open iina.xcodeproj in the latest public version of Xcode. IINA may not build if you use any other version.

3. Build the project.

Building mpv manually

1. Build your own copy of mpv. You can use our official build scripts to build mpv and all other dependencies.

2. Run other/parse_doc.rb. This script will fetch the latest mpv documentation and generate MPVOption.swift, MPVCommand.swift and MPVProperty.swift. Copy them from other/ to iina/, replacing the current files. This is only needed when updating libmpv. Note that if the API changes, the player source code may also need to be changed.

3. Link the yt-dlp dependency to deps/executable

   mkdir -p deps/executable
   ln -s $(which yt-dlp) deps/executable/youtube-dl
   

4. Open iina.xcodeproj in the latest public version of Xcode. IINA may not build if you use any other version.

5. Remove all references to .dylib files from the Frameworks group in the sidebar and add all the .dylib files in deps/lib to that group by clicking "Add Files to iina..." in the context menu.

6. Add all the imported .dylib files into the "Copy Dylibs" phase under "Build Phases" tab of the iina target.

7. Make sure the necessary .dylib files are present in the "Link Binary With Libraries" phase under "Build Phases". Xcode should have already added all dylibs under this section.

8. Build the project.

Contributing

IINA is always looking for contributions, whether it's through bug reports, code, or new translations.

• If you find a bug in IINA, or would like to suggest a new feature or enhancement, it'd be nice if you could search your problem first; while we don't mind duplicates, keeping issues unique helps us save time and consolidates effort. If you can't find your issue, feel free to file a new one.
• If you're looking to contribute code, please read CONTRIBUTING.md — it has information on IINA's process for handling contributions, and tips on how the code is structured to make your work easier.
• If you'd like to translate IINA to your language, please visit IINA's instance of Crowdin. You can create an account for free and start translating. Please do not send a pull request to this repo directly, Crowdin will automatically sync new translations with our repo. If you want to translate IINA into a new language that is currently not on the list, feel free to open an issue.

IINA Plugins List

Official Plugins

• Online Media (iina/plugin-online-media) - Enhances online streaming and downloading.
• OpenSubtitles (iina/plugin-opensub) - Search and download subtitles.
• User Scripts (iina/plugin-userscript) - Run custom JavaScript snippets.

Community Plugins

• AirPlay (ozykhan/iina-airplay) - Cast the current file to an Apple TV over AirPlay; IINA stays the remote.
• Anime4K (yorkyang2333/iina-anime4k) - Apply Anime4K shaders for real-time anime upscaling.
• Auto Skip (pangziqiang/iina-auto-skip) - Automatically skip intro and outro sections with visual drag-to-set overlay.
• Bilingual Audio (glechic/iina-bilingual-audio) - Play two audio tracks with left/right channel separation for bilingual viewing.
• Bookmarks (wyattowalsh/iina-plugin-bookmarks) - Save and manage video timestamps.
• CineMode (D0CA/iina-cinemode) - Fullscreen pause overlay and skip intro; optional Stremio next-episode shortcut.
• Clickable Subtitles (kerim/iina-clickable-subtitles) - Click subtitles to define words (macOS Look Up).
• Danmaku (xjbeta/iina-plugin-danmaku) - Overlay comments/danmaku on video.
• Danmaku Cosmos (karappo-yu/iina-plugin-danmaku-cosmos) - Niconico/Bilibili danmaku with CSS/Canvas dual rendering, Comment Art support.
• Detached Playlist (HowDidTheCatGetSoFat/iina-detached-playlist) - Show the playlist in a separate floating window.
• Episode Info (Zain-Imam/iina-episode-info) - TMDB episode/movie info overlay on pause, with built-in subtitle search.
• File Viewer (qktechies/iina-plugin-file-viewer) - bookmark folders, browse directory contents, and play video files directly within IINA.
• Hold to Speed (Tommy12356F/iina-hold-to-speed) - Hold Space to play at 2× speed, just like YouTube.
• Jellyfin (mhajder/iina-jellyfin) - Browse and play media from Jellyfin servers.
• Jump to Frame (bbeny123/iina-jump-to-frame) - Navigate video by specific frame number.
• ListenBrainz Scrobbler - Scrobble your music to ListenBrainz.
• Multiple Clips (karthisnk/multi-cutter-iina) - multiple clip of a video using ffmpeg, with Batch Clipping, Vertical Clip, Format Selection, Preview Clip.
• PiP Toggle for IINA (nastarandarjani/iina-pip-toggle) - Simple plugin to toggle Picture-in-Picture (PiP) to fullscreen.
• Playlist Pro (CatCodeDanix/iina-playlist-pro) - Seamless management of local and online playlists.
• Playlist Searchbox (icsarisakal/iina-playlist-searchbox) - Search the current playlist by song title and artist.
• PolyScript (SammoMichael/polyplugin-release) - Dual subtitles, hover dictionary, and AI-assisted translation for language learning.
• recorder (5thDimensionalVader/recorder-iina) - to clip a video using ffmpeg.
• Skip Intro (pparanoiidd/iina-skip-intro) - Detect and skip intros, recaps and credits.
• SubTandem (janwee-sha/SubTandem) - A powerful plugin for real-time AI-powered bilingual subtitle translation.
• Thumbnails (aminozuur/iina-thumbnails) - An IINA plugin that shows clickable thumbnails for each video.
• Trakt Scrobbler (i3p9/iina-trakt-scrobbler) - Trakt.tv scrobbler plugin for IINA.
• VR2D (fetzu/iina-plugin-vr2d) - Watch 3D VR videos (180°/360°, side-by-side or over-under) flat, with pan, zoom and automatic detection.

💡 Want to build your own plugin?

> Explore the existing plugins listed here to learn how they work. If you create a new plugin or improve an existing one, feel free to contribute back by adding it to this list via a pull request.