IINA: The Modern macOS Video Player That's Actually Developer-Friendly

If you've been on macOS long enough, you know the video player landscape is a weird mix of VLC (great, but aging UI), QuickTime (limited), and a bunch of abandoned projects. There's this gap where you want something that feels native, plays everything, and doesn't look like it's from 2010.

Enter IINA. It's an open-source video player for macOS, built on top of mpv (the command-line powerhouse for video playback). But instead of making you wrestle with config files and terminal incantations, it wraps all of that into a clean, macOS-native interface. And it's not just a skin on top of mpv—it integrates deeply with the system.

What It Does

IINA is a modern video player that plays pretty much any format you throw at it, thanks to its mpv backend. It handles everything from 4K HDR content, to old anime encodes, to streaming URLs. The core idea is simple: bring the power of mpv to a GUI that feels like it was designed for macOS, not ported over from Linux.

Why It's Cool

A few things stand out if you're a developer or a power user:

• macOS native, not just a port. It uses Swift, supports the touch bar, picture-in-picture, dark mode, and even the Media key on your keyboard. It feels like an Apple app, but without the limitations.
• mpv under the hood, but controllable. You get all the flexibility of mpv (hardware acceleration, custom shaders, scriptable filters) but you can set it up through a preferences window. No editing random config files in ~/.config/mpv unless you want to.
• Plugins and scripts. You can extend it with Lua scripts (same ones you'd use with mpv) or JavaScript. That means you can add subtitle search, audio equalizers, or even custom OSD overlays without forking the app.
• Playlist and queue management. It handles playlists like a proper media player, and supports drag-and-drop, auto-advance, and network streams.
• Keyboard shortcut heaven. It remaps mpv's keyboard controls to something sane for macOS, but you can customize every single shortcut in a GUI. No need to memorize arcane mpv keybindings.

The real kicker is that it's actively maintained, with regular releases and a responsive community on GitHub. It's not one of those "abandoned after v1.0" projects.

How to Try It

Go grab the latest release from the IINA GitHub repository. You can download the .dmg file directly from the releases page, or install it via Homebrew:

brew install --cask iina

That's it. Open it, drag in a video file, and you're done. If you're coming from mpv, you'll feel right at home with the keyboard shortcuts. If you're coming from VLC, you'll appreciate the cleaner UI.

Final Thoughts

IINA is one of those rare open-source projects that actually improves on its upstream (mpv) without sacrificing power. For developers, it's a joy because you can tweak it via scripts and configs, but you don't have to. For casual users, it just works and looks great. If you're on macOS and still using VLC out of habit, give IINA a spin. It might just convert you.

Follow us at @githubprojects for more developer tools and open-source finds.