mirror of
https://github.com/QL-Win/QuickLook.git
synced 2025-09-07 21:48:06 +00:00
93 lines
5.2 KiB
Markdown
93 lines
5.2 KiB
Markdown
<img src="https://user-images.githubusercontent.com/1687847/82130498-8c3eac80-97d4-11ea-9e88-372ab9c50295.png" width="80">
|
|
|
|
# QuickLook
|
|
|
|
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
|
|
[](https://ci.appveyor.com/project/xupefei/QuickLook)
|
|
[](https://github.com/QL-Win/QuickLook/releases)
|
|
[](https://github.com/QL-Win/QuickLook/releases/latest)
|
|
|
|
<img src="https://user-images.githubusercontent.com/1687847/64730506-2a60d100-d4e8-11e9-95a6-f13dbd869b2a.jpeg" width="400">
|
|
|
|
## 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 <kbd>Space</kbd> 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) <a href="https://www.microsoft.com/store/apps/9nv4bs3l1h4s?ocid=badge" target="_blank"><img src="https://developer.microsoft.com/store/badges/images/English_get_L.png" height="22px" alt="Store Link" /></a>
|
|
* 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 [AppVeyor](https://ci.appveyor.com/project/xupefei/quicklook/build/artifacts) and [GitHub Action](https://github.com/QL-Win/QuickLook/releases/)
|
|
|
|
[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 <kbd>Spacebar</kbd>
|
|
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 <kbd>Spacebar</kbd> again, pressing <kbd>Esc</kbd> or clicking the `⨉` button
|
|
|
|
### Hotkeys and buttons
|
|
|
|
- <kbd>Spacebar</kbd> Show/Hide the preview window
|
|
- <kbd>Esc</kbd> Hide the preview window
|
|
- <kbd>Enter</kbd> Open/Execute current file
|
|
- <kbd>Mouse</kbd> <kbd>↑</kbd> <kbd>↓</kbd> <kbd>←</kbd> <kbd>→</kbd> Preview another file
|
|
- <kbd>Mouse Wheel</kbd> Zoom in/out (images)
|
|
- <kbd>Ctrl</kbd>+<kbd>Mouse Wheel</kbd> Zoom in/out (PDFs)
|
|
- <kbd>Wheel</kbd> 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)
|
|
|
|
## Developer
|
|
|
|
- **Formatter**: [CodeMaid.config](CodeMaid.config), [Settings.XamlStyler](Settings.XamlStyler)
|
|
|
|
## 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
|
|
|
|
|
|
|
|
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.
|