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
232 info Show document information
234 open Open a document
236 offset Set page offset
238 print Print document
240 write(!)
242 Save document (and force overwriting)
243 export Export attachments
245 dump Write values, descriptions, etc. of all current settings to a
247 file.
248
250 The default appearance and behaviour of zathura can be overwritten by
251 modifying the zathurarc file (default path: ~/.config/zathura/zathu‐
252 rarc). For a detailed description please consult zathurarc(5).
253
255 Both synctex forward and backwards synchronization are supported by za‐
256 thura, To enable synctex forward synchronization, please look at the
257 --synctex-forward and --synctex-editor options. zathura will also emit
258 a signal via the D-Bus interface. To support synctex backwards synchro‐
259 nization, zathura provides a D-Bus interface that can be called by the
260 editor. For convince zathura also knows how to parse the output of the
261 synctex view command. It is enough to pass the arguments to synctex
262 view's -i option to zathura via --synctex-forward and zathura will pass
263 the information to the correct instance.
264 For gvim forward and backwards synchronization support can be set up as
266 follows: First add the following to the vim configuration:
267 function! Synctex()
269 execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
270 redraw!
271 endfunction
272 map <C-enter> :call Synctex()<cr>
273 Then launch zathura with
275 zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
277 Some editors support zathura as viewer out of the box:
279 • LaTeXTools for SublimeText (‐
281 https://latextools.readthedocs.io/en/latest/available-viewers/#za‐
282 thura)
283 • LaTeX for Atom (https://atom.io/packages/latex)
285
287 ZATHURA_PLUGINS_PATH
288 Path to the directory containing plugins. This directory is only
289 considered if no other directory was specified using --plug‐
290 ins-dir.
291
293 If GDK_NATIVE_WINDOWS is enabled you will experience problems with
294 large documents. In this case zathura might crash or pages cannot be
295 rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The
296 same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.
297
299 zathurarc(5)
300
302 pwmt.org
303
305 2009-2022, pwmt.org
3060.4.8 2021-07-14 ZATHURA(1)