SYNOPSIS

katarakt ([OPTIONS] FILE|URL)*

DESCRIPTION

It\(cqs a PDF viewer. It views PDFs.

There are currently two layouts. The presentation layout is very simple and only supports scrolling on a per page basis. As the name suggests the current page is displayed in the center and zoomed to fit the window. It is active by default.

The grid layout is much more advanced and offers continuous (smooth, per pixel) scrolling, zooming and adjusting the column count. Pages keep their correct relative size and are shown in a grid.

For every file passed on the command line a process is spawned.

OPTIONS

-p, --page NUM

Start showing page NUM.

-f, --fullscreen

Start in fullscreen mode.

-q, --quit

Quit on initialization failure.

-h, --help

Print help and exit.

CONFIGURATION

Variables and key bindings can be changed by modifying the katarakt.ini file. By default it is read from $XDG_CONFIG_HOME.

KEY BINDINGS

q

Quit katarakt

1

Switch to presentation layout. Views a single page at a time, scaled to fit the screen

2

Switch to grid layout. Views pages in a continuous fashion, scaled to fit the width. Supports columns.

Up, Down, Left, Right, k, j, h, l

Move around (up/down/left/right)

^u, ^d

Scroll up/down half the screen

BackSpace, Space, ^b, ^f

Scroll up/down the screen. By default scrolls 90% to create an overlapping region

PgUp, PgDown

Scroll up/down one page. Kind of swaps the pages in place

Home, End, g, G

Go to the first/last page

^g

Show goto page bar

f

Toggle fullscreen

t

Toggle page number display

r

Reload document

o

Open a different document, shows a file dialog

-, +, =

Adjust zoom level (grid layout only)

z

Reset zoom level to default, i.e. fit width (grid layout only)

[, ]

Adjust column count (grid layout only)

/

Show search bar

n, N

Focus next/previous search hit

^n, ^N

Focus next/previous search hit that is currently not visible

u, i

Rotate pages left/right

^o, ^i, Alt-Left, Alt-Right

Move backward/forward through the jump list. Entries are added automatically when jumping

VARIABLES

int background_opacity

223: opacity of the black background in range [0..255]. Only works when using a compositor.

string default_layout

presentation: the layout on startup. Possible values: presentation, grid

int mouse_wheel_factor

120: QT delta for turning the mouse wheel 1 click

int smooth_scroll_delta

30: pixel offset when moving around

float screen_scroll_factor

0.9: factor for scrolling the screen. Should be <= 1 to create an overlapping region

int useless_gap

2: gap between two pages in pixels

int min_page_width

150: pages can not be smaller than this

int min_zoom

-14: smallest zoom value

int max_zoom

30: biggest zoom value

float zoom_factor

0.05: influences the number of steps between min and max

int prefetch_count

3: number of pages exceeding the currently visible ones to render, back- and forwards respectively

float search_padding

0.2: factor of the area on the screen to display search hits in. Moves search hits towards the center

bool smooth_downscaling

true: enables the higher quality downsampling filter

int thumbnail_size

32: one dimension of square thumbnails saved at run-time for every page that was once rendered

int rect_expansion

2: number of pixels search rects are expanded by

bool quit_on_init_fail

false: Quit katarakt if the document fails to open

string icon_theme

The name of your icon theme. Fill in if auto detection fails.

COMMUNITY

Feel free to join the IRC channel #katarakt on freenode.

AUTHOR

katarakt is written by Philipp Erhardt.

RESOURCES

Gitweb: http://git.cs.fau.de/?p=katarakt

Homepage: http://git.cs.fau.de/~go18gomu/katarakt/