mirror of
https://github.com/QL-Win/QuickLook.git
synced 2025-10-17 16:44:35 +00:00
6def05648a
Added instructions for rotating and panning 3D models using left and middle mouse buttons to the controls section of the README.
118 lines
6.9 KiB
Markdown
118 lines
6.9 KiB
Markdown
<img src="https://user-images.githubusercontent.com/1687847/82130498-8c3eac80-97d4-11ea-9e88-372ab9c50295.png" width="80">
|
|
|
|
# QuickLook
|
|
|
|
<a href="https://trendshift.io/repositories/3258" target="_blank"><img src="https://trendshift.io/api/badge/repositories/3258" style="width: 250px; height: 55px;" width="250" height="55"/></a>
|
|
|
|
[](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 but I still decided to craft another one by myself, because they are either not being actively developed, lack of variety.
|
|
|
|
## 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 and later only). Not supported on Windows 10 S. Not support file preview in Open-File or Save-File dialogs. <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?tab=readme-ov-file#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
|
|
- <kbd>Left Mouse</kbd> Rotate (3D models)
|
|
- <kbd>Middle Mouse</kbd> Pan (3D models)
|
|
|
|
## 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) |
|
|
|
|
Here is the complete list of plugins from [Available-Plugins](https://github.com/QL-Win/QuickLook/wiki/Available-Plugins).
|
|
|
|
## Supported file formats
|
|
|
|
See the [Supported formats](SUPPORTED_FORMATS.md)
|
|
|
|
## Supported 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)
|
|
|
|
## Community
|
|
|
|
QQ Group: [371388501](https://qm.qq.com/q/KIczirznua)
|
|
|
|
## 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.
|