ZATHURA(1) zathura ZATHURA(1)

zathura - a document viewer

zathura [-e XID] [-c PATH] [-d PATH] [-p PATH] [-w PASSWORD] [-P NUMBER] [--fork] [-l LEVEL] [-s] [-x CMD] [--synctex-forward INPUT] [--synctex-pid PID] [-find STRING] <files>

zathura displays the given files. If a single hyphen-minus (-) is given as file name, the content will be read from the standard input. If no files are given, an empty zathura instance launches.

Reparents to window specified by xid
Path to the config directory
Path to the data directory
Path to the directory containing plugins
The documents password. If multiple documents are opened at once, the password will be used for the first one and zathura will ask for the passwords of the remaining files if needed.
Opens the document at the given page number. Pages are numbered starting with 1, and negative numbers indicate page numbers starting from the end of the document, -1 being the last page.
Opens the document and searches for the given string.
Set log level (debug, info, warning, error)
Set the synctex editor command. Overrides the synctex-editor-command setting.
Jump to the given position. The switch expects the same format as specified for synctex's view -i. If no instance is running for the specified document, a new instance will be launched (only if --synctex-pid is not specified).
Instead of looking for an instance having the correct file opened, try only the instance with the given PID. Note that if the given PID does not have the correct file open or does not exist, no new instance will be spanned.
Start in a non-default mode
Fork into background
Display version string and exit
Display help and exit


Go to the next page
Go to the previous page
Scroll to the left, down, up or right direction
Scroll to the left, down, up or right direction
^t, ^d, ^u, ^y
Scroll a half page left, down, up or right
Scroll a full page left, down, up or right
Goto to the first, the last or to the nth page
Snaps to the current page
Goto top or bottom of the current page
^o, ^i
Move backward and forward through the jump list
^j, ^k
Bisect forward and backward between the last two jump points
^c, Escape
Adjust window in best-fit or width mode
/, ?
Search for text
Search for the next or previous result
Open document
Follow links
Display link target
Copy link target into the clipboard
Enter command
Rotate by 90 degrees
Recolor (grayscale and invert colors)
Reload document
Show index and switch to Index mode
Toggle dual page view
Cycle opening column in dual page view
Switch to presentation mode
Switch to fullscreen mode
Toggle inputbar
Toggle statusbar
+, -, =
Zoom in, out or to the original size
Zoom in, out or to the original size
Zoom to size n
Set a quickmark to a letter or number X
Goto quickmark saved at letter or number X

Fullscreen mode

Go to the next or previous page
Scroll a full page down or up
Goto to the first, the last or to the nth page
^c, Escape
Switch to normal mode
+, -, =
Zoom in, out or to the original size
Zoom in, out or to the original size
Zoom to size n

Presentation mode

Scroll a full page down or up
^c, Escape
Switch to normal mode

Index mode

Move to upper or lower entry
Expand entry
Expand all entries
Collapse entry
Collapse all entries
Select and open entry

Mouse bindings

Scroll up or down
Zoom in or out
Pan the document
Follow link
Select text
Highlight region

Save a bookmark
Delete a bookmark
List bookmarks
Close document
Execute an external command. $FILE expands to the current document path, $PAGE to the current page number, and $DBUS to the bus name of the D-Bus interface
Show document information
Open a document
Set page offset
Print document
Save document (and force overwriting)
Export attachments
Write values, descriptions, etc. of all current settings to a file.

The default appearance and behaviour of zathura can be overwritten by modifying the zathurarc file (default path: ~/.config/zathura/zathurarc). For a detailed description please consult zathurarc(5).

Both synctex forward and backwards synchronization are supported by zathura, To enable synctex forward synchronization, please look at the --synctex-forward and --synctex-editor options. zathura will also emit a signal via the D-Bus interface. To support synctex backwards synchronization, zathura provides a D-Bus interface that can be called by the editor. For convince zathura also knows how to parse the output of the synctex view command. It is enough to pass the arguments to synctex view's -i option to zathura via --synctex-forward and zathura will pass the information to the correct instance.

For gvim forward and backwards synchronization support can be set up as follows: First add the following to the vim configuration:

function! Synctex()
  execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
map <C-enter> :call Synctex()<cr>

Then launch zathura with

zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file

Some editors support zathura as viewer out of the box:

Path to the directory containing plugins. This directory is only considered if no other directory was specified using --plugins-dir.

If GDK_NATIVE_WINDOWS is enabled you will experience problems with large documents. In this case zathura might crash or pages cannot be rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.



2024-05-09 0.5.6