Source: Love Mac | Software download link: IINA for Mac
IINA is an open-source video player built specifically for macOS, based on the powerful mpv media engine and deeply integrated with macOS’s design language and system features (such as Touch Bar, Force Touch, Dark Mode, Picture-in-Picture, etc.). It aims to provide users with a smooth, beautiful, and powerful local video playback experience, and is regarded as one of the best modern players on macOS.
I. Detailed Explanation of the Core Interface and Workspace
IINA’s interface design follows macOS’s minimalist aesthetic and is mainly divided into the following areas:
- Main playback window: The core display area for video content. It features a borderless design and intelligently adapts to the video aspect ratio.
- Control bar: Hidden by default; it appears when the mouse moves to the bottom of the window or when the spacebar is pressed. It includes core control buttons such as play/pause, progress bar, volume, playback speed, subtitle/audio track selection, full screen, and Picture-in-Picture.
- Top title bar/menu bar: Integrates window control buttons and provides access to all advanced functions through the menu bar (playback, video, audio, subtitles, chapters, etc.).
- Sidebar Information Panel: You can open it with the shortcut
Cmd + Ior by clicking the “Information” button on the far right of the control bar. The panel contains multiple tabs such as “Playlist,” “Chapters,” “Subtitles,” “Audio Tracks,” “Video Effects,” and “Audio Effects,” used for refined media management and parameter adjustments. - Mini Player: Enable it via the menu bar “Window” -> “Mini Player” or the shortcut
Cmd + Shift + M. It provides a minimalist floating control bar, suitable for use during multitasking.
II. Complete Workflow: From Opening to Playback Control
1. Create/Open a Project (Play Media Files)
Method 1: Drag and drop directly. Drag video or audio files onto the main window of IINA or the Dock icon.
Method 2: Use the menu or shortcut. Go to the menu bar “File” -> “Open…” or use the shortcut Cmd + O, then select the file in the Finder window that appears.
Method 3: Open a URL. Go to the menu bar “File” -> “Open URL…” or use the shortcut Cmd + U, and enter the network video stream address for online playback.
2. Basic Playback Controls
- Play/Pause: Click the control bar button, press the
Spacebar, or use the Touch Bar. - Fast Forward/Rewind: Use the left and right arrow keys (
←/→) for short jumps (default 5 seconds). Combine with theShiftkey (Shift + ←/→) for long jumps (default 60 seconds). - Volume adjustment: Use the control bar slider, press the
↑/↓arrow keys, or scroll the mouse wheel over the volume icon. - Toggle fullscreen: Click the fullscreen button in the control bar, double-click the video画面, or press the shortcut
Cmd + F. - Picture-in-Picture: Click the Picture-in-Picture button in the control bar or press the shortcut
Option + Cmd + P.
3. Subtitle and Audio Track Management
During playback, if the media file contains embedded or externally attached subtitle/audio track files:
- Switch subtitles: Click the “Subtitles” icon in the control bar, or use the shortcut
Vto cycle through. In the “Subtitles” tab of the sidebar information panel, you can make more detailed settings (adjust delay, size, style, etc.). - Switch audio tracks: Click the “Audio Track” icon in the control bar, or use the shortcut
Ato cycle through. In the “Audio Effects” tab, you can adjust parameters such as the equalizer. - Load external subtitles: Drag the subtitle file into the playback window, or load it via the menu bar “Subtitles” -> “Add Subtitle File…”.
4. Playlist and Chapter Navigation
When opening multiple files or a playback folder, IINA automatically generates a playlist.
- View playlist: Open the sidebar information panel (
Cmd + I) and switch to the “Playlist” tab. - Switch to previous/next track: Use the shortcuts
Cmd + Option + ←/Cmd + Option + →, or click the navigation buttons on either side of the control bar. - Chapter navigation: For videos that support chapters (such as Blu-ray discs, MKV), you can click to jump in the “Chapters” tab in the sidebar, or use the shortcuts
Cmd + [andCmd + ].
5. Final Export (Screenshots & Recording)
IINA does not handle video transcoding export, but it provides high-quality media capture features.
Screenshots:
- Capture current frame: Menu bar “Video” -> “Screenshot” -> “Screenshot”, or press the shortcut
Cmd + S. The screenshot will be automatically saved to the preset folder (which can be changed in Preferences). - Capture and preview: Use the shortcut
Cmd + Shift + S. After taking the screenshot, a preview window will pop up for instant editing or sharing. - Capture GIF: Menu bar “Video” -> “Screenshot” -> “GIF…” lets you record a short clip as an animated GIF.
Audio recording: Menu bar “Audio” -> “Audio Recording…” enables the audio recording feature, saving the currently playing audio stream as a file.
III. Advanced Tips for Common Features
1. Precise Frame Stepping and Bookmark Features
Frame-by-frame viewing: After pausing, use the . (period) key to step forward one frame, and the , (comma) key to step back one frame.
Set bookmarks: Press Cmd + B at a specific point in time to add a bookmark. Later, you can quickly jump to it via the menu bar “Playback” -> “Bookmarks”, which is very suitable for marking highlight clips or study points.
2. Mouse Gestures and Shortcut Enhancements
On the video screen:
- Swipe up or down with two fingers: Adjust the volume.
- Swipe left or right with two fingers: Fast forward/rewind.
- Single tap with three fingers: Toggle full screen.
On the progress bar:
- Hold the
Optionkey and click anywhere on the progress bar to enable the “quick preview” feature and quickly preview the frame at that position.
3. Advanced Video Adjustments
Open the “Video Effects” tab in the sidebar (press Cmd + I and then switch to it), where you can:
- Manually adjust brightness, contrast, saturation, and gamma.
- Apply preset video filters (such as inverse telecine, denoise, sharpen, etc.).
- Achieve a green-screen-like keying effect through “Chroma Key”.
IV. Common Problems and Solutions
Q1: No sound or stuttering when playing certain video formats.
Solution: This is usually related to the audio/video decoder. First, try switching to a different decoder (such as automatic, hardware decoding, software decoding) under “Video” -> “Video Decoding Method” or “Audio” -> “Audio Decoding Method” in the menu bar. For network streams, you can adjust the cache size in the “Network” tab of the preferences settings.
Q2: External subtitles won’t display or show garbled text.
Solution:
- Make sure the subtitle file and the video file are in the same directory and share the same base filename.
- In the “Subtitles” tab of the sidebar, manually select the subtitle file to load.
- If the subtitles are garbled, click “Styles…” below the “Subtitles” tab, and in the pop-up window try changing the “Encoding” to the correct language encoding (e.g., GBK, UTF-8).
Q3: Colors look washed out when playing 4K HDR videos.
Solution: IINA supports HDR-to-SDR tone mapping. Please make sure:
- In the menu bar under “Video” -> “Color Space,” try selecting different output configurations (e.g., sRGB).
- In the “Advanced” tab of Preferences, check “Use mpv’s HDR-to-SDR tone mapping” and try different tone mapping algorithms.
Q4: Keyboard shortcuts don’t work or conflict with other system apps.
Solution: Go to IINA’s “Preferences” -> “Key Bindings” panel to view all defined shortcuts. You can disable or modify any shortcut here. For conflicts with global shortcuts (such as media key controls), check under System “Settings” -> “Keyboard” -> “Keyboard Shortcuts.”
V. IINA for Mac Keyboard Shortcuts Summary
| Function Category | Action | Shortcut (Mac) |
|---|---|---|
| File & Window | Open File | Cmd + O |
| Open URL | Cmd + U |
|
| New Window | Cmd + N |
|
| Close Window | Cmd + W |
|
| Toggle Fullscreen | Cmd + F |
|
| Picture-in-Picture Mode | Option + Cmd + P |
|
| Playback Controls | Play/Pause | Space |
| Stop | . (period) |
|
| Rewind 5 seconds | ← |
|
| Fast forward 5 seconds | → |
|
| Rewind 60 seconds | Shift + ← |
|
| Fast forward 60 seconds | Shift + → |
|
| Previous track/file | Cmd + Option + ← |
|
| Media Controls | Next track/file | Cmd + Option + → |
| Increase volume | ↑ |
|
| Decrease volume | ↓ |
|
| Toggle mute | M |
|
| Subtitles & Audio Tracks | Cycle subtitles | V |
| Cycle audio tracks | A |
|
| Increase subtitle delay | Z |
|
| Decrease subtitle delay | X |
|
| Toggle subtitle visibility | S |
|
| Tools & View | Open/close info panel | Cmd + I |
| Screenshot | |







