https://github.com/oil3/mkv-quicklook
New 2025: free macOS plugin to play mkv movies in Quick Look Preview.
https://github.com/oil3/mkv-quicklook
macos matroska mkv qlvideeo quicklook quicklook-extension quicklook-plugin swift
Last synced: 6 months ago
JSON representation
New 2025: free macOS plugin to play mkv movies in Quick Look Preview.
- Host: GitHub
- URL: https://github.com/oil3/mkv-quicklook
- Owner: Oil3
- Created: 2025-02-28T15:43:27.000Z (8 months ago)
- Default Branch: oil3
- Last Pushed: 2025-03-29T11:34:30.000Z (7 months ago)
- Last Synced: 2025-04-10T03:17:10.425Z (6 months ago)
- Topics: macos, matroska, mkv, qlvideeo, quicklook, quicklook-extension, quicklook-plugin, swift
- Language: C
- Homepage:
- Size: 238 MB
- Stars: 13
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Mkv Quicklook
Free macOS plugin to play .mkv movies in Quick Look Preview, very fast.
## Update: If you have _iina_ and Mkv quicklook didn't work, it was a conflict of filetypes, it is fixed now.
##
Works on all macOSX versions on both Intel and Silicon architectures.
Instant playback and smooth scrolling `tested up to 3840 × 2160 with a 10-bit bit depth and a bitrate of 365.20 Mbit/s`.
* Passes [all mkv-testing-files](https://github.com/ietf-wg-cellar/matroska-test-files) and all [Jellyfish bitrate test files](https://repo.jellyfin.org/archive/jellyfish/).
## Install
>Launch the app once. This registers the extension as the extension itself stays within the app bundle.
>Requires nothing that is not included already, is sandboxed and hardened, and has no extra entitlements.
>iina users might need to disable Iina thumbnails preview generation in the settings of 'iina'.
## Uninstall
>Delete the app.
## Update
>This version has a new bundle identifier, might need to remove or desactivate from macOS' `Settings` the previous QL MKV
>Replace the older app with the newer app. MacOS looks for the extension in the app, if app is moved, macOS can get confused and still look for it in the previous location.
##
Download the new QLCodec-MKV from [Releases](https://github.com/Oil3/Mkv-Quicklook/releases/tag/QLCodec1.0-mkv) or direct-download [Universal binary](https://github.com/Oil3/Mkv-Quicklook/releases/download/QLCodec1.0-mkv/Quicklook.Codec.MKV.-iina.fixed.universal.binary.1.0.zip).
Or **try QLCodec** that quicklook-plays _all non-natively-supported formats_ such as .mkv .wmv .flv .webm .rm, ... even .nuv.
Instant playback even from network volumes, [Repository](https://github.com/Oil3/QLCodec)
##
[S720creen Recording 2025-02-28 at 1.04.15 PM copy 2.webm](https://github.com/user-attachments/assets/c27b8024-369a-4ec0-beff-14e2c4923ae7)
First test on first version, testing responsiveness when browsing/scrolling in mkv sample videos of high bitrates (20, 110mbps) in HD, and ultra high bitrate (250mbps) in 4K UHD.
##
## QLCodec Repository
an extension that quicklook-plays virtually all non-natively-supported formats such as wmv flv webm rm, ... even .ivf or .nuv. No network-volumes issues, instant playback from NAS as well [Repository](https://github.com/Oil3/QLCodec)
##
## Acknowledgment
[FFmpeg](http://ffmpeg.org) for their libraries licenced in [LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html).
[VideoLan](https://www.videolan.org/) for their libraries licenced in [LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html).
##
_A mac is a mac and it needs to stay comfortable, but it's still your mac._