This is a standalone document previewer based on macOS's built-in
Quick Look engine——imagine a nicer qlmanage
. It's particularly
useful as a quick command-line viewer for terminal applications, like
mutt.
You can either download a pre-built
release, or build it
yourself. Either way, you then probably want to copy the executable
into your PATH
.
When getting the current release, you'll find the executable inside the ZIP file you downloaded. While it's codesigned and notarized, please note that you still cannot just double-click to run it, as it is not an app but a command line application.
When building it yourself, make sure you have Xcode installed. Either
use that to open and build the project, or just run make
from the
command line. You will then find the executable in
build/Release/qlview
.
Run it from the command line:
# qlview <file>
If you execute qlview
without any arguments, it'll open an empty
window where you can drag a document into.
To use qlview
with mutt, there's a helper
script
mutt-qlview
coming with the distribution. Put both that script and qlview
itself
into your PATH
and then add these mailcap
entries to
your mutt configuration; see mutt's
manual for more on that.
You can also add the following to your .muttrc
to quickly open the
first HTML attachment in qlview
:
macro index,pager V <view-attachments>/html\n<view-mailcap><quit>
Feel free to open issues or pull requests.