You can support us by downloading this article as PDF from the Link below. Download the guide as PDF

IINA is a modern video player for macOS based on mpv, which provides the best decoding capacity on macOS. This is the best video player you can install on macOS and use it as a default player for all Video media files. IINA is designed with modern versions of macOS (10.11+) to guarantee stability and compatibility with all Mac machines. All the features you need for video and music, like playlists, subtitles, chapter and many others are provided in IINA video player.

Some of the cool features shipped with IINA video player are:

  • 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

Install IINA Video player for macOS

We can now look at the methods of installing IINA Video player on macOS. One is by downloading a .dmg package and installing from it. Or going the manual way of building IINA Video player manually on your macOS system.

Install with binary package (The easy way)

For the binary installation method, head over to Downloads page and pull the latest package.

For terminal installation you can use wget or curl command to download .dmg file.

cd ~/Downloads

Once the file is downloaded open it to initiate an installation of IINA Video Player on macOS:

open IINA.v1.0.7.dmg

Application installation window will be opened for you to complete installation.

install IINA video player macos 01

Drag the application to the “Applications” folder.

install IINA video player macos 02

The application is then ready for use. You can find it in Spotlight Search.

install IINA video player macos 03

The same installation can be done via Homebrew cask.

/bin/bash -c "$(curl -fsSL"
brew cask install iina

Browser extensions

You can open various online media in IINA directly from web browsers by using our browser extensions.

The Safari App Extension is already included in the IINA App bundle, and you may only need to enable it in Safari Preferences. Extensions for other browsers could be downloaded below.

Nightly builds

Manual Installation (The Hard way)

You should have CocoaPods installed in your macOS system before you can download IINA video player. Run the following commands in your macOS terminal to install CocoaPods on macOS.

$  brew install cocoapods
==> Downloading
==> Downloading from
######################################################################## 100.0%
==> Pouring cocoapods-1.9.3.catalina.bottle.tar.gz
🍺  /usr/local/Cellar/cocoapods/1.9.3: 12,523 files, 28.3MB

If brew command line tool is not available, install it with the following commands:

/bin/bash -c "$(curl -fsSL"

Installation of CocoaPods can also be done with RubyGems.

$ sudo gem install cocoapods

Once CocoaPods is installed, download project source code from Github:

$ git clone
Cloning into 'iina'...
remote: Enumerating objects: 287, done.
remote: Counting objects: 100% (287/287), done.
remote: Compressing objects: 100% (114/114), done.
remote: Total 23990 (delta 183), reused 265 (delta 173), pack-reused 23703
Receiving objects: 100% (23990/23990), 232.13 MiB | 3.50 MiB/s, done.
Resolving deltas: 100% (18541/18541), done.

Navigate to the project’s root directory:

cd iina

Run the command

pod install

This is my dependencies installation output:

Analyzing dependencies
Pre-downloading: `GRMustache.swift` from ``, commit `a46e65d00b4753449b90465be813bbdb1a9ffc9d`
Pre-downloading: `Just` from ``, commit `d0ae3f9bc2d6bf247b19217764a096bbac55f007`
Adding spec repo `trunk` with CDN ``

CocoaPods 1.10.0.rc.1 is available.
To update use: `gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see and the CHANGELOG for this version at

Downloading dependencies
Installing GRMustache.swift (2.0.0)
Installing GzipSwift (5.0.0)
Installing Just (0.7.1)
Installing PromiseKit (6.8.4)
Installing Sparkle (1.22.0)
Generating Pods project
Integrating client project
Pod installation complete! There are 5 dependencies from the Podfile and 5 total pods installed.

Use the tap as it passes in the correct flags to mpv’s configure script:

brew tap iina/homebrew-mpv-iina
brew install mpv-iina

Copy the latest header files from mpv (*.h) into deps/include/mpv/.

wget -O deps/include/mpv/client.h
wget -O deps/include/mpv/mpv.def
wget -O deps/include/mpv/
wget -O deps/include/mpv/opengl_cb.h
wget -O deps/include/mpv/render.h
wget -O deps/include/mpv/render_gl.h
wget -O deps/include/mpv/stream_cb.h

Run below script to fetch the latest mpv documentation and generate MPVOption.swift, MPVCommand.swift and MPVProperty.swift:


Run the script to deploy the dependent libraries into deps/lib:

other/change_lib_dependencies.rb "$(brew --prefix)" "$(brew --prefix mpv-iina)/lib/libmpv.dylib"


  • Open iina.xcworkspace in the latest public version of XcodeIINA may not build if you use any other version
  • Remove all of references to .dylib files from the Frameworks group in the sidebar and drag all the .dylib files in deps/lib to that group.
  • Drag all the .dylib files in deps/lib into the “Embedded Binaries” section of the iina target.
  • Build the project.

Enjoy playing your Video content with IINA video player on macOS.

You can support us by downloading this article as PDF from the Link below. Download the guide as PDF


Please enter your comment!
Please enter your name here