# llpp

llpp is a lightweight, fast and featureful PDF viewer based on MuPDF.

## 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. Pressing the `h` key 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: `~/.config/llpp.conf`. This file stores: 1) application defaults, and 2) file-by-file user preferences (e.g. the last page viewed).

### Custom key bindings

It is possible to change the key bindings in `~/.config/llpp.conf`. For example to disable `Esc` exiting llpp, add the `keymap` element in between the `defaults` tags as follows:

    ~/.config/llpp.conf

    <llppconfig>
      <defaults ... >
        <keymap mode='view'>
          <map in='esc' out=''/>
        </keymap>
      </defaults>
    </llppconfig>

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

## See also

- llpp git repo

Category:

- Graphics and desktop publishing