https://github.com/oil3/qlcodec
QLCodec makes Quick Look play every video and audio formats not natively supported by macOS.
https://github.com/oil3/qlcodec
Last synced: 6 months ago
JSON representation
QLCodec makes Quick Look play every video and audio formats not natively supported by macOS.
- Host: GitHub
- URL: https://github.com/oil3/qlcodec
- Owner: Oil3
- Created: 2025-03-28T13:52:42.000Z (over 1 year ago)
- Default Branch: oil3
- Last Pushed: 2025-03-28T14:44:50.000Z (over 1 year ago)
- Last Synced: 2025-03-28T15:34:47.687Z (over 1 year ago)
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
QLCodec is a Quick Look Previewer Extension for macOS.
QLCodec
QLCodec makes “Quick Look“ play everything.
##
For every Apple computers: both Intel and M-series, running versions macOS 26 'Tahoe' down to macOS 11 'Big Sur'.
* Update in progress.14nov25
QLCodec brings playback support for most (if not all) non-native media formats, such as the well known `webm`, `mkv`, or `wmv`, to more niche formats such as `nuv`, `ivf` , or `nraw`, directly in Quick Look.
It's a _Quick Look preview extension_ not a pack of codecs _à la_ Perian like back in the days;
It requires nothing external, doesn't need internet, is hardened to the maximum and sandboxed, and has no extra entitlements.
Playback is instant on local network as well.
Persistent settings are accessible _via_ the right-click context menu within the Quick Look preview: might want to `right-click` then toggle `autoplay` to your liking.
## Install
>Optionally move to `/Applications`, then launch the app. This registers the extension as the extension itself stays within the app bundle.
>Iina users might need to disable Iina thumbnails preview generation in the settings of 'IIna'.
## Uninstall
>Delete the app.
## Update
>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 version 1.1 from [Releases ](https://github.com/Oil3/QLCodec/releases/tag/QLC-1.1-universalBinary) or [direct-download](https://github.com/Oil3/QLCodec/releases/download/QLC-1.1-universalBinary/QLCodec.1.1-.UniversalBinary.zip).
Full supported codecs and formats [markdown list](https://github.com/Oil3/QLCodec/blob/oil3/QLCodecSupportedFormats.md).
##
##
## Acknowledgment
[FFmpeg](http://ffmpeg.org) for their libraries licenced in [LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html). We use, or have used, code from FFmpeg in ths project, a project which wouldn't have been possible without them. QLCodec is forever grateful for FFmpeg's selfless commitment of sharing knowledge with everyone.
[VideoLan](https://www.videolan.org) for their libraries licenced in [LGPLv2.1](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html). We use, or have used, code from Videolan's VLCKit in ths project, a project which wouldn't have been possible without them. QLCodec is forever grateful for Videolan's selfless commitment of sharing knowledge with everyone.
[Perian](https://perian.org) for their Quicktime plug-in back-in-the-days. Perian was an open-source QuickTime component that enabled Apple Inc.'s QuickTime to play several popular video formats not supported natively by QuickTime (quote from Wikipedia).
Mac and macOS are trademarks of [Apple Inc.](http://www.apple.com/), registered in the U.S. and other countries and regions.
##
_A mac is a mac and it needs to stay comfortable, but it's still your mac._