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] <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 -l,--log-level=level
42 Set log level (debug, info, warning, error)
43 -x,--synctex-editor-command=command
45 Set the synctex editor command. Overrides the synctex-edi‐
46 tor-command setting.
47 --synctex-forward=input
49 Jump to the given position. The switch expects the same format
50 as specified for synctex's view -i. If no instance is running
51 for the specified document, a new instance will be launched
52 (only if --synctex-pid is not specified).
53 --synctex-pid=pid
55 Instead of looking for an instance having the correct file
56 opened, try only the instance with the given PID. Note that if
57 the given PID does not have the correct file open or does not
58 exist, no new instance will be spanned.
59 --mode=mode
61 Start in a non-default mode
62 --fork Fork into background
64 --version
66 Display version string and exit
67 --help Display help and exit
69
71 General
72 J, PgDn
74 Go to the next page
75 K, PgUp
77 Go to the previous page
78 h, k, j, l
80 Scroll to the left, down, up or right direction
81 Left, Down, Up, Right
83 Scroll to the left, down, up or right direction
84 ^t, ^d, ^u, ^y
86 Scroll a half page left, down, up or right
87 t, ^f, ^b, space, <S-space>, y
89 Scroll a full page left, down, up or right
90 gg, G, nG
92 Goto to the first, the last or to the nth page
93 H, L Goto top or bottom of the current page
95 ^o, ^i Move backward and forward through the jump list
97 ^j, ^k Bisect forward and backward between the last two jump points
99 ^c, Escape
101 Abort
102 a, s Adjust window in best-fit or width mode
104 /, ? Search for text
106 n, N Search for the next or previous result
108 o, O Open document
110 f Follow links
112 F Display link target
114 : Enter command
116 r Rotate by 90 degrees
118 ^r Recolor (grayscale and invert colors)
120 R Reload document
122 Tab Show index and switch to Index mode
124 d Toggle dual page view
126 F5 Switch to presentation mode
128 F11 Switch to fullscreen mode
130 ^m Toggle inputbar
132 ^n Toggle statusbar
134 +, -, =
136 Zoom in, out or to the original size
137 zI, zO, z0
139 Zoom in, out or to the original size
140 n= Zoom to size n
142 mX Set a quickmark to a letter or number X
144 'X Goto quickmark saved at letter or number X
146 q Quit
148 Fullscreen mode
150 J, K Go to the next or previous page
152 space, <S-space>, <BackSpace>
154 Scroll a full page down or up
155 gg, G, nG
157 Goto to the first, the last or to the nth page
158 ^c, Escape
160 Abort
161 F11 Switch to normal mode
163 +, -, =
165 Zoom in, out or to the original size
166 zI, zO, z0
168 Zoom in, out or to the original size
169 n= Zoom to size n
171 q Quit
173 Presentation mode
175 space, <S-space>, <BackSpace>
177 Scroll a full page down or up
178 ^c, Escape
180 Abort
181 F5 Switch to normal mode
183 q Quit
185 Index mode
187 k, j Move to upper or lower entry
189 l Expand entry
191 L Expand all entries
193 h Collapse entry
195 H Collapse all entries
197 space, Return
199 Select and open entry
200 Mouse bindings
202 Scroll Scroll up or down
204 ^Scroll
206 Zoom in or out
207 Hold Button2
209 Pan the document
210 Button1
212 Follow link
213
215 bmark Save a bookmark
216 bdelete
218 Delete a bookmark
219 blist List bookmarks
221 close Close document
223 exec Execute an external command
225 info Show document information
227 open Open a document
229 offset Set page offset
231 print Print document
233 write(!)
235 Save document (and force overwriting)
236 export Export attachments
238 dump Write values, descriptions, etc. of all current settings to a
240 file.
241
243 The default appearance and behaviour of zathura can be overwritten by
244 modifying the zathurarc file (default path: ~/.config/zathura/zathu‐
245 rarc). For a detailed description please consult zathurarc(5).
246
248 Both synctex forward and backwards synchronization are supported by
249 zathura, To enable synctex forward synchronization, please look at the
250 --synctex-forward and --synctex-editor options. zathura will also emit
251 a signal via the D-Bus interface. To support synctex backwards synchro‐
252 nization, zathura provides a D-Bus interface that can be called by the
253 editor. For convince zathura also knows how to parse the output of the
254 synctex view command. It is enough to pass the arguments to synctex
255 view's -i option to zathura via --synctex-forward and zathura will pass
256 the information to the correct instance.
257 For gvim forward and backwards synchronization support can be set up as
259 follows: First add the following to the vim configuration:
260 function! Synctex()
262 execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
263 redraw!
264 endfunction
265 map <C-enter> :call Synctex()<cr>
266 Then launch zathura with
268 zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
270 Some editors support zathura as viewer out of the box:
272 · LaTeXTools for SublimeText (‐
274 https://latextools.readthedocs.io/en/latest/available-view‐
275 ers/#zathura)
276 · LaTeX for Atom (https://atom.io/packages/latex)
278
280 ZATHURA_PLUGINS_PATH
281 Path to the directory containing plugins. This directory is only
282 considered if no other directory was specified using --plug‐
283 ins-dir.
284
286 If GDK_NATIVE_WINDOWS is enabled you will experience problems with
287 large documents. In this case zathura might crash or pages cannot be
288 rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The
289 same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.
290
292 zathurarc(5)
293
295 pwmt.org
296
298 2009-2020, pwmt.org
2990.4.5 2020-01-06 ZATHURA(1)