IINA

Bug Fixes

• Added comprehensive guard to prevent the use of the iina:// URL scheme to modify local files. This blocks the remaining discovered paths that allow command injection in certain situations. Please see the safety advisory for more information.

Please note that the in-app auto-update will be available in 24 hours after each GitHub release.

---

IINA 1.5.0 is on the way with a complete UI redesign. Please stay tuned.

IINA 1.4.3

Bug Fixes

• Fixed a security issue allowing command injection when opening a iina:// URL, #6083.
• Fixed system media play/pause keys toggling pause instead of strictly playing or pausing, by adopting mpv's PLAYONLY and PAUSEONLY keys, #6025.
• Fixed wrong fallback strings in localization in the inspector window.

The previous build didn't include updated dav1d libraries, leading to crashes when playing AV1 videos, particularly on YouTube.

This build resolved the issue. The 1.4.2 auto-update and website download will directly link to build 164.

sha256

804e3368518f19039ebfbc3d698e1fabc9cd20f15fc4e42de635456cdf6a7f58

IINA 1.4.2 fixes several critical bugs found in the previous release with some small additions.

New

• We have an official plugin list on our README page, check out https://github.com/iina/iina?tab=readme-ov-file#iina-plugins-list, #5882.
• Added gapless audio playback options, #5433.
• Added new options to control how to handle opening files with multiple player windows, #5865.
• The system media keys are now configurable, #5933.

Bug Fixes

• Fix some strings not translated in the main menu, #5713.
• Fix top OSC misalignment, #5715.
• Fix the button for increasing speed doesn't work, #5758.
• Fix low resolution of the osd-status-msg, #5782.
• Fix outline around screen in legacy full screen mode, #5783.
• Fix the next/prev buttons skip files, #5611.
• Fix wrong header color for macOS Tahoe, #5795.
• Fix wrong URL loading panel layout, #5718.
• Fix Now Playing not showing artwork for FLAC files, #5733.
• Fix side panel subtitle color controls not working, #5866.
• Fix force restart after opening .iinaplgz file, #5952.
• Fix sometimes excessive memory usage when opening large files, #5803.
• Fix the Tab key cannot be bound, #5905.
• Fix clicking on the current file doesn't restart, #5900.
• [API] Fix StatusAPI position is frozen when OSC is hidden, #5941.

Improvements

• Added new localization strings for unsupported video, #5883.
• Overhaul to the Font Picker window, #5863.
• The Settings page now resets to the top upon switching, #5845.
• Fix text clipping in German, #5919.

SHA256

2e0fd89fbba1c92a6c115171e5b51904883bb497fbe513a6961d080fbab08ff6

IINA 1.4.1 fixes several critical bugs found in the previous release.

Bug Fixes

• Fix window resize behavior #5665, #5669.
• Fix a frame drawn with wrong aspect ratio after entering/exiting full screen.
• Fix missing playlist context menu #5664.
• Fix delete current file shortcut doesn't work #5673.
• Fix manual stop doesn't close window #5666.
• Fix setting video aspect keybinding doesn't work #5678.
• Fix keycode translation when the key is #(Sharp) #5685.
• Fix somestimes window shown on wrong display #5676, #5680.
• Fix wrong behavior regarding opening large remote files #5700.
• Fix plugin link fails if plugin directory does not exist #5597.

Improvements

• Set neutral value and tint prominence for sliders in quick setting panels for macOS 26.
• Show loading window when opening a m3u file #5684.
• Remove the animation of the OSD progress bar
• Allow opening the same file in multiple windows #5689.
• Hide the "INFO" label in playlist by default.

The Plugin System is Now Available

IINA 1.4.0 introduces a plugin system that lets users extend IINA's functionality with JavaScript plugins. Learn more about the plugin system at http://iina.io/plugins/. IINA 1.4.0 ships with several built-in plugins, including:

• Online Media (iina/plugin-online-media): Enhances the experience of playing online media.
  • One-click yt-dlp update
  • On-the-fly video/audio quality selection
  • Video downloading
• OpenSubtitles (iina/plugin-opensub): Lets users search and download subtitles from OpenSubtitles with a user-friendly sidebar interface.
• User Scripts (iina/plugin-userscript): Allows users to add code snippets to customize IINA's behavior.

