The modern video player for macOS.
Swift C C++ Ruby Lua Objective-C GLSL



IINA is a modern video player for macOS.
Published under GPLv3.



Telegram group:

When raising an issue, please use English if possible.

在提 issue 时,请尽量使用英文


  • Based on mpv, a powerful media player
  • Designed for modern macOS (10.10+)
  • User-friendly interface
  • All the features you need for videos, audios and subtitles
  • Supported basic playlist and chapters
  • MPV config files and script system are available for advanced users
  • Written in Swift, followed up on new technologies like Touch Bar
  • Still in active development


Use pre-compiled dylibs

  1. Please make sure CocoaPods is installed.


    sudo gem install cocoapods


    brew install cocoapods
  2. Run pod install in project root directory.

    pod install

Theoretically no extra work is needed. If you are unwilling to use the provided dylibs, follow the instructions below.

Build with the lastest mpv

  • Install mpv

    brew install mpv --with-uchardet

    Currently ytdl is not included when building, but will be considered in later versions.

  • other/parse_doc.rb

    This script will fetch the lastest 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.

Any feedback is appreciated! You can

  • Star it or fork it
  • Download and test it
  • Send bug reports
  • Send feature requests
  • Provide suggestions on code structures or UI designs
  • Provide localizatons
  • ...