Install IINA-a modern video player for macOS

You can download this article in PDF format via the link below to support us.Download the guide in PDF formatClose

IINA is a modern video player based on macOS mpv, Which can provide the best decoding capability on macOS. This is the best video player you can install on macOS and use it as the default player for all video media files. IINA is designed to use a modern version of macOS (10.11+) to ensure stability and compatibility with all Mac machines. IINA video player provides all the functions needed for video and music, such as playlists, subtitles, chapters and many other functions.

Some of the cool features that come with the IINA video player include:

  • Forced touch, picture-in-picture and advanced touch bar support
  • Customizable user interface, including multiple color schemes and screen controller (OSC) layout positioning
  • Independent music mode specially designed for audio files
  • Video thumbnail
  • Online subtitle search and smart local subtitle matching
  • Unlimited playback history
  • Convenient and interactive setting of video/audio filters
  • Fully customizable keyboard, mouse, trackpad and gesture controls
  • Mpv configuration file and script system for advanced users
  • Provided command line tools and browser extensions
  • Actively developing

Install IINA Video Player for macOS

Now let’s take a look at how to install IINA Video Player on macOS.One is by downloading .dmg Package and install from it. Or manually build IINA Video Player on macOS system.

Install using a binary package (easy way)

For the binary installation method, go to Download page And pull out the latest packaging.

For terminal installation, you can download the .dmg file using wget or curl commands.

cd ~/Downloads

After downloading the file, open it to start the installation of IINA Video Player on MacOS:

open IINA.v1.0.7.dmg

The application installation window will open for you to complete the installation.

Drag the application to “Application field“folder.

Install IINA-a modern video player for macOS

Then you can use the application. You can find it in Spotlight search.

Install IINA-a modern video player for macOS

The same installation can be done with Homebrew casks.

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

Browser extension

You can use our browser extension to open various online media in IINA directly from your web browser.

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

Built every night

Manual installation (difficult way)

You should have Cocoa beans You must install it on macOS before you can download IINA video player. Run the following command in 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 the brew command line tool is not available, use the following command to install:

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

The installation of CocoaPods can also be done through RubyGems.

$ sudo gem install cocoapods

Once CocoaPods is installed, please download the 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 root directory of the project:

cd iina

Run command

pod install

This is the output of my dependency installation:

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.

When the correct flag is passed to the mpv configuration script, use it:

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

Copy the latest mpv header file (*.H) becomes 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 the following script to get the latest mpv document and generate MPVOption.swift, MPVCommand.swift and MPVProperty.swift:


Run the script to deploy the dependent library to 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 Xcode. If you use any other version, you may not be able to build IINA
  • Remove all references to .dylib files from the Frameworks group in the sidebar and drag all .dylib files to deps/lib To that group.
  • Drag all .dylib files into deps/lib Go to the “Embedded Binary File” section of the iina target.
  • Build the project.

Use IINA video player to play video content on macOS.

You can download this article in PDF format via the link below to support us.Download the guide in PDF formatClose