ZATHURARC(5)

NAME

zathurarc - zathura configuration file

SYNOPOSIS

/etc/zathurarc, ~/.config/zathura/zathurarc

DESCRIPTION

The zathurarc contains various options controlling the behavior of zathura. One can use the set and map commands:

o set [id] [value]

o map [key] [function] [argument] [mode]

They behave the same as the set and map commands in zathura. Any line not starting with set or map will be ignored.
set
[id] and the corresponding [value] can be one of
o adjust_open [23-25] - adjust mode.

o 23: adjust to best fit
o 24: adjust to width
o 25: don't adjust
o browser, uri_command [string] - command to open external URIs.

The string has to include a %s which will be replaced with the URI.
o completion_bgcolor, completion_fgcolor, completion_g_bgcolor, comple
tion_g_fgcolor, completion_hl_bgcolor, completion_hl_fgcolor, default_bgcolor, default_fgcolor, inputbar_bgcolor, inputbar_fgcolor, notification_e_bgcolor, notification_e_fgcolor, notification_w_bgcolor, notification_w_fgcolor, recolor_darkcolor, recoler_lightcolor, statusbar_bgcolor, statusbar_fgcolor, search_highlight, select_text [color] - colors settings.
The color can be given as hex triplet (#rrggbb) or any color string understood by GTK+ (e.g. red, green, blue, black, ...).
o default_text [string] - text displayed in the statusbar if no file is
opened.
o font [string] - the used font.
o height, width [int] - default height and width of the zathura window.
o labels [bool] - allow label mode.
o list_printer_command [string] - command to list all available print
ers.
o n_completion_items [int] - number of completion items to display.
o offset - page offset.
o print_command [string] - command to print the file.

The string has to include %s four times. The first occurence of %s will be replaced with the printer, the second with additional options given on the command line, the third with the pages to print and the fourth with the filename.
o recolor [bool] - invert the image.
o scroll_step [float] - scroll step.
o scrollbars, show_statusbar, show_inputbar [bool] - show statusbar,
inputbar and scrollbars.
o smooth_scolling [float] - smooth scrolling.
o transparency [float] - transparency of rectangles.
o zoom_max, zoom_min, zoom_step [float] - maximal and minimal zoom
level and zoom step.
map
[key] can be a single character, <C-?> for Ctrl + ? like shortcuts, where ? stands for some key (e.g. <C-q>). Also it can be <S-?> for uppercase shortcuts or one of
<BackSpace>, <CapsLock>, <Down>, <Esc>, <F[1-12]>, <Left>, <PageDown>, <PageUp>, <Return>, <Right>, <Space>, <Super>, <Tab>, <Up>.
[function] and the corresponding [argument] can be one of
o abort - clear command line and buffer.
o adjust_window
o change_buffer [11-12]: change buffer.

o 11: delete last word
o 12: delete last character
o change_mode [mode] - change mode.

For the possible modes see the list of modes below.
o focus_inputbar - focus the inputbar.
o follow - follow a URI.
o navigate [0-3] - navigate the document.

o 0: next
o 1: previous
o 2: left
o 3: right
o navigate_index [4-5|30-33] - nagivate the index.

o 4: up
o 5: down
o 30: expand
o 31: collapse
o 32: select
o quit - quit zathura.
o recolor - toogle recolor setting.
o reload - reload the file.
o rotate - rotate by 90 degrees clockwise.
o scroll [2-5|36-39] scroll.

o 36: half up
o 37: half down
o 38: full up
o 39: full down
o search [string] - search for the specified string.
o switch_goto_mode - toogle goto mode.
o toggle_fullscreen - toogle fullscreen mode.
o toggle_index - toogle index mode.
o toggle_inputbar - toogle inputbar display setting.
o toogle_statusbar - toogle statusbar display setting.
o zoom [in|out|float] - zoom in, out or to a specific zooming level.
[mode] can be one of
o all
o fullscreen
o index
o normal
o insert
o visual
If [mode] is omitted, all will be used.

EXAMPLE

# zathurarc

# colors
set statusbar_bgcolor #00FF00
set statusbar_fgcolor red

# settings
set height 1024
set width 768
set adjust_open width

# key bindings
map <PageUp> navigate previous
map <PageDown> navigate next

map + zoom in
map - zoom out

map <C-q> quit

SEE ALSO

zathura(1)

AUTHOR

Sebastian Ramacher <s.ramacher@gmx.at>
Copyright © 2010-2025 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout