Repository navigation
Releases
QLCodePreview 2026.09.16
First public release.
QLCodePreview is a Quick Look extension for macOS that syntax-highlights
source code, config, and markup files right in Finder. Hit Space on a
file and it opens colourised, with line numbers and soft wrap if you
want them.
It covers dozens of languages and formats (the full extension-to-language
table is on the QLCodePreview webpage),
and the highlighter is self-contained and dependency-free: it runs entirely
inside the sandboxed Quick Look extension, with no external tools.
The bundled settings app controls font and size, light and dark themes,
line numbers, soft wrap, tab width, and a max file size, and can map any
file extension to a supported language (say, install files as PHP).
Settings apply to new previews immediately, no rebuild needed.
Install
- Download and unzip the
QLCodePreview-*.zipbelow. - Drag QLCodePreview.app to Applications and open it once.
- System Settings → General → Login Items & Extensions → Quick Look →
turn on QLCodePreview Extension. - Space-bar any source file in Finder.
or
- Install via homebrew
brew trust konstruukt-labs/tap
(one-time; current Homebrew requires it for third-party taps) brew install --cask konstruukt-labs/tap/qlcodepreview- Open QLCodePreview.app in Applications folder
- System Settings → General → Login Items & Extensions → Quick Look →
turn on QLCodePreview Extension. - Space-bar any source file in Finder.
Requires macOS 12.0 or later. This is a universal build (Apple Silicon
and Intel), signed with a Developer ID, notarized, and stapled; the
.sha256 file next to the zip is its checksum.
Support
QLCodePreview is donationware: free to use, and if it earns a place on
your Mac, buy me a coffee. The source
is available under MIT License; the official
binaries live on this Releases page only.
Built from qlcodepreview@160552a (main).