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 : Enter command
121 r Rotate by 90 degrees
123 ^r Recolor (grayscale and invert colors)
125 R Reload document
127 Tab Show index and switch to Index mode
129 d Toggle dual page view
131 F5 Switch to presentation mode
133 F11 Switch to fullscreen mode
135 ^m Toggle inputbar
137 ^n Toggle statusbar
139 +, -, =
141 Zoom in, out or to the original size
142 zI, zO, z0
144 Zoom in, out or to the original size
145 n= Zoom to size n
147 mX Set a quickmark to a letter or number X
149 'X Goto quickmark saved at letter or number X
151 q Quit
153 Fullscreen mode
155 J, K Go to the next or previous page
157 space, <S-space>, <BackSpace>
159 Scroll a full page down or up
160 gg, G, nG
162 Goto to the first, the last or to the nth page
163 ^c, Escape
165 Abort
166 F11 Switch to normal mode
168 +, -, =
170 Zoom in, out or to the original size
171 zI, zO, z0
173 Zoom in, out or to the original size
174 n= Zoom to size n
176 q Quit
178 Presentation mode
180 space, <S-space>, <BackSpace>
182 Scroll a full page down or up
183 ^c, Escape
185 Abort
186 F5 Switch to normal mode
188 q Quit
190 Index mode
192 k, j Move to upper or lower entry
194 l Expand entry
196 L Expand all entries
198 h Collapse entry
200 H Collapse all entries
202 space, Return
204 Select and open entry
205 Mouse bindings
207 Scroll Scroll up or down
209 ^Scroll
211 Zoom in or out
212 Hold Button2
214 Pan the document
215 Button1
217 Follow link
218
220 bmark Save a bookmark
221 bdelete
223 Delete a bookmark
224 blist List bookmarks
226 close Close document
228 exec Execute an external command
230 info Show document information
232 open Open a document
234 offset Set page offset
236 print Print document
238 write(!)
240 Save document (and force overwriting)
241 export Export attachments
243 dump Write values, descriptions, etc. of all current settings to a
245 file.
246
248 The default appearance and behaviour of zathura can be overwritten by
249 modifying the zathurarc file (default path: ~/.config/zathura/zathu‐
250 rarc). For a detailed description please consult zathurarc(5).
251
253 Both synctex forward and backwards synchronization are supported by za‐
254 thura, To enable synctex forward synchronization, please look at the
255 --synctex-forward and --synctex-editor options. zathura will also emit
256 a signal via the D-Bus interface. To support synctex backwards synchro‐
257 nization, zathura provides a D-Bus interface that can be called by the
258 editor. For convince zathura also knows how to parse the output of the
259 synctex view command. It is enough to pass the arguments to synctex
260 view's -i option to zathura via --synctex-forward and zathura will pass
261 the information to the correct instance.
262 For gvim forward and backwards synchronization support can be set up as
264 follows: First add the following to the vim configuration:
265 function! Synctex()
267 execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
268 redraw!
269 endfunction
270 map <C-enter> :call Synctex()<cr>
271 Then launch zathura with
273 zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
275 Some editors support zathura as viewer out of the box:
277 • LaTeXTools for SublimeText (‐
279 https://latextools.readthedocs.io/en/latest/available-viewers/#za‐
280 thura)
281 • LaTeX for Atom (https://atom.io/packages/latex)
283
285 ZATHURA_PLUGINS_PATH
286 Path to the directory containing plugins. This directory is only
287 considered if no other directory was specified using --plug‐
288 ins-dir.
289
291 If GDK_NATIVE_WINDOWS is enabled you will experience problems with
292 large documents. In this case zathura might crash or pages cannot be
293 rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The
294 same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.
295
297 zathurarc(5)
298
300 pwmt.org
301
303 2009-2021, pwmt.org
3040.4.7 2020-09-03 ZATHURA(1)