1ZATHURA(1)                          zathura                         ZATHURA(1)
2
3
4

NAME

6       zathura - a document viewer
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

19       -e,--reparent=xid
20              Reparents to window specified by xid
21
22       -c,--config-dir=path
23              Path to the config directory
24
25       -d,--data-dir=path
26              Path to the data directory
27
28       -p,--plugins-dir=path
29              Path to the directory containing plugins
30
31       -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
36       -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
41       -f,--find=string
42              Opens the document and searches for the given string.
43
44       -l,--log-level=level
45              Set log level (debug, info, warning, error)
46
47       -x,--synctex-editor-command=command
48              Set  the  synctex  editor  command.  Overrides  the synctex-edi‐
49              tor-command setting.
50
51       --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
57       --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
63       --mode=mode
64              Start in a non-default mode
65
66       --fork Fork into background
67
68       --version
69              Display version string and exit
70
71       --help Display help and exit
72

MOUSE AND KEY BINDINGS

74       General
75
76          J, PgDn
77                 Go to the next page
78
79          K, PgUp
80                 Go to the previous page
81
82          h, k, j, l
83                 Scroll to the left, down, up or right direction
84
85          Left, Down, Up, Right
86                 Scroll to the left, down, up or right direction
87
88          ^t, ^d, ^u, ^y
89                 Scroll a half page left, down, up or right
90
91          t, ^f, ^b, space, <S-space>, y
92                 Scroll a full page left, down, up or right
93
94          gg, G, nG
95                 Goto to the first, the last or to the nth page
96
97          P      Snaps to the current page
98
99          H, L   Goto top or bottom of the current page
100
101          ^o, ^i Move backward and forward through the jump list
102
103          ^j, ^k Bisect forward and backward between the last two jump points
104
105          ^c, Escape
106                 Abort
107
108          a, s   Adjust window in best-fit or width mode
109
110          /, ?   Search for text
111
112          n, N   Search for the next or previous result
113
114          o, O   Open document
115
116          f      Follow links
117
118          F      Display link target
119
120          c      Copy link target into the clipboard
121
122          :      Enter command
123
124          r      Rotate by 90 degrees
125
126          ^r     Recolor (grayscale and invert colors)
127
128          R      Reload document
129
130          Tab    Show index and switch to Index mode
131
132          d      Toggle dual page view
133
134          F5     Switch to presentation mode
135
136          F11    Switch to fullscreen mode
137
138          ^m     Toggle inputbar
139
140          ^n     Toggle statusbar
141
142          +, -, =
143                 Zoom in, out or to the original size
144
145          zI, zO, z0
146                 Zoom in, out or to the original size
147
148          n=     Zoom to size n
149
150          mX     Set a quickmark to a letter or number X
151
152          'X     Goto quickmark saved at letter or number X
153
154          q      Quit
155
156       Fullscreen mode
157
158          J, K   Go to the next or previous page
159
160          space, <S-space>, <BackSpace>
161                 Scroll a full page down or up
162
163          gg, G, nG
164                 Goto to the first, the last or to the nth page
165
166          ^c, Escape
167                 Abort
168
169          F11    Switch to normal mode
170
171          +, -, =
172                 Zoom in, out or to the original size
173
174          zI, zO, z0
175                 Zoom in, out or to the original size
176
177          n=     Zoom to size n
178
179          q      Quit
180
181       Presentation mode
182
183          space, <S-space>, <BackSpace>
184                 Scroll a full page down or up
185
186          ^c, Escape
187                 Abort
188
189          F5     Switch to normal mode
190
191          q      Quit
192
193       Index mode
194
195          k, j   Move to upper or lower entry
196
197          l      Expand entry
198
199          L      Expand all entries
200
201          h      Collapse entry
202
203          H      Collapse all entries
204
205          space, Return
206                 Select and open entry
207
208       Mouse bindings
209
210          Scroll Scroll up or down
211
212          ^Scroll
213                 Zoom in or out
214
215          Hold Button2
216                 Pan the document
217
218          Button1
219                 Follow link
220

COMMANDS

222       bmark  Save a bookmark
223
224       bdelete
225              Delete a bookmark
226
227       blist  List bookmarks
228
229       close  Close document
230
231       exec   Execute an external command. $FILE expands to the current  docu‐
232              ment path, and $PAGE to the current page number
233
234       info   Show document information
235
236       open   Open a document
237
238       offset Set page offset
239
240       print  Print document
241
242       write(!)
243              Save document (and force overwriting)
244
245       export Export attachments
246
247       dump   Write  values,  descriptions,  etc. of all current settings to a
248              file.
249

CONFIGURATION

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

SYNCTEX SUPPORT

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
266       For gvim forward and backwards synchronization support can be set up as
267       follows: First add the following to the vim configuration:
268
269          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
275       Then launch zathura with
276
277          zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
278
279       Some editors support zathura as viewer out of the box:
280
281       • LaTeXTools               for              SublimeText              (‐
282         https://latextools.readthedocs.io/en/latest/available-viewers/#za‐
283         thura)
284
285       • LaTeX for Atom (https://atom.io/packages/latex)
286

ENVIRONMENT VARIABLES

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

KNOWN BUGS

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

SEE ALSO

300       zathurarc(5)
301

AUTHOR

303       pwmt.org
304
306       2009-2023, pwmt.org
307
308
309
310
3110.5.2                             2022-11-27                        ZATHURA(1)
Impressum