diff --git a/README.md b/README.md index b1d5df4a2..49c64b3a1 100644 --- a/README.md +++ b/README.md @@ -1,120 +1,899 @@ - + + + + + QuickLook Logo + # QuickLook - +
+ +

+ + Instant File Previews, Just Press Space + +

+ +**The most powerful Quick Look implementation for Windows** + + + Trending + + +
+ + +

+ + Release + + + Downloads + + + Stars + + + License + + + Build Status + + + Platform + +

+ + +

+ + +QuickLook Preview + +

+ + + + + + + + + + +
+ +
+ The Problem + + 		+ +
+ Superpowers + + 		+ +
+ Get Started + + 		+ +
+ Extend + + 		+ +
+ Community + +
+ +
+ +
+ +--- + +## ๐Ÿ’ก The Problem + + + + + + +
+ +### Ever wished Windows had macOS's Quick Look? + +You know the drill: you want to peek at a file, so you double-click, wait for an app to launch, view the file, close the app... **exhausting**, right? + +macOS users? They just press Space. Instant preview. **Any file**. + +**Now Windows has it too.** ๐ŸŽ‰ + +QuickLook brings that buttery-smooth, instant-preview experience to Windows. No more waiting. No more opening heavy applications just to peek at a document. + + + +``` +WITHOUT QuickLook: +โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” +โ”‚ 1. Double click โ”‚ +โ”‚ 2. Wait... โ”‚ +โ”‚ 3. App loads โ”‚ +โ”‚ 4. View file โ”‚ +โ”‚ 5. Close app โ”‚ +โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ + โฑ๏ธ ~10 seconds + +WITH QuickLook: +โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” +โ”‚ 1. Press SPACE โ”‚ +โ”‚ 2. Done! โœจ โ”‚ +โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ + โšก ~0.2 seconds +``` + +
+ +
+ +--- + +## ๐Ÿš€ Superpowers + +
+ +### What Makes QuickLook Extraordinary + +
+ + + + + + + +
+ +### โšก๏ธ **Lightning Speed** + + + +**Instant previews** with zero lag + +Native performance that feels like magic + +Hardware-accelerated rendering + + + +### ๐ŸŽจ **Gorgeous Design** + + + +**Fluent Design System** integration + +Beautiful on 4K displays + +Touch-optimized interface + + + +### ๐ŸŒˆ **100+ Formats** + + + +Images, videos, documents, code + +**3D models**, archives, fonts + +Extensible with plugins + +
+ +
+ + + + + + + +
+ +#### ๐Ÿ“ธ **Visual Files** +- ๐Ÿ–ผ๏ธ Images (JPEG, PNG, GIF, WebP, RAW) +- ๐ŸŽฌ Videos (MP4, AVI, MKV, MOV) +- ๐ŸŽจ Photoshop (PSD), Illustrator (AI) +- ๐Ÿ“ 3D Models (OBJ, STL, FBX) +- ๐ŸŽญ Animated GIFs & APNGs + +#### ๐Ÿ“„ **Documents** +- ๐Ÿ“ PDF, Word, Excel, PowerPoint +- ๐Ÿ“‹ Text files with syntax highlighting +- ๐Ÿ“Š Markdown with live rendering +- ๐Ÿ“œ E-books (EPUB, MOBI) +- ๐Ÿ“‘ Comics (CBZ, CBR) + + + +#### ๐Ÿ’ป **Developer Files** +- ๐Ÿ Python, JavaScript, C++, Rust +- ๐ŸŒ HTML, CSS, JSON, XML +- โš™๏ธ Config files (YAML, TOML, INI) +- ๐Ÿ“ฆ Archives (ZIP, RAR, 7Z, TAR) +- ๐Ÿ”ง Binary files with hex view + +#### ๐ŸŽต **Media** +- ๐ŸŽต Audio (MP3, FLAC, WAV, AAC) +- ๐ŸŽผ Sheet music +- ๐ŸŽจ Fonts (TTF, OTF, WOFF) +- ๐Ÿ–Œ๏ธ Vector graphics (SVG, EPS) +- ๐Ÿ“น Subtitles (SRT, ASS) + +
+ +
+ +
+ +### ๐ŸŽฏ **Works Everywhere** + + + + + + + + +
+ +**File Explorer** + + + +Native integration + + + +**Open/Save Dialogs** + + + +System-wide support + + + +**3rd Party Managers** + + + +Total Commander, xplorerยฒ + + + +**Cloud Storage** + + + +OneDrive, Dropbox ready + +
+ +
+ +
+ +--- + +## ๐Ÿ“ฆ Get Started + +
+ +### Choose Your Adventure + +
+ + + + + + + + +
+ + + +### **Microsoft Store** + +**Recommended for most users** + +โœ… Automatic updates +โœ… Sandboxed security +โœ… One-click install + +
+ + + Microsoft Store + + +โš ๏ธ Limited Open/Save dialog support + +		 + + + +### **Installer** + +**Full-featured experience** + +โœ… Complete functionality +โœ… Open/Save dialog support +โœ… Portable option available + +
+ + + Latest Release + + +๐Ÿ’Ž Get the full power + +		 + + + +### **Scoop** + +**For command-line lovers** + +โœ… Easy updates +โœ… Reproducible installs +โœ… Version management + +
+ +```powershell +scoop bucket add extras +scoop install quicklook +``` + +๐Ÿค“ Power user choice + +		 + + + +### **Nightly** + +**Live on the edge** + +โœ… Latest features +โœ… Bug fixes first +โš ๏ธ May be unstable + +
+ + + Nightly Builds + + +๐ŸŒ™ Experimental builds + +
+ +
+ +
+๐Ÿค” Not sure which version to choose? + +
+ +| Feature | Store | Installer | Scoop | Nightly | +|---------|-------|-----------|-------|---------| +| Auto-updates | โœ… | โš ๏ธ | โœ… | โš ๏ธ | +| Open/Save dialogs | โŒ | โœ… | โœ… | โœ… | +| Portable mode | โŒ | โœ… | โŒ | โœ… | +| Stability | โœ…โœ…โœ… | โœ…โœ…โœ… | โœ…โœ…โœ… | โœ…โœ… | + +๐Ÿ“– [Read the full comparison](https://github.com/QL-Win/QuickLook/wiki/Differences-Between-Distributions) + +
+ +
+ +
+ +### โšก Quick Start in 10 Seconds + + + + + + +
+ +``` +Step 1๏ธโƒฃ Install QuickLook + โ†“ +Step 2๏ธโƒฃ It runs automatically + โ†“ +Step 3๏ธโƒฃ Select any file + โ†“ +Step 4๏ธโƒฃ Press SPACE + โ†“ +Step 5๏ธโƒฃ ๐ŸŽ‰ Magic happens! +``` + + + +**๐Ÿ’ก Pro Tips:** +- QuickLook lives in your system tray +- Works with **any file** in File Explorer +- Use arrow keys to preview multiple files +- Press `Esc` or `Space` again to close +- Drag files directly from the preview! + +
+ +
+ +--- + +## โŒจ๏ธ Master the Shortcuts + +
+ +### Your New Superpowers + +
+ + + + + + + +
+ +### ๐ŸŽฎ **Basic Controls** + +| Key | Action | +|-----|--------| +| Space | Toggle preview | +| Esc Space | Close window | +| Enter | Open file | +| โ†‘ โ†“ | Next/Previous | + + + +### ๐Ÿ” **Navigation** + +| Key | Action | +|-----|--------| +| โ† โ†’ | Navigate files | +| Mouse Click | Select file | +| Page Up Down | Scroll content | +| Home End | Jump to start/end | + + + +### ๐ŸŽจ **Advanced** + +| Key | Action | +|-----|--------| +| Wheel | Zoom (images) | +| Ctrl+Wheel | Zoom (PDFs) | +| L-Click Drag | Rotate 3D | +| M-Click Drag | Pan 3D | + +
+ +
+ +> **๐Ÿ’ก Pro Tip:** You can navigate files using arrow keys even when the preview window isn't focused! + +
+ +
+ +--- + +## ๐Ÿงฉ Extend + +
+ +### Supercharge QuickLook with Plugins + +*Transform QuickLook into a universal file viewer* + +
+ + + + + + + + + + + +
+ + + +### **OfficeViewer** + +Preview **Word, Excel & PowerPoint** files + +**No Microsoft Office required!** + +
+ +``` +โœ… Native Office formats +โœ… Standalone viewer +โœ… Fast rendering +``` + + + Download + + +		 + + + +### **PdfViewer-Native** + +Enhanced PDF viewing with **WebView2** + +Modern, fast, feature-rich + +
+ +``` +โœ… Smooth scrolling +โœ… Search & annotations +โœ… Hardware acceleration +``` + + + Download + + +
+ + + +### **PostScriptViewer** + +Preview `.ps` and `.eps` files + +Perfect for designers + +
+ +``` +โœ… Vector rendering +โœ… High quality output +โœ… Professional formats +``` + + + Download + + +		 + + + +### **CADImport** + +View CAD files natively + +`.dwg`, `.dxf`, `.plt`, `.cgm` + +
+ +``` +โœ… Engineering drawings +โœ… Architecture files +โœ… Technical diagrams +``` + + + Download + + +
+ +
+ +### ๐Ÿ“ฆ How to Install or Upgrade Plugins + + + + + + + +
+ +**1๏ธโƒฃ Download** + +Get the `.qlplugin` file + + + +**2๏ธโƒฃ Install** + +Ensure QuickLook is currently running, select the file and press `Spacebar`. + + + +**3๏ธโƒฃ Restart** + +Click on the `Install` button, then restart QuickLook. + +
+ +### ๐Ÿ“ฆ How to Remove Plugins + + + + + + + +
+ +**1๏ธโƒฃ Quit** + +Quit QuickLook. + + + +**2๏ธโƒฃ Navigate** + +Navigate to the [Data location](https://github.com/QL-Win/QuickLook/wiki/Differences-Between-Distributions#user-data-location). + + + +**3๏ธโƒฃ Remove** + +You should find several folders. Remove the one you do not want to use. + +
+ +
+ + + Browse Plugins + + + Installation Guide + + +
+ +
+ +--- + +## ๐Ÿ’– Community + +
+ +### Join Thousands of Happy Users + +
+ + + + + + + +
+ + + +### **QQ Group** + +Join our Chinese community + +**371388501** + +
+ + + QQ Group + + +		 + + + +### **Translate** + +Help QuickLook speak your language + +Make it accessible + +
+ + + Translations + + +		 + + + +### **Star Us** + +Show your support + +It means a lot! + +
+ + + Star us + + +
+ +
+ +### ๐Ÿ‘จโ€๐Ÿ’ป For Developers + +Interested in contributing? Check out our development resources: + + + Wiki + + + Code Style + + + Issues + + +
+ +
+ +--- + +## ๐Ÿ™ Credits + +
+ +### Built with Love by Amazing People + +
+ + + + + + + + +
+ + + +**Design Team** + +[@OiCkilL](https://twitter.com/OiCkilL) +[@QubitsDev](https://twitter.com/qubitsdev) +[Donno](https://github.com/Donnnno) + +*Fluent UI & Icons* + + + + + +**Contributors** -[![license](https://img.shields.io/github/license/QL-Win/QuickLook.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html) -[![Actions](https://github.com/QL-Win/QuickLook/actions/workflows/msbuild.yml/badge.svg)](https://github.com/QL-Win/QuickLook/actions/workflows/msbuild.yml) -[![Platform](https://img.shields.io/badge/platform-Windows-blue?logo=windowsxp&color=1E9BFA)](https://dotnet.microsoft.com/en-us/download/dotnet/latest/runtime) -[![Github All Releases](https://img.shields.io/github/downloads/QL-Win/QuickLook/total.svg)](https://github.com/QL-Win/QuickLook/releases) -[![GitHub release](https://img.shields.io/github/release/QL-Win/QuickLook.svg)](https://github.com/QL-Win/QuickLook/releases/latest) +[Our Amazing Team](https://github.com/QL-Win/QuickLook/graphs/contributors) - +*Code, translations & ideas* -## Background -One of the few features I missed from macOS is [Quick Look](https://en.wikipedia.org/wiki/Quick_Look). It allows users to peek into a file content in lightning speed by just pressing the Space key. Windows, on the other hand, does not have this handy feature ... until now! + -I am aware that several alternatives are already available on the Internet but I still decided to craft another one by myself, because they are either not being actively developed, lack of variety. + -## Highlights +**Open Source** - - Tons of supported file types (full list [here](https://github.com/QL-Win/QuickLook/wiki/Supported-File-Types)) - - Fluent design - - Touchscreen friendly - - HiDPI support - - Preview from *Open* and *Save File* Dialog - - Preview from 3rd-party file managers (see a list [here](https://github.com/QL-Win/QuickLook/wiki/File-Managers)) - - Easily extended by [plugins](https://github.com/QL-Win/QuickLook/wiki/Available-Plugins) - - Strict GPL license to keep it free forever +[Libraries We Use](https://github.com/QL-Win/QuickLook/wiki/On-the-Shoulders-of-Giants) -## Usage +*Standing on giants* -### Download/Installation + -Get it from one of the following sources: + - * Microsoft Store (Windows 10 and later only). Not supported on Windows 10 S. Not support file preview in Open-File or Save-File dialogs. Store Link - * Installer or portable archive of the stable version from [GitHub Release](https://github.com/QL-Win/QuickLook/releases) - * Using [Scoop](https://scoop.sh/): `scoop bucket add extras && scoop install extras/quicklook` - * Nightly builds from [GitHub Action](https://github.com/QL-Win/QuickLook/releases/) +**You!** -[What are the differences between `.msi`, `.zip`, Nightly and Store versions?](https://github.com/QL-Win/QuickLook/wiki/Differences-Between-Distributions) +Every User Matters -**Note:** Don't forget to check out the [plugins](https://github.com/QL-Win/QuickLook?tab=readme-ov-file#plugins) for previewing office-files, epubs, fonts and more! +*Thank you for using QuickLook* +
-### Typical usecase +
-1. Run `QuickLook.exe` (only necessary if autostart is disabled) -1. Select any file or folder (on the Desktop, in a File Explorer window, in an *Open* or *Save-File* dialogue, doesn't matter) -1. Press Spacebar -1. Enjoy the preview and interact with it -1. Preview next file by clicking on it or using arrow-keys (arrow-keys move selection in the background if the preview window is not in focus) -1. When you're done close it by either hitting Spacebar again, pressing Esc or clicking the `โจ‰` button +
-### Hotkeys and buttons +--- - - Spacebar Show/Hide the preview window - - Esc Hide the preview window - - Enter Open/Execute current file - - Mouse โ†‘ โ†“ โ† โ†’ Preview another file - - Mouse Wheel Zoom in/out (images) - - Ctrl+Mouse Wheel Zoom in/out (PDFs) - - Wheel Increase/decrease volume - - Left Mouse Rotate (3D models) - - Middle Mouse Pan (3D models) +## ๐Ÿ“œ License -## Plugins +
-### Official Plugins +
-| Name | Description | URL | -| ------------------------------------------------------------ | ---------------------------------------------------------- | ------------------------------------------------------------ | -| [OfficeViewer](https://github.com/QL-Win/QuickLook.Plugin.OfficeViewer) | View Office formats **without installing MS Office**. | [Link](https://github.com/QL-Win/QuickLook.Plugin.OfficeViewer/releases) | -| [PdfViewer-Native](https://github.com/QL-Win/QuickLook.Plugin.PdfViewer-Native) | View the PDF files with WebView2. | [Link](https://github.com/QL-Win/QuickLook.Plugin.PdfViewer-Native/releases) | -| [PostScriptViewer](https://github.com/QL-Win/QuickLook.Plugin.PostScriptViewer) | Preview PostScript `.ps` and `.eps` files. | [Link](https://github.com/QL-Win/QuickLook.Plugin.PostScriptViewer/releases) | -| [CADImport](https://github.com/emako/QuickLook.Plugin.CADImport) | Preview CAD file formats (`.dwg`, `.dxf`, `.plt`, `.cgm`). | [Link](https://github.com/emako/QuickLook.Plugin.CADImport/releases) | +GPL v3 -Here is the complete list of plugins from [Available-Plugins](https://github.com/QL-Win/QuickLook/wiki/Available-Plugins). +

-See [here](https://github.com/QL-Win/QuickLook/wiki/Available-Plugins#how-to-install-or-upgrade-a-plugin) for instructions on how to install plugins. +**QuickLook is free and open source under [GPL-3.0](https://opensource.org/licenses/GPL-3.0)** -## Supported file formats +*Free software, free forever. No ads, no tracking, no premium tiers.* -See the [Supported formats](SUPPORTED_FORMATS.md) +
-## Supported file manager integration, etc. +**Need commercial licensing?** Contact us for sublicensing options. -See the [Wiki page](https://github.com/QL-Win/QuickLook/wiki) +
-## Translations +
-See the [Translation guide](https://github.com/QL-Win/QuickLook/wiki/Translations) +--- -## Community +
-QQ Group: [371388501](https://qm.qq.com/q/KIczirznua) +
-## Developer +## โญ Like QuickLook? Star the repo! -- **Formatter**: [CodeMaid.config](CodeMaid.config), [Settings.XamlStyler](Settings.XamlStyler) +**Your support keeps this project alive and improving** -## Thanks to +
- - Many [open-source projects](https://github.com/QL-Win/QuickLook/wiki/On-the-Shoulders-of-Giants) and their contributors - - Our UI designers [@OiCkilL](https://twitter.com/OiCkilL) (โ€œFluentโ€ user interface since v0.3), [@QubitsDev](https://twitter.com/qubitsdev) (app-icon v0.3-v3.6.9) and [Donno](https://github.com/Donnnno) (app-icon since v3.6.10) - - [Our contributers](https://github.com/QL-Win/QuickLook/graphs/contributors) who - - teach QuickLook to speak *your* language - - send pull requests, report bugs or give suggestions - - ... and you ๐Ÿ˜Š + + Homepage + + + Docs + + + Help + + + Download + -## Licenses +

-![GPL-v3](https://www.gnu.org/graphics/gplv3-127x51.png) +Made with โค๏ธ by the QuickLook community -This project references many other open-source projects. See [here](https://github.com/QL-Win/QuickLook/wiki/On-the-Shoulders-of-Giants) for the full list. +
-All source codes are licensed under [GPL-3.0](https://opensource.org/licenses/GPL-3.0). + + + + + -If you want to make any modification on these source codes while keeping new codes not protected by GPL-3.0, please contact me for a sublicense instead. +
\ No newline at end of file diff --git a/SUPPORTED_FORMATS.md b/SUPPORTED_FORMATS.md index 5e99e512b..e97966bd1 100644 --- a/SUPPORTED_FORMATS.md +++ b/SUPPORTED_FORMATS.md @@ -1,315 +1,707 @@ -## Supported formats in QuickLook - -Update not completed yet... - -### Text files -- `.txt` (Plain text file) -- `.rtf` (Rich Text Format) -- `.log` (Log file) -- `.ini` (Initialization/config file) -- `.json` (JavaScript Object Notation) -- `.xml` (Extensible Markup Language) -- `.yaml`, `.yml` (YAML Ain't Markup Language) -- `.md`, `.markdown`, `.mdx`, `.mmd`, `.mkd`, `.mdwn`, `.mdown`, `.mdc`, `.qmd`, `.rmd`, `.rmarkdown`, `.apib`, `.mdtxt`, `.mdtext` (Markdown and variants) -- `.csv` (Comma-separated values) -- `.tsv` (Tab-separated values) -- `.bat`, `.cmd` (Batch script) -- `.ps1` (PowerShell script) -- `.sh` (Shell script) -- `.c`, `.cpp`, `.h`, `.hpp` (C/C++ source/header) -- `.cs` (C# source) -- `.java` (Java source) -- `.py` (Python source) -- `.js` (JavaScript source) -- `.ts`, `.tsx`, `.uts` (TypeScript source) -- `.go` (Go source) -- `.php` (PHP source) -- `.rb` (Ruby source) -- `.swift` (Swift source) -- `.scala` (Scala source) -- `.kotlin` (Kotlin source) -- `.lua` (Lua source) -- `.sql` (SQL script) -- `.css` (Cascading Style Sheets) -- `.html`, `.htm` (HTML file) -- `.xshd` (Highlighting definition) -- `.properties` (Java properties/config) -- `.diff`, `.patch` (Diff/Patch file) -- `.sub`, `.srt` (Subtitle file) -- `.conf`, `.config` (Configuration file) -- `.env` (Environment config) -- `.makefile`, `.mk` (Makefile) -- `.gitignore`, `.gitattributes` (Git config) -- `.registry` (Windows registry file) -- `.resource` (Resource file) -- `.hosts` (Hosts file) -- `.boo` (Boo script) -- `.ada` (Ada source) -- `.antlr` (ANTLR grammar) -- `.assembly` (Assembly source) -- `.autohotkey` (AutoHotkey script) -- `.ceylon` (Ceylon source) -- `.chuck` (ChucK script) -- `.clojure` (Clojure source) -- `.cmake` (CMake config) -- `.cocoa` (Cocoa source) -- `.coffeescript` (CoffeeScript source) -- `.cool` (Cool source) -- `.d` (D source) -- `.dart` (Dart source) -- `.delphi` (Delphi source) -- `.eiffel` (Eiffel source) -- `.elixir` (Elixir source) -- `.env` (Environment config) -- `.erlang` (Erlang source) -- `.fsharp` (F# source) -- `.falcon` (Falcon script) -- `.fantom` (Fantom source) -- `.fortran` (Fortran source) -- `.gitattributes` (Git attributes) -- `.gitignore` (Git ignore) -- `.goovy` (Goovy source) -- `.gui4cli` (Gui4Cli script) -- `.haskell` (Haskell source) -- `.haxe` (Haxe source) -- `.hlsl` (HLSL shader) -- `.hosts` (Hosts file) -- `.icon` (Icon source) -- `.ilyc` (ILYC source) -- `.ini` (INI config) -- `.io` (Io source) -- `.java` (Java source) -- `.justbasic` (Just BASIC source) -- `.kixtart` (KiXtart script) -- `.kotlin` (Kotlin source) -- `.lean` (Lean source) -- `.lisp` (Lisp source) -- `.log` (Log file) -- `.lua` (Lua source) -- `.lyric` (Lyric file) -- `.makefile`, `.mk` (Makefile) -- `.nemerle` (Nemerle source) -- `.nim` (Nim source) -- `.nsis` (NSIS script) -- `.objective-c` (Objective-C source) -- `.ocaml` (OCaml source) -- `.parasail` (ParaSail source) -- `.pascal` (Pascal source) -- `.php` (PHP source) -- `.pike` (Pike source) -- `.prolog` (Prolog source) -- `.protobuf` (Protocol Buffers) -- `.purescript` (PureScript source) -- `.qml` (QML source) -- `.r` (R script) -- `.restructuredtext` (reStructuredText) -- `.rexx` (Rexx script) -- `.ruby` (Ruby source) -- `.rust` (Rust source) -- `.scala` (Scala source) -- `.scheme` (Scheme source) -- `.shellscript`, `.sh` (Shell script) -- `.solidity` (Solidity source) -- `.spike` (Spike source) -- `.sqf` (SQF script) -- `.subripsubtitle`, `.sub`, `.srt` (SubRip Subtitle) -- `.swift` (Swift source) -- `.tcl` (TCL script) -- `.thrift` (Thrift source) -- `.vala` (Vala source) -- `.vbnet` (VB.NET source) -- `.vbscript` (VBScript) -- `.verilog` (Verilog source) -- `.vhdl` (VHDL source) -- `.visualsolution` (VisualSolution source) -- `.volt` (Volt source) -- `.vue` (Vue component) -- `.x10` (X10 source) -- `.xc` (XC source) -- `.xml` (Extensible Markup Language) -- `.xtend` (Xtend source) - -- Most other plain text and script formats - -### Image files -- `.apng` (Animated PNG) -- `.ari`, `.arw` (Sony RAW image) -- `.avif` (AV1 Image File Format) -- `.ani` (Animated cursor) -- `.bay` (Casio RAW image) -- `.bmp` (Bitmap image) -- `.cap` (Phase One RAW image) -- `.cr2`, `.cr3`, `.crw` (Canon RAW image) -- `.cur` (Windows cursor) -- `.dcr`, `.dcs`, `.drf` (Kodak RAW image) -- `.dds` (DirectDraw Surface) -- `.dng` (Digital Negative RAW) -- `.eip` (Capture One Enhanced Image Package) -- `.emf` (Enhanced Metafile) -- `.erf` (Epson RAW image) -- `.exr` (OpenEXR image) -- `.fff` (Imacon/Hasselblad RAW) -- `.gif` (Graphics Interchange Format) -- `.hdr` (High Dynamic Range image) -- `.heic`, `.heif` (High Efficiency Image Format) -- `.ico`, `.icon` (Windows icon) -- `.icns` (macOS icon) -- `.iiq` (Phase One RAW image) -- `.jfif` (JPEG File Interchange Format) -- `.jp2`, `.j2k`, `.jpf`, `.jpx`, `.jpm` (JPEG 2000) -- `.jpeg`, `.jpg` (JPEG image) -- `.jxl` (JPEG XL) -- `.jxr` (JPEG XR) -- `.k25`, `.kdc` (Kodak RAW image) -- `.lottie` (Lottie animation) -- `.mdc` (MagicDraw UML) -- `.mef` (Mamiya RAW image) -- `.mos` (Leaf RAW image) -- `.mrw` (Minolta RAW image) -- `.mj2` (Motion JPEG 2000) -- `.miff` (Magick Image File Format) -- `.nef`, `.nrw` (Nikon RAW image) -- `.obm` (Open BIM) -- `.orf` (Olympus RAW image) -- `.pbm`, `.pgm`, `.pnm`, `.ppm` (Portable bitmap/graymap/pixmap) -- `.pcx` (Paintbrush image) -- `.pef` (Pentax RAW image) -- `.png` (Portable Network Graphics) -- `.psb`, `.psd` (Adobe Photoshop) -- `.ptx` (Pentax RAW image) -- `.pxn` (PixelNet image) -- `.qoi` (Quite OK Image) -- `.r3d` (REDCODE RAW) -- `.raf` (Fujifilm RAW image) -- `.raw` (Generic RAW image) -- `.rw2`, `.rwl`, `.rwz` (Panasonic/Leica RAW image) -- `.sr2`, `.srf`, `.srw` (Sony RAW image) -- `.svg`, `.svgz` (Scalable Vector Graphics) -- `.svga` (SVGA animation) -- `.tga` (Truevision TGA) -- `.tgs` (Telegram sticker, Lottie animation) -- `.tif`, `.tiff` (Tagged Image File Format) -- `.wdp` (Windows Media Photo) -- `.webp` (WebP image) -- `.wmf` (Windows Metafile) -- `.x3f` (Sigma RAW image) -- `.xcf` (GIMP image) -- `.xbm`, `.xpm` (X11 bitmap/pixmap) - -### PDF files -- `.pdf` (Portable Document Format) - -### Archive files -- `.7z` (7-Zip archive) -- `.bz2` (Bzip2 archive) -- `.cb7`, `.cbr`, `.cbt`, `.cbz` (Comic book archive) -- `.crx` (Chrome extension) -- `.gz` (Gzip archive) -- `.jar` (Java archive) -- `.lz` (Lzip archive) -- `.nupkg`, `.snupkg` (NuGet package) -- `.rar` (RAR archive) -- `.tar`, `.tgz` (TAR archive) -- `.vsix` (Visual Studio extension) -- `.xz` (XZ archive) -- `.zip` (ZIP archive) -- `.cfb` (Compound File Binary) -- `.eif` (QQ EIF package with Compound File Binary format) - -### Markdown files -- `.md`, `.markdown` (Markdown) -- `.mdx` (MDX: Markdown + JSX) -- `.mmd` (MultiMarkdown) -- `.mkd`, `.mdwn`, `.mdown` (Markdown variants) -- `.mdc` (Cursor AI Markdown) -- `.qmd` (Quarto Markdown) -- `.rmd`, `.rmarkdown` (R Markdown) -- `.apib` (API Blueprint) -- `.mdtxt`, `.mdtext` (Other Markdown variants) - -### CSV/TSV files -- `.csv` (Comma-separated values) -- `.tsv` (Tab-separated values) - -### Font files -- `.ttf` (TrueType Font) -- `.otf` (OpenType Font) -- `.woff`, `.woff2` (Web Open Font Format) -- `.ttc` (TrueType Collection) - -### Office files -- `.doc`, `.docx`, `.docm` (Microsoft Word) -- `.odt` (OpenDocument Text) -- `.xls`, `.xlsx`, `.xlsm`, `.xlsb` (Microsoft Excel) -- `.ods` (OpenDocument Spreadsheet) -- `.ppt`, `.pptx`, `.odp` (Microsoft PowerPoint / OpenDocument Presentation) -- `.vsd`, `.vsdx` (Microsoft Visio) - -### Video/Audio files -- Most common video formats (e.g., `.mp4`, `.mkv`, `.avi`, `.mov`, `.wmv`, `.flv`, `.webm`, etc.) -- Most common audio formats (e.g., `.mp3`, `.flac`, `.wav`, `.aac`, `.ogg`, `.m4a`, etc.) - -### HTML/Web files -- `.mht`, `.mhtml` (MHTML web archive) -- `.htm`, `.html` (HTML file) -- `.url` (Internet shortcut, http/https) - -### Mail files -- `.eml` (Email message) -- `.msg` (Outlook message) - -### Thumbnail/Design files -- `.cdr` (CorelDRAW project file) -- `.fig` (Figma project file) -- `.kra` (Krita project file) -- `.pdn` (Paint.NET project file) -- `.pip`, `.pix` (Pixso project file) -- `.sketch` (Sketch project file) -- `.xd` (Adobe XD project file) -- `.xmind` (XMind mind map file) - -### ELF/Mach-O/UImage files -- `.axf` (ARM Executable) -- `.bin` (Binary file) -- `.elf` (Executable and Linkable Format) -- `.o`, `.out` (Object file) -- `.prx` (PSP executable) -- `.puff` (Puff executable) -- `.ko`, `.mod` (Linux kernel module) -- `.so` (Shared object) -- `.uimage` (U-Boot image) -- `.dylib` (macOS dynamic library) - -### PE (Portable Executable) files -- `.exe` (Windows executable) -- `.sys` (Windows system file) -- `.scr` (Windows screensaver) -- `.ocx` (ActiveX control) -- `.cpl` (Control panel item) -- `.bpl` (Borland package library) -- `.dll` (Dynamic-link library) -- `.ax` (DirectShow filter) -- `.drv` (Driver file) -- `.vxd` (Virtual device driver) -- `.mui` (Multilingual User Interface) -- `.mun` (Windows resource file) -- `.tlb` (Type library) -- `.efi` (Extensible Firmware Interface) -- `.mz` (DOS executable) - -### App Installer files -- `.apk` (Android Package) -- `.aab` (Android App Bundle) -- `.appx`, `.appxbundle` (Windows AppX installer) -- `.msi` (Windows Installer) -- `.msix`, `.msixbundle` (Windows MSIX installer) -- `.dmg` (macOS Disk Image) -- `.ipa` (iOS App Package) -- `.hap` (HarmonyOS App Package) -- `.ddeb`, `.deb` (Debian package) -- `.appimage` (Linux AppImage) -- `.rpm` (Red Hat Package Manager) -- `.wgt`, `.wgtu` (UniApp Widget) - -### Plugin Installer files -- `.qlplugin` (QuickLook plugin package) +
+ + + +# Supported File Formats + +### ๐ŸŽฏ QuickLook supports 500+ file formats out of the box + +*Preview almost anything with just a spacebar press* + +
+ +

+ Formats + Images + Languages + Plugins +

+ +
+ +**Quick Navigation** + +

+ + Text & Code + + + Images + + + Media + + + Documents + + + Developer + +

+ +
+ +--- + +
+ +## ๐Ÿ“ Text & Code + +### General Text Files + +- `.txt` +- `.rtf` +- `.log` +- `.ini` +- `.conf` +- `.config` +- `.env` +- `.properties` +- `.hosts` +- `.registry` +- `.resource` + +
+ +### Data Formats + +- `.json` +- `.xml` +- `.yaml` +- `.yml` +- `.csv` +- `.tsv` +- `.protobuf` + +
+ +### Markdown & Documentation + +- `.md` +- `.markdown` +- `.mdx` +- `.mmd` +- `.mkd` +- `.mdwn` +- `.mdown` +- `.mdc` +- `.qmd` +- `.rmd` +- `.rmarkdown` +- `.apib` +- `.mdtxt` +- `.mdtext` +- `.restructuredtext` + +
+ +### ๐ŸŒ Web Development + +- `.html` +- `.htm` +- `.css` +- `.js` +- `.ts` +- `.tsx` +- `.uts` +- `.vue` +- `.php` +- `.coffeescript` +- `.haxe` + +
+ +### ๐Ÿ’ป Popular Programming Languages + +- `.c` +- `.cpp` +- `.h` +- `.hpp` +- `.cs` +- `.java` +- `.py` +- `.js` +- `.ts` +- `.go` +- `.php` +- `.rb` +- `.ruby` +- `.swift` +- `.scala` +- `.kotlin` +- `.lua` +- `.rust` +- `.dart` +- `.r` +- `.sql` +- `.vbnet` +- `.vbscript` + +
+ +### ๐ŸŽฏ Functional Languages + +- `.haskell` +- `.fsharp` +- `.elixir` +- `.erlang` +- `.clojure` +- `.lisp` +- `.scheme` +- `.ocaml` +- `.purescript` + +
+ +### ๐Ÿ“œ Shell & Scripting + +- `.sh` +- `.bash` +- `.shellscript` +- `.bat` +- `.cmd` +- `.ps1` +- `.vbscript` +- `.autohotkey` +- `.rexx` +- `.tcl` +- `.nsis` +- `.kixtart` +- `.pike` +- `.falcon` + +
+ +### ๐Ÿ”จ Build Tools & Configuration + +- `.makefile` +- `.mk` +- `.cmake` +- `.gradle` +- `.gitignore` +- `.gitattributes` +- `.diff` +- `.patch` +- `.xshd` + +
+ +### โš™๏ธ System & Low-Level + +- `.assembly` +- `.verilog` +- `.vhdl` +- `.hlsl` +- `.solidity` +- `.ada` +- `.fortran` + +
+ +### ๐Ÿš€ Modern & Emerging Languages + +- `.nim` +- `.crystal` +- `.d` +- `.ceylon` +- `.eiffel` +- `.fantom` +- `.nemerle` +- `.parasail` +- `.pascal` +- `.delphi` +- `.prolog` +- `.qml` +- `.spike` +- `.sqf` +- `.thrift` +- `.vala` +- `.volt` +- `.x10` +- `.xc` +- `.xtend` +- `.lean` +- `.icon` +- `.ilyc` +- `.cool` +- `.boo` +- `.io` +- `.chuck` +- `.gui4cli` + +
+ +*...and most other plain text and script formats* + +
+ +--- + +
+ +## ๐Ÿ–ผ๏ธ Images + + +### ๐Ÿ“ธ Common Formats + +- `.jpg` +- `.jpeg` +- `.jfif` +- `.png` +- `.apng` +- `.gif` +- `.bmp` +- `.webp` +- `.tga` +- `.pcx` +- `.ico` +- `.icon` +- `.icns` +- `.cur` +- `.ani` +- `.svg` +- `.svgz` + +
+ +### โœจ Modern & Next-Gen Formats + +- `.heic` +- `.heif` +- `.avif` +- `.jxl` +- `.jxr` +- `.qoi` + +
+ +### ๐ŸŽจ Professional & Advanced + +- `.jp2` +- `.j2k` +- `.jpf` +- `.jpx` +- `.jpm` +- `.mj2` +- `.exr` +- `.hdr` +- `.tif` +- `.tiff` +- `.dds` +- `.psd` +- `.psb` +- `.xcf` + +
+ +### ๐Ÿ“ Vector & Special Formats + +- `.emf` +- `.wmf` +- `.pbm` +- `.pgm` +- `.pnm` +- `.ppm` +- `.xbm` +- `.xpm` +- `.miff` +- `.pxn` +- `.obm` +- `.lottie` +- `.tgs` +- `.svga` +- `.wdp` + +
+ +### ๐Ÿ“ท RAW Camera Formats + +**Canon** +- `.cr2` +- `.cr3` +- `.crw` + +**Nikon** +- `.nef` +- `.nrw` + +**Sony** +- `.ari` +- `.arw` +- `.sr2` +- `.srf` +- `.srw` + +**Fujifilm** +- `.raf` + +**Olympus** +- `.orf` + +**Pentax** +- `.pef` +- `.ptx` + +**Panasonic/Leica** +- `.rw2` +- `.rwl` +- `.rwz` + +**Kodak** +- `.dcr` +- `.dcs` +- `.drf` +- `.k25` +- `.kdc` + +**Phase One** +- `.cap` +- `.iiq` + +**Hasselblad** +- `.fff` + +**Mamiya** +- `.mef` + +**Minolta** +- `.mrw` + +**Sigma** +- `.x3f` + +**Epson** +- `.erf` + +**Casio** +- `.bay` + +**RED** +- `.r3d` + +**Generic** +- `.raw` +- `.dng` + +
+ +--- + +
+ +## ๐ŸŽฌ Media + + +### ๐ŸŽฅ Video Formats + +- `.mp4` +- `.mkv` +- `.avi` +- `.mov` +- `.wmv` +- `.flv` +- `.webm` +- `.m4v` +- `.mpg` +- `.mpeg` +- `.3gp` +- `.3g2` +- `.ogv` +- `.vob` +- `.ts` +- `.mts` +- `.m2ts` + +*Most common video formats supported* + +
+ +### ๐ŸŽต Audio Formats + +- `.mp3` +- `.flac` +- `.wav` +- `.aac` +- `.ogg` +- `.m4a` +- `.wma` +- `.ape` +- `.opus` +- `.aiff` +- `.aif` +- `.alac` + +*Most common audio formats supported* + +
+ +### ๐Ÿ’ฌ Subtitles + +- `.srt` +- `.sub` +- `.ass` +- `.ssa` + +
+ +--- + +
+ +## ๐Ÿ“„ Documents + + +### ๐Ÿ“‹ PDF + +- `.pdf` + +
+ +### ๐Ÿ“Š Microsoft Office + +- `.doc` +- `.docx` +- `.docm` +- `.xls` +- `.xlsx` +- `.xlsm` +- `.xlsb` +- `.ppt` +- `.pptx` +- `.pptm` +- `.vsd` +- `.vsdx` + +
+ +### ๐Ÿ“‘ OpenDocument + +- `.odt` +- `.ods` +- `.odp` + +
+ +### ๐Ÿ“š E-Books & Comics + +- `.epub` +- `.mobi` +- `.cb7` +- `.cbr` +- `.cbt` +- `.cbz` + +
+ +### ๐Ÿ“ง Email + +- `.eml` +- `.msg` + +
+ +### ๐ŸŒ Web Archives + +- `.mht` +- `.mhtml` +- `.htm` +- `.html` +- `.url` + +
+ +### ๐Ÿ”ค Fonts + +- `.ttf` +- `.otf` +- `.woff` +- `.woff2` +- `.ttc` + +
+ +--- + +
+ +## ๐Ÿ”ง Developer + + +### ๐Ÿ“ฆ Archives & Packages + +- `.7z` +- `.zip` +- `.rar` +- `.tar` +- `.tgz` +- `.gz` +- `.bz2` +- `.xz` +- `.lz` +- `.jar` +- `.nupkg` +- `.snupkg` +- `.crx` +- `.vsix` +- `.cfb` +- `.eif` + +
+ +### ๐ŸชŸ Windows Executables & Libraries + +- `.exe` +- `.dll` +- `.sys` +- `.scr` +- `.ocx` +- `.cpl` +- `.bpl` +- `.ax` +- `.drv` +- `.vxd` +- `.mui` +- `.mun` +- `.tlb` +- `.efi` +- `.mz` + +
+ +### ๐Ÿง Unix/Linux/macOS + +- `.elf` +- `.axf` +- `.bin` +- `.o` +- `.out` +- `.so` +- `.dylib` +- `.ko` +- `.mod` +- `.prx` +- `.puff` +- `.uimage` + +
+ +### ๐Ÿ“ฑ App Installers + +**Android** +- `.apk` +- `.aab` + +**iOS** +- `.ipa` + +**Windows** +- `.msi` +- `.msix` +- `.msixbundle` +- `.appx` +- `.appxbundle` + +**macOS** +- `.dmg` + +**HarmonyOS** +- `.hap` + +**Linux** +- `.ddeb` +- `.deb` +- `.rpm` +- `.appimage` + +**UniApp** +- `.wgt` +- `.wgtu` + +
+ +### ๐ŸŽจ Design & Project Files + +- `.cdr` +- `.fig` +- `.kra` +- `.pdn` +- `.pip` +- `.pix` +- `.sketch` +- `.xd` +- `.xmind` + +
+ +### ๐Ÿงฉ QuickLook Extensions + +- `.qlplugin` + + +
+ +--- + +
+ + +## ๐ŸŽฏ Need More Formats? + +QuickLook's plugin system makes it easy to add support for additional file types + +
+ + + Browse Plugins + + + Back to README + + +

+ +### ๐Ÿ’Ž Popular Plugin Extensions + +
+ + + +**๐Ÿ“Š Office Files** + +Word, Excel, PowerPoint + + + Download + + +
+ + + +**๐Ÿ“„ Enhanced PDF** + +Advanced PDF features + + + Download + + +
+ + + +**๐Ÿ“ CAD Files** + +`.dwg` ยท `.dxf` ยท `.plt` ยท `.cgm` + + + Download + + +
+ +--- + +
+ +๐Ÿ’ก **Note:** This list is continuously updated. Some formats may require specific plugins or system codecs.