llpp
llpp is a lightweight, fast and featureful PDF viewer based on MuPDF.
Contents
Installation
llpp can be installed from the AUR using the stable llpp, or the latest repo version llpp-git.
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
rkey - 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.