# QuickLook
[![license](https://img.shields.io/github/license/QL-Win/QuickLook.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)
[![AppVeyor](https://img.shields.io/appveyor/ci/xupefei/QuickLook.svg)](https://ci.appveyor.com/project/xupefei/QuickLook)
[![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)
## 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 (e.g. [WinQuickLook](https://github.com/shibayan/WinQuickLook) and [Seer](https://github.com/ccseer/Seer)). Despite these options, I still decided to craft another one by myself, because they are either not being actively developed, lack of variety, or ask for some :dollar:.
## Highlights
- 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
## Usage
### Download/Installation
Get it from one of the following sources:
* Microsoft Store (Windows 10 users only, no preview in open/save-dialogs available)
* Installer or portable archive of the stable version from [GitHub Release](https://github.com/QL-Win/QuickLook/releases)
* Nightly builds from [AppVeyor](https://ci.appveyor.com/project/xupefei/quicklook/build/artifacts)
[What are the differences between `.msi`, `.zip`, Nightly and Store versions?](https://github.com/QL-Win/QuickLook/wiki/Differences-Between-Distributions)
**Note:** Don't forget to check out the [plugins](https://github.com/QL-Win/QuickLook/wiki/Available-Plugins) for previewing office-files, epubs, fonts and more!
### 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
## Supported file types, file manager integration, etc.
See the [Wiki page](https://github.com/QL-Win/QuickLook/wiki)
## Translations
See the [Translation guide](https://github.com/QL-Win/QuickLook/wiki/Translations)
## 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 😊
## Licenses
![GPL-v3](https://www.gnu.org/graphics/gplv3-127x51.png)
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.