llpp
llpp is a lightweight, fast and featureful PDF, EPUB, XPS and CBZ viewer based on MuPDF.
Contents
Installation
llpp can be installed from the AUR using the stable llppAUR, or the latest repo version llpp-gitAUR.
Usage
llpp uses keyboard shortcuts and the mouse to navigate through a document. By default, pressing F1
or h
will bring up a help page where all other key bindings are described.
Check out the following page for a complete list of the key and mouse bindings.
Configuration
llpp uses a configuration file to store settings: $XDG_CONFIG_HOME/llpp.conf
or ~/.config/llpp.conf
. This file stores: 1) application defaults, and 2) file-by-file user preferences (e.g. the last page viewed).
UI Font
One can set the font used by llpp by indicating the size and filename in the config. For example:
<llppconfig> <ui-font size='16'><![CDATA[/usr/share/fonts/TTF/DejaVuSansMono.ttf]]></ui-font> <defaults ... > ... </defaults> </llppconfig>
Custom key bindings
It is possible to configure key bindings. For example, to disable Esc
exiting llpp, add the keymap
element in between the defaults
tags as follows:
<llppconfig> <defaults ... > <keymap mode='view'> <map in='esc' out=/> </keymap> </defaults> </llppconfig>
More examples can be found in llpp's example file keys.txt. For vi-like key bindings, see this example.
Tips and Tricks
Reload File
A document can be reloaded in three ways:
- Pressing the
r
key - Sending a HUP signal to the llpp process
# killall -SIGHUP llpp
- Using the "remote" interface (see below)
Remote Interface
The following commands will setup the remote interface and use it to reload the file "image.pdf".
# mkfifo /tmp/llpp.remote # llpp -remote /tmp/llpp.remote image.pdf & disown # sleep 1 # echo reload >/tmp/llpp.remote
There are eight remote commands:
-
reload
- reload -
quit
- quit -
goto <page-number> <x-coordinate> <y-coordinate>
- goto -
goto1 <page-number> <relative-y-coordinate>
- goto -
gotor <file-name> <page-number>
- goto other document -
gotord <file-name> <remote-destination>
- goto named destination within the other document -
rect <pageno> <color> <x0> <y0> <x1> <y1>
- draw a rectangle -
activatewin
- raise and switch to llpp's window
Cleanup history
Files that no longer exist can be cleaned from llpp's history by using a "garbage collecting" script, such as the upstream python2 script here. Use the -gc
flag:
$ llpp -gc /path/to/script gc.py done.