Open-source project
QL-Win/QuickLook avatar
QL-Win/QuickLook

QuickLook for Windows: Space-Bar File Previews, Plugins and Install Path

Bring macOS “Quick Look” feature to Windows

25,024 stars1,330 forksC#GPL-3.0

At a glance

What is it?
QL-Win/QuickLook ports the macOS Quick Look gesture to Windows: select a file, press Space, see it. This review covers the plugin architecture, the GPL-3.0 licensing, and where the project's documentation runs thin.
Who is it for?
Adopt QuickLook if you spend your day in Explorer opening files just to glance at them, and you accept a GPL-3.0 desktop app that hooks the shell. Skip it on locked-down corporate machines where a background process and a shell hook are policy problems, or if you need previews for a format no plugin covers.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 6 days ago.
What is it written in?
Mainly C#, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 28, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The problem QuickLook solves on Windows

Windows Explorer has no preview gesture. To glance at a PDF, a PSD or a video, you double-click, wait for a full application to launch, look, and close it. macOS users press Space and get a floating preview window in under a second. QuickLook is an attempt to reproduce that interaction on Windows, and it is aimed at people who live in File Explorer: designers checking assets, developers skimming logs and configs, anyone who opens files mainly to decide whether they are the right ones.

The scope is broader than images. The README lists images (JPEG, PNG, GIF, WebP, RAW), video (MP4, AVI, MKV, MOV), Photoshop PSD and Illustrator AI, 3D models (OBJ, STL, FBX), PDF, Word, Excel, PowerPoint, Markdown with live rendering, e-books (EPUB, MOBI) and comics (CBZ, CBR). A separate SUPPORTED_FORMATS.md in the repository is the authoritative list, and it is the file to read before you assume your format is covered.

The project is a C# application under GPL-3.0, with a homepage at quicklookapp.vercel.app. It is not archived, and the last push to master was on 2026-09-14. That matters because the release cadence is slower than the commit cadence: 4.4.0 was tagged 2026-01-08, 4.5.0 on 2026-04-14, and the "latest" release entry in the repository dates to 2024-12-06.

How the QuickLook daemon and plugins fit together

QuickLook is not a single executable that knows every format. The repository layout shows the split: QuickLook/ holds the main application, QuickLook.Common/ holds shared code, QuickLook.Native/ holds native components, QuickLook.Plugin/ holds the plugin host, and QuickLook.Installer/ and QuickLook.Appx/ hold the two distribution paths. A plugin is therefore a separate assembly that the host loads, and the preview you see is produced by whichever plugin claims the file extension.

That explains the behaviour you should expect. The main process stays resident so that pressing Space does not pay a startup cost, and the README's own comparison table puts a preview at roughly 0.2 seconds against roughly 10 seconds for the double-click-and-wait route. Those figures are the project's illustration of the workflow, not an independent measurement, and they will not hold for a 4 GB video or a complex 3D model.

It also explains the failure modes. If a format shows nothing, the cause is usually a missing or broken plugin rather than the host, which is why the README points readers at an "Extend" section and why plugin installation is a recurring question. The plugin boundary is the project's main architectural decision, and it is a reasonable one: it keeps the core small and lets format support grow independently. The cost is that quality is uneven across formats, and the host cannot do much about a plugin that is slow or abandoned.

Installing QuickLook and previewing your first file

The README does not walk through installation in the sections shown here; it links to the official website and to the GitHub releases page, and the repository carries both an installer project and an Appx project. So the practical instruction is to get the build from the releases page or the homepage rather than to build from source. Once installed, the interaction is the whole point: click a file in Explorer, press Space, and a preview window appears; press Space again or Esc to dismiss it.

The README's badges point at the .NET runtime download page, which tells you the app expects a .NET runtime on the machine. If you prefer to build from source, the repository is a Visual Studio solution. Clone it and initialise the submodules, since the repository root contains a .gitmodules entry and a plain clone will leave parts of the tree empty.

bash
git clone https://github.com/QL-Win/QuickLook.git
cd QuickLook
git submodule update --init --recursive

After that, open QuickLook.slnx in Visual Studio. The .github/workflows/msbuild.yml file shows the project builds through MSBuild in CI, so a local build follows the same route.

For configuration, the repository root contains OPTIONS.md, which is where the project documents its settings. The README excerpt shown here does not list command-line flags or environment variables, so do not expect to script QuickLook from a terminal; this is a shell-integrated desktop tool, not a CLI.

Where QuickLook is the wrong tool

The first limitation is platform. This is a Windows application, and the README's platform badge says so. Anyone searching for the macOS feature of the same name is looking at something else entirely: macOS Quick Look is part of the operating system and has no relationship to this project. The same name collision applies to Insta360 QuickLook, which is a different product for 360-degree footage, and to the Quick Look gesture on iPhone.

