1ZATHURA(1) zathura ZATHURA(1)
2
6 zathura - a document viewer
7
9 zathura [-e XID] [-c PATH] [-d PATH] [-p PATH] [-w PASSWORD] [-P NUM‐
10 BER] [--fork] [-l LEVEL] [-s] [-x CMD] [--synctex-forward INPUT]
11 [--synctex-pid PID] [-find STRING] <files>
12
14 zathura displays the given files. If a single hyphen-minus (-) is given
15 as file name, the content will be read from the standard input. If no
16 files are given, an empty zathura instance launches.
17
19 -e,--reparent=xid
20 Reparents to window specified by xid
21 -c,--config-dir=path
23 Path to the config directory
24 -d,--data-dir=path
26 Path to the data directory
27 -p,--plugins-dir=path
29 Path to the directory containing plugins
30 -w,--password=password
32 The documents password. If multiple documents are opened at
33 once, the password will be used for the first one and zathura
34 will ask for the passwords of the remaining files if needed.
35 -P,--page=number
37 Opens the document at the given page number. Pages are numbered
38 starting with 1, and negative numbers indicate page numbers
39 starting from the end of the document, -1 being the last page.
40 -f,--find=string
42 Opens the document and searches for the given string.
43 -l,--log-level=level
45 Set log level (debug, info, warning, error)
46 -x,--synctex-editor-command=command
48 Set the synctex editor command. Overrides the synctex-edi‐
49 tor-command setting.
50 --synctex-forward=input
52 Jump to the given position. The switch expects the same format
53 as specified for synctex's view -i. If no instance is running
54 for the specified document, a new instance will be launched
55 (only if --synctex-pid is not specified).
56 --synctex-pid=pid
58 Instead of looking for an instance having the correct file
59 opened, try only the instance with the given PID. Note that if
60 the given PID does not have the correct file open or does not
61 exist, no new instance will be spanned.
62 --mode=mode
64 Start in a non-default mode
65 --fork Fork into background
67 --version
69 Display version string and exit
70 --help Display help and exit
72
74 General
75 J, PgDn
77 Go to the next page
78 K, PgUp
80 Go to the previous page
81 h, k, j, l
83 Scroll to the left, down, up or right direction
84 Left, Down, Up, Right
86 Scroll to the left, down, up or right direction
87 ^t, ^d, ^u, ^y
89 Scroll a half page left, down, up or right
90 t, ^f, ^b, space, <S-space>, y
92 Scroll a full page left, down, up or right
93 gg, G, nG
95 Goto to the first, the last or to the nth page
96 P Snaps to the current page
98 H, L Goto top or bottom of the current page
100 ^o, ^i Move backward and forward through the jump list
102 ^j, ^k Bisect forward and backward between the last two jump points
104 ^c, Escape
106 Abort
107 a, s Adjust window in best-fit or width mode
109 /, ? Search for text
111 n, N Search for the next or previous result
113 o, O Open document
115 f Follow links
117 F Display link target
119 c Copy link target into the clipboard
121 : Enter command
123 r Rotate by 90 degrees
125 ^r Recolor (grayscale and invert colors)
127 R Reload document
129 Tab Show index and switch to Index mode
131 d Toggle dual page view
133 F5 Switch to presentation mode
135 F11 Switch to fullscreen mode
137 ^m Toggle inputbar
139 ^n Toggle statusbar
141 +, -, =
143 Zoom in, out or to the original size
144 zI, zO, z0
146 Zoom in, out or to the original size
147 n= Zoom to size n
149 mX Set a quickmark to a letter or number X
151 'X Goto quickmark saved at letter or number X
153 q Quit
155 Fullscreen mode
157 J, K Go to the next or previous page
159 space, <S-space>, <BackSpace>
161 Scroll a full page down or up
162 gg, G, nG
164 Goto to the first, the last or to the nth page
165 ^c, Escape
167 Abort
168 F11 Switch to normal mode
170 +, -, =
172 Zoom in, out or to the original size
173 zI, zO, z0
175 Zoom in, out or to the original size
176 n= Zoom to size n
178 q Quit
180 Presentation mode
182 space, <S-space>, <BackSpace>
184 Scroll a full page down or up
185 ^c, Escape
187 Abort
188 F5 Switch to normal mode
190 q Quit
192 Index mode
194 k, j Move to upper or lower entry
196 l Expand entry
198 L Expand all entries
200 h Collapse entry
202 H Collapse all entries
204 space, Return
206 Select and open entry
207 Mouse bindings
209 Scroll Scroll up or down
211 ^Scroll
213 Zoom in or out
214 Hold Button2
216 Pan the document
217 Button1
219 Follow link
220
222 bmark Save a bookmark
223 bdelete
225 Delete a bookmark
226 blist List bookmarks
228 close Close document
230 exec Execute an external command. $FILE expands to the current docu‐
232 ment path, and $PAGE to the current page number
233 info Show document information
235 open Open a document
237 offset Set page offset
239 print Print document
241 write(!)
243 Save document (and force overwriting)
244 export Export attachments
246 dump Write values, descriptions, etc. of all current settings to a
248 file.
249
251 The default appearance and behaviour of zathura can be overwritten by
252 modifying the zathurarc file (default path: ~/.config/zathura/zathu‐
253 rarc). For a detailed description please consult zathurarc(5).
254
256 Both synctex forward and backwards synchronization are supported by za‐
257 thura, To enable synctex forward synchronization, please look at the
258 --synctex-forward and --synctex-editor options. zathura will also emit
259 a signal via the D-Bus interface. To support synctex backwards synchro‐
260 nization, zathura provides a D-Bus interface that can be called by the
261 editor. For convince zathura also knows how to parse the output of the
262 synctex view command. It is enough to pass the arguments to synctex
263 view's -i option to zathura via --synctex-forward and zathura will pass
264 the information to the correct instance.
265 For gvim forward and backwards synchronization support can be set up as
267 follows: First add the following to the vim configuration:
268 function! Synctex()
270 execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
271 redraw!
272 endfunction
273 map <C-enter> :call Synctex()<cr>
274 Then launch zathura with
276 zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
278 Some editors support zathura as viewer out of the box:
280 • LaTeXTools for SublimeText (‐
282 https://latextools.readthedocs.io/en/latest/available-viewers/#za‐
283 thura)
284 • LaTeX for Atom (https://atom.io/packages/latex)
286
288 ZATHURA_PLUGINS_PATH
289 Path to the directory containing plugins. This directory is only
290 considered if no other directory was specified using --plug‐
291 ins-dir.
292
294 If GDK_NATIVE_WINDOWS is enabled you will experience problems with
295 large documents. In this case zathura might crash or pages cannot be
296 rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The
297 same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.
298
300 zathurarc(5)
301
303 pwmt.org
304
306 2009-2022, pwmt.org
3070.5.2 2022-11-27 ZATHURA(1)