The modern video player for macOS.
IINA is the modern video player for macOS.
Website · Releases · Telegram Group
Features
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
./other/download_libs.sh
https://iina.io/dylibs/${ARCH}/fileList.txt
where ARCH
can be universal
, arm64
and x86_64
.https://iina.io/dylibs/1.2.0/universal/fileList.txt
.Open iina.xcodeproj in the latest public version of Xcode. IINA may not build if you use any other version.
Build the project.
Building mpv manually
Build your own copy of mpv. If you're using a package manager to manage dependencies, the steps below outline the process.
With HomebrewUse our tap as it passes in the correct flags to mpv's configure script:
brew tap iina/homebrew-mpv-iina brew install mpv-iinaWith MacPorts
Pass in these flags when installing:
port install mpv +uchardet -bundle -rubberband configure.args="--enable-libmpv-shared --enable-lua --enable-libarchive --enable-libbluray --disable-swift --disable-rubberband"
Copy the corresponding mpv and FFmpeg header files into deps/include/
, replacing the current ones. You can find them on GitHub (e.g. mpv), but it's recommended to copy them from the Homebrew or MacPorts installation. Always make sure the header files have the same version of the dylibs.
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.
Run other/change_lib_dependencies.rb
. This script will deploy the dependent libraries into deps/lib
. If you're using a package manager to manage dependencies, invoke it like so:
other/change_lib_dependencies.rb "$(brew --prefix)" "$(brew --prefix mpv-iina)/lib/libmpv.dylib"With MacPorts
port contents mpv | grep '\.dylib$' | xargs other/change_lib_dependencies.rb /opt/local
Open iina.xcodeproj
in the latest public version of Xcode. IINA may not build if you use any other version.
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.
Add all the imported .dylib
files into the "Copy Dylibs" phase under "Build Phases" tab of the iina target.
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.
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 and/or approving. 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.
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.