mirror of
https://github.com/QL-Win/QuickLook.git
synced 2025-09-09 22:00:36 +00:00
53 lines
3.2 KiB
Markdown
53 lines
3.2 KiB
Markdown
|
|
|
|
# QuickLook
|
|
|
|
[](https://ci.appveyor.com/project/xupefei/quicklook)
|
|
|
|
*This project is currently under heavy development. Come back often to see what's new.*
|
|
|
|
<img src="http://pooi.moe/QuickLook/sample.gif" width="400">
|
|
|
|
## Background
|
|
[Quick Look](https://en.wikipedia.org/wiki/Quick_Look) is among the few features I missed from Mac OS X. It enables *very* quick preview of file by pressing <kbd>Space</kbd> key while highlighting it, without opening its associated application. Then I decide to add this feature to Windows by myself, which results this “QuickLook” project.
|
|
|
|
You may ask, why you write this when there several alternatives available on the Internet (e.g. [WinQuickLook](https://github.com/shibayan/WinQuickLook) and [Seer](https://github.com/ccseer/Seer))? The answer is that, they are all among those which no longer actively developed, lack of support of file types and plugins, or asking user for amounts of $$$.
|
|
|
|
## Features
|
|
Till now, QuickLook supports the preview of
|
|
|
|
- Images: e.g. `.png`, `.jpg`, `.bmp` and `.gif`
|
|
- Compressed archives: `.zip`, `.rar`, `.7z` etc.
|
|
- Pdf file
|
|
- All kinds of text files (determined by file content)
|
|
- Microsoft Word (`.doc`, `.docx`), Excel (`.xls`, `.xlsx`) and PowerPoint (`.ppt`, `.pptx`) files (requires MS Office installation)
|
|
- Video files (`.mp4`, `.mkv`, `.m2ts` etc.)
|
|
- HTML files (`.htm`, `.html`)
|
|
- Markdown file (`.md`)
|
|
- Other files and folders will be shown in a information box
|
|
|
|
## Usages
|
|
In-place preview / Integrate with 3rd-party file manager
|
|
- You may set up a custom hot key that fires event `QuickLook.exe C:\path\to\your\file.txt`. Press your hotkey for the 2nd time will close the existing preview window.
|
|
|
|
Hotkeys in preview window:
|
|
|
|
- <kbd>Space</kbd> Show/Hide the preview window
|
|
- <kbd>↑</kbd> <kbd>↓</kbd> <kbd>←</kbd> <kbd>→</kbd> Preview another file
|
|
- <kbd>Ctrl+Wheel</kbd> Zoom in/out
|
|
|
|
## Development
|
|
|
|
The previewing ability can be extended by new plugins. Read the [plugin interface](https://github.com/xupefei/QuickLook/blob/master/QuickLook/Plugin/IViewer.cs), [context object](https://github.com/xupefei/QuickLook/blob/master/QuickLook/Plugin/ContextObject.cs) for more information. [Pre-shipped plugins](https://github.com/xupefei/QuickLook/tree/master/QuickLook.Plugin) contains more detailed implementation.
|
|
Note that any plugin must be under the `QuickLook.Plugin` namespace, has the filename similar to `QuickLook.Plugin.YourPlugin.dll` and placed under `<Application>\Plugins\QuickLook.Plugin.YourPlugin\` subfolder.
|
|
|
|
## Licenses
|
|
|
|
|
|
|
|
Application icons made by Freepik from www.flaticon.com. Used under the [Flaticon Basic License](http://file000.flaticon.com/downloads/license/license.pdf).
|
|
|
|
All source codes, if not specially excluded, are licensed under [LGPL-3.0](https://opensource.org/licenses/LGPL-3.0).
|
|
|
|
If you want make any modification on these source codes while keeping new codes not protected by LGPL-3.0, please contact me for a sublicense instead.
|