New

• The plugin system is enabled by default.
• Improved user interface for macOS Tahoe #5544.
• Added support for Hebrew #4867, Croatian #4966, and Indonesian locales.
• The playback history window now respects the system's reduce motion settings #4870.
• Added a new option to always show the OSC #4366.
• Added an option to disable embedded subtitles #501; overhauled subtitles menu #4235, #507.
• You can now double-click an input config name to rename it #4960.
• Added support for ReplayGain #4915.
• You can now use ESC to close the subtitle download OSD #4996.
• Added support for screenshots in WebP #3225 and JPEG-XL formats for HDR content #3852.
• Added support for mpv's 'screenshot window' command #4505.
• Added an option to select Core Audio or AVFoundation as the audio driver #5137. Spatial Audio is supported when using AVFoundation #3444. AVFoundation is experimental and may cause delays in some scenarios.
• Added support for adjusting secondary subtitles in the quick settings panel #5020.
• Added an option to enable the screensaver when playing audio #4954.
• Added settings to suppress certain OSD messages #4991.
• Added "Show Current File in Finder" under the File menu #5001.
• Added a new "scale" level to ASS subtitle override levels #5050.
• Separated ASS subtitle override level settings for primary and secondary subtitles #4433.
• Show OSD when loop status changes #5055.
• Added support for saving EQ presets #525.
• Added an option to enable repeat mode by default #2139.
• Allow dropping m3u playlist files into the Welcome window #5178.
• Support cover artwork in the "Now Playing" widget #5336.
• The Online Media plugin now has options to load subtitles and auto-generated subtitles.
• The Online Media plugin now supports raw yt-dlp options.
• Added DSD/DSF file association #5381.
• Added "folder" association for third-party app support #5488.
• Added drag-and-drop support for m3u and m3u8 playlists #5311.
• Added new settings to disable mouse scrolling #5451.
• Added new settings for showing buffering throbber #5580.
• Added new settings to limit the minimize-on-PIP feature to video mode only #5068.

Bug Fixes

• Fixed thumbnails sometimes displayed in the wrong aspect ratio #4736.
• Fixed memory leaks #4449.
• Fixed text clipping in the audio delay slider in certain languages #4951.
• Fixed the screenshot OSD not localized for some languages.
• Fixed incorrect buffering indicator behaviors #4064, #4470.
• The navigation keys now don't trigger menu actions when in input fields in the player window #3039, #3206.
• Fixed incorrect behaviors of automatically switching to music mode #4461.
• Fixed window position changes when using pinches to adjust window size #4681.
• Fixed UI elements not synced when changing modes #5039, #4985.
• Fixed "cycle-values" commands not showing values in readableCommand.
• Fixed the app icon in the welcome window not accepting drag and drop.
• Fixed color management #5213 and HDR-related issues #5124.
• Fixed a crash when quitting IINA #5056.
• Fixed IINA not starting if a previously connected file server cannot be reached #4973.
• Fixed broken color management #3929.
• Fixed HDR management consistency issue in PIP #5295.
• Fixed OSC does not appear in full screen mode #5288.
• Scroll wheel scrubbing not working in the top on-screen control configuration #3863
• Honor “open in new window” setting when opening multiple files at once #5071
• Speed display in the on-screen control not updating in some cases #4052
• The "always on top" indicator in the title bar displayed at the wrong position in RTL languages #5094
• Wrong title displayed in time and battery info section #5243
• Opening and closing side bar leaves video distorted #5245
• OGG file metadata not displayed in playlist before playing #5314
• The system "Now playing" widget not occupied by IINA when not playing #4331
• Playback position doesn't match the "Now playing" widget #5337
• Temporary files not deleted in the plugin directory #5394
• Subtitle download panel always use light text color #5378
• Externally loaded subtitles not automatically selected #5399
• Increasing Video Speed and holding down seek arrow keys leads to IINA freezing #5403
• save-position-on-quit in mpv.conf not working #5408
• IINA No Longer Remembers Screen to Launch On #5450
• Online Media plugin failed to download some video
• Hard Delete Current File action causes an error while streaming #5468
• The content in Log Window is right to left in Hebrew #4944
• Title bar blends with video in full-screen mode #5470
• Crash when playing a file after opening the About window #5319
• Crash when opening some mp3 files #5602
• On screen display (OSD) having floating point precision issues #5472
• UI Freeze on resize video window #5482
• IINA not auto adding files to the playlist when there's another video playing #5487
• Fix user experience issues when using legacy full screen #5612, #5609

Improvements

• Improved performance when rendering the video #5531
• Renamed "Preferences" to "Settings" across the app #4038
• Keyboard shortcuts for playlist and chapter panel now works in music mode #1751, #5412
• The playlist can be resized with a much larger maximum width #4887
• Chapter indicators in the progress bar are now more visible #5144
• The rewind button now rewinds to the beginning of the file when there is only one track #4611
• Remaining time adjusted with the playback speed #5580
• Show thumbnails for videos on a mounted drive #4480
• More mappings for click and scroll actions via preferences #5348
• Use title-style capitalization, shorten text in push buttons in Settings #5240
• Fixed some UI consistency issues #5244, #5587, #5233, #5567, #5590
• Inspector overhaul #4521, #4546, #5034.
• Handle BDMV folder correctly #1521.
• Improvements to the video filter presets window to prevent text truncation #1098.
• The music mode window can now be minimized #2382.
• The find online subtitle OSD is always displayed regardless of the OSD setting #4992.
• UI improvements to key bindings and advanced tabs #4129.
• Fix wobbling when the window is being resized during video playback #4667.
• Improvements to the subtitle chooser #4833.
• Remove the resize animation on opening media and switching music/video modes #5054.
• Disable the resizing animation when opening another video if the animation is disabled in settings #5033.
• Real-time OSD updates for pause, resume, and seek #4545.
• UI improvements to OSC toolbar settings #4165.
• Disable "Delete Current File" menu item when streaming #5011.
• UI and UX improvements when loading network resources #5152.
• Improvements to speed adjustment UI and OSD #5175.
• Added live update for color-related options in the codec preference panel #5204.
• Improved the performance when entering and exiting full screen mode #5352.

Updates

• IINA 1.4.0 will require macOS Catalina or later for x86 and macOS Monterey for ARM Macs #4837.
• Bumped mpv to 0.38.0 #4988.
  • Fixed subtitle shadow angle issue #4770.
  • Fixed m3u playlist items not opening due to special characters #4091.
  • Supported MPV crop attributes #4791.
• Updated FFmpeg to 7.0.1 #4988.
  • Fixed DXV3 format playback issue #4269.
• Bumped Sparkle from 2.4.0 to 2.6.3.
• Some default key bindings have changed to prevent conflicts #4786.
• Use more SF symbols #3058, #5125.
• Updated bundled yt-dlp.
• IINA 1.4.0 now requires macOS 10.15 Catalina for Intel Macs and macOS 12 Monterey for Apple Silicon Macs.

Deprecation Notice

IINA 1.4.0 now requires macOS 10.15 Catalina for Intel Macs and macOS 12 Monterey for Apple Silicon Macs.

The Plugin System

The plugin system is now enabled by default.

• The new Online Media plugin allows you to download online videos while playing them and switch between different video qualities on the fly.
• The new OpenSubtitles plugin provides a better experience for searching and downloading subtitles.
• The new User Scripts plugin allows you to tweak IINA's functionality with only a few lines of code.

Learn more about plugins and how to write your own at https://iina.io/plugins/.

New

• Added support for Hebrew #4867, Croatian #4966, and Indonesian locales.
• Playback history window now respects the system's reduce motion settings #4870.
• New option to always show the OSC #4366.
• Added an option to disable embedded subtitles #501; subtitles menu overhaul #4235, #507.
• You can now double-click on an input config name to rename it #4960.
• Added support for ReplayGain #4915.
• You can use ESC to close the subtitle download OSD #4996.
• Added support for screenshots in WebP #3225 and JPEG-XL format for HDR content #3852.
• Added support for mpv's 'screenshot window' command #4505.
• Added an option to select Core Audio or AVFoundation as the audio driver #5137. Spatial Audio is supported when using AVFoundation as the audio driver #3444. AVFoundation is an experimental audio driver, which could cause delays in certain scenarios.
• Added support for adjustment to secondary subtitles in the quick settings panel #5020.
• Added an option to enable the screensaver when playing audio #4954.
• Added settings to suppress certain OSD messages #4991.
• Added "Show Current File in Finder" menu item under the file menu #5001.
• Added a new "scale" level to ASS subtitle override levels #5050.
• Separated ASS subtitle override level settings for primary and secondary subtitles #4433.
• Show OSD when loop status changes #5055.
• Added support for saving EQ presets #525.
• Added an option to enable repeat mode by default #2139.

Bug Fixes

• Fixed thumbnails sometimes displayed in the wrong aspect ratio #4736.
• Fixed memory leaks #4449.
• Fixed text clipping in the audio delay slider in certain languages #4951.
• Fixed the screenshot OSD not localized for some languages.
• Fixed incorrect buffering indicator behaviors #4064, #4470.
• The navigation keys now don't trigger menu actions when in input fields in the player window #3039, #3206.
• Fixed incorrect behaviors of automatically switching to music mode #4461.
• Fixed window position changes when using pinches to adjust window size #4681.
• Fixed UI elements not synced when changing modes #5039, #4985.
• Fixed "cycle-values" commands not showing values in readableCommand.
• Fixed the app icon in the welcome window not accepting drag and drop.
• Fixed color management #5213 and HDR-related issues #5124.
• Fixed a crash when quitting IINA #5056.
• Fixed IINA not starting if a previously connected file server cannot be reached #4973.
• Fixed broken color management #3929.
• Fixed HDR management consistency issue in PIP #5295.
• Fixed OSC does not appear in full screen mode #5288.

Improvements

• Inspector overhaul #4521, #4546, #5034.
• Handle BDMV folder correctly #1521.
• Improvements to the video filter presets window to prevent text truncation #1098.
• The music mode window can now be minimized #2382.
• The find online subtitle OSD is always displayed regardless of the OSD setting #4992.
• UI improvements to key bindings and advanced tabs #4129.
• Fix wobbling when the window is being resized during video playback #4667.
• Improvements to the subtitle chooser #4833.
• Remove the resize animation on opening media and switching music/video modes #5054.
• Disable the resizing animation when opening another video if the animation is disabled in settings #5033.
• Real-time OSD updates for pause, resume, and seek #4545.
• UI improvements to OSC toolbar settings #4165.
• Disable "Delete Current File" menu item when streaming #5011.
• UI and UX improvements when loading network resources #5152.
• Improvements to speed adjustment UI and OSD #5175.
• Added live update forr color-related options in the codec preference panel #5204.
• Improved the performance when entering and exiting full screen mode #5352.

Updates

• IINA 1.4.0 will require macOS Catalina or later for x86 and macOS Monterey for ARM Macs #4837.
• Bumped mpv to 0.38.0 #4988.
  • Fixed subtitle shadow angle issue #4770.
  • Fixed m3u playlist item not opening due to special characters #4091.
  • Supported MPV crop attributes #4791.
• Updated FFmpeg to 7.0.1 #4988.
  • Fixed DXV3 format playback issue #4269.
• Bumped Sparkle from 2.4.0 to 2.6.3.
• Some default key bindings have changed to prevent conflicts #4786.
• Use more SF symbols #3058, #5125.

Deprecation Notice

IINA 1.4.0 now requires macOS 10.15 Catalina for Intel Macs and macOS 12 Monterey for Apple Silicon Macs.

SHA256

65a8b78468d17b6c60ee5fa284881dc799b1a6f62d32ed315a0933d43fed46a4

New

• Added a single file repeat feature #4242, #4350.
• When downloading subtitles, the FPS for each subtitle is shown #4763. The subtitle result window is now wider #4057.
• Added a "Load External Audio" menu item #4843.
• Added a key binding to bind the R key to sub-pos +1 in the default IINA config #4823. Also added key bindings for changing subtitle font size #4824.

Bug fixes

• Fixed the "seek exact" command sometimes not working correctly #3710.
• Fixed a crash when clicking on the chapter menu #4696.
• Fixed the play button state in the mini player not syncing #4743.
• Fixed advanced settings not being searchable #4512.
• Fixed the "Open Recent" menu being cleared when opening a non-release version of IINA #4688.
• Fixed the cursor disappearing after clicking in the main window #4748.
• Fixed the OSC not being clickable when moved to specific positions #4156. Also fixed OSC responses even when behind another view #4612.
• Fixed a regression where the "Include Subtitles" setting for screenshots was not respected #4582.
• Fixed iina-cli not working due to percent-encoding issues after macOS Sonoma #4861.
• Fixed IINA being unable to pause the video when the system goes to sleep #4917.
• Fixed the subtitle border size option not accepting decimal numbers #4799.

Improvements

• The open/save dialogs now block window input while open #4590.
• Tweaked the layout of the settings sidebar #4750.
• Improved the UX of the "Jump to..." command #4084.
• Avoided excessive playlist refreshes #4769.
• The audio track picker can now accept video files again #3259.
• Internationalized the subtitles override levels #4892.
• Made all volume icons indicate the current volume level #4885.

Deprecation Notice

IINA 1.3.5 now requires macOS 10.13 High Sierra. Due to the bumped system requirement of mpv, starting with the next major release, IINA will require macOS 10.15 Catalina.

Donations

IINA is developed and maintained by a dedicated team of volunteers who contribute their time to create the best media player for macOS. Your support plays a crucial role in helping us achieve this goal. If you find IINA valuable and would like to contribute to its ongoing development, please consider making a donation. We are now accepting donations from GitHub Sponsors, Ko-fi, and Liberapay. Every contribution, no matter the size, makes a significant difference. Thank you for your support!

New

• Added a new "Take Screenshot" button on the OSC https://github.com/iina/iina/pull/4648

Bug fixes

• Fixed multiple localization issues https://github.com/iina/iina/issues/4644 https://github.com/iina/iina/issues/4610 https://github.com/iina/iina/pull/4732, text clipping issue in France https://github.com/iina/iina/pull/4735
• Fixed duplicate plugin not detected when trying to install https://github.com/iina/iina/issues/4410
• Fixed more unexpected quits https://github.com/iina/iina/issues/4725
• Fixed sometimes black windows doesn't disappear https://github.com/iina/iina/issues/4683

Improvements

• Download from Open Subtitles using the new REST API https://github.com/iina/iina/issues/3920
• Improved the experience for Assrt https://github.com/iina/iina/issues/4671
• The menu entry "Music Mode" now becomes "Enter Music Mode"/"Exit Music Mode" depending on the current mode, localization will arrive in the next release https://github.com/iina/iina/issues/4463

Plugin related updates

Please note that the plugin system is still under development, and we aim to make it stable in the next release. To try out the new plugin system, please run defaults write com.colliderli.iina iinaEnablePluginSystem -bool YES in your Terminal. The documentation is available at https://docs.iina.io/.

• Add iina-plugin helper tool https://github.com/iina/iina/pull/4442
• Plugin: implement WebSocket API for macOS 10.15 or later https://github.com/iina/iina/pull/4586
• Plugin: add input module https://github.com/iina/iina/pull/4569

---

SHA256

7de50f5ad4a2fd5b27bf59a31b2060074c05331c7aafa533ad4adab65028d78c

New

• Added an option to start iina-cli in music mode #3651
• IINA is now associated with .gif files #3679

Bug fixes

• FFmpeg 6.0 has issues when hardware decoding VP9 format on Intel Macs. Therefore, you might experience this freezing when trying to play YouTube videos in IINA 1.3.2. We have temporarily disabled hardware decoding for VP9 on Intel Macs #4486
• Fixed missing localization strings that appears in v1.3.2 #4481
• Fixed a bug where audio delay cannot be set to negative values #4482
• Fixed an issue where stop command doesn't close the mini player #4398
• Fixed failure to write '#' to keybinding file #4271
• Fixed filter parameters appears randomly #4262

Improvements

• When loading subtitles, the open panel always starts in the video's directory #4382
• IINA can correctly handle TAB and ESC as keybindings #4465
• Pass folder to mpv directly to make mpv-shuffle working #4434
• Add a tick mark to A-B loop in the menu when A-B loop is enabled #4419

---

SHA256

4b3f6c4bed3bb77dbe29c12bf6d5d0959284afb01c7b59a35fd71a3a27088991