The modern video player for macOS.
Clone or download
alejx and lhc70000 Add translation in MPVFilter's init
Fixes #2155
The filters we get from mpv have no explicit keys, they are "@0", "@1"
instead of "w", "h". So that when we get update of filters via
`getFilters`, our local copy of filters will become massy.
Latest commit 13b2117 Jan 1, 2019


IINA is the modern video player for macOS.

Website · Releases · Telegram Group


  • Based on mpv, which provides the best decoding capacity on macOS
  • Designed for modern macOS (10.11+), aims to offer the best user experience
  • All the features you need for videos, audios, subtitles, playlist, chapters and so on
  • Force Touch, Picture-in-picture and (advanced) Touch Bar support
  • Customizable user interface including color schemes and on screen controller (OSC) layout
  • Standalone Music Mode designed for audio files
  • Thumbnail preview for the whole timeline like YouTube
  • Online subtitle searching and intelligent local subtitle matching
  • Unlimited playback history
  • Convenient and interactive settings for video/audio filters
  • Fully customizable keyboard, mouse and trackpad gesture control
  • MPV config files and script system are available for advanced users
  • Command Line Tool and browser extensions provided
  • Still in active development


Use pre-compiled dylibs

  1. Please make sure CocoaPods is installed.


sudo gem install cocoapods


brew install cocoapods
  1. Run pod install in project root directory.
pod install
  1. Open .xcworkspace file using Xcode 10.

There's a bug in cocoapods 1.5.*, so that you cannot compile IINA with it. Thankfully the bug was fixed in their master branch. We are using pre-release of cocoapods (currently 1.6.0 beta2) to avoid that bug. You can install the pre-release version of cocoapods via

sudo gem install cocoapods --pre

If you are unwilling to use the provided dylibs, follow the instructions below.

Build with the latest mpv

  • Install mpv

    brew install mpv --with-uchardet

    Feel free to include any other libraries if you like.

  • Copy latest header files into libmpv/include/mpv/

  • other/parse_doc.rb

    This script will fetch the latest mpv documentation and generate MPVOption.swift, MPVCommand.swift and MPVProperty.swift. This is only needed when updating libmpv. Note that if the API changes, the player source code may also need to be changed.

  • other/change_lib_dependencies.rb

    This script will deploy the depended libraries into libmpv/libs. Make sure you have a phase copying of all these dylibs in Xcode's build settings.


Please read before opening an issue or pull request.

Please ask for permission from the author before starting working on a pull request to make sure that there's not someone else working on the same feature.

Any feedback/contribution is appreciated!


Please check Translation Status first. If a language is labeled as "Need help", then please feel free to update the translation. If it doesn't contain your language, it will be awesome to submit a new translation. Please contact the author (@lhc70000) if you don't know how to submit translations using GitHub.