The second limitation is the plugin model itself. Because format support lives in plugins, a preview that does not appear is a support problem you have to diagnose yourself. The README does not document a plugin troubleshooting procedure in the sections available, and it does not document rollback if a plugin or an update breaks a format you rely on. That is a real gap for anyone deploying this on a managed fleet.

The third is the shell hook and the resident process. A tool that watches Explorer and keeps a background process alive is exactly the kind of software that endpoint security and application-control policies flag. If your organisation restricts shell extensions or background processes, QuickLook is the wrong choice regardless of how well it previews a PSD. Finally, for very large files, the preview is only as fast as the plugin that renders them; the 0.2-second figure in the README is an illustration of the simple case.

How QuickLook compares with Windows Preview Pane and PowerToys

The built-in alternative is the Explorer Preview Pane, enabled from the View ribbon. It occupies part of the window rather than floating over it, it is limited to the handlers Windows and Office already register, and it gives you no 3D model, comic archive or Markdown rendering. QuickLook's difference is the interaction model: a transient overlay triggered by Space, closer to the macOS gesture, plus a plugin system that extends format coverage beyond what Windows ships.

PowerToys is the other comparison worth making, and the difference is scope rather than overlap. PowerToys is a suite of independent utilities from Microsoft; QuickLook is a single-purpose application with one behaviour and an extension mechanism. If you already run PowerToys for its other modules, adding QuickLook is not redundant, because PowerToys does not provide a Space-bar preview overlay. If you want one vendor for your Windows utilities, the built-in Preview Pane is the conservative pick, at the cost of format coverage and the floating-window feel.

Licence and the cost of keeping QuickLook current

QuickLook is GPL-3.0, and the repository carries LICENSE-GPL.txt to confirm it. For individual desktop use the practical effect is that you can run it freely. For anyone embedding it in a commercial product, the copyleft terms are the thing to read before you ship, and that is a question for your own legal review rather than something this article can settle. The README links the GPL-3.0 text directly.

Upgrade cost is tied to the release rhythm. The tagged releases in the repository are 4.4.0 on 2026-01-08 and 4.5.0 on 2026-04-14, while commits continued to land on master through 2026-09-14. In practice that means the released build can lag the repository, and a fix you see in the code may not be in the installer you downloaded. On Windows, updating a shell-integrated application usually means running the installer again and restarting Explorer, so plan for a brief interruption rather than a silent background update. The README does not document an automatic update mechanism in the sections available, and it does not describe a downgrade path, which is worth knowing before you upgrade a machine you depend on.

Editorial conclusion

Adopt QuickLook if you spend your day in Explorer opening files just to glance at them, and you accept a GPL-3.0 desktop app that hooks the shell. Skip it on locked-down corporate machines where a background process and a shell hook are policy problems, or if you need previews for a format no plugin covers. Before installing, read SUPPORTED_FORMATS.md to confirm your formats, and check OPTIONS.md for the settings the README does not describe. The latest tagged release is 4.5.0 from 2026-04-14, while the repository's last push was on 2026-09-14, so the code moves between releases.

Frequently asked questions

What is QuickLook on my computer?

It is a Windows application that reproduces the macOS Quick Look gesture: select a file in Explorer and press Space to see a preview without opening a full application. The README describes it as a Quick Look implementation for Windows, distributed from the project's releases page and homepage.

Is QuickLook free?

Yes. The project is licensed GPL-3.0 and the repository includes LICENSE-GPL.txt. That covers running the application at no cost; the copyleft terms matter if you plan to redistribute it or embed it in another product.

How to install QuickLook?

The README points to the official website and the GitHub releases page rather than giving step-by-step instructions, and the repository contains both an installer project and an Appx project. Download a build from one of those sources and run it; the README's badges also link the .NET runtime download page, which the app depends on.

how to use quicklook

Select a file in File Explorer and press Space to open the preview, then press Space again or Esc to close it. The README presents this as the entire interaction, in contrast to double-clicking and waiting for an application to launch.

how to install quicklook plugins

The README has an Extend section for plugins, and the repository separates the plugin host into QuickLook.Plugin/ from the main application. The excerpt available here does not give plugin installation steps, so treat the repository's plugin documentation as the place to check.

what is quicklook on windows

It is a Windows desktop application that shows an instant preview overlay for a selected file when you press Space, covering images, video, documents, 3D models, archives and more. The README frames it as bringing the macOS Quick Look experience to Windows.

Official sources

  1. License: GPL-3.0
  2. Project website
  3. QL-Win/QuickLook on GitHub
  4. README
  5. Releases
For maintainers

Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/ql-win-quicklook.svg)](https://hysenlabs.com/projects/ql-win-quicklook)
Community notes

Community notes