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] <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       -l,--log-level=level
42              Set log level (debug, info, warning, error)
43
44       -x,--synctex-editor-command=command
45              Set  the  synctex  editor  command.  Overrides  the synctex-edi‐
46              tor-command setting.
47
48       --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
54       --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
60       --fork Fork into background
61
62       --version
63              Display version string and exit
64
65       --help Display help and exit
66

ENVIRONMENT VARIABLES

68       ZATHURA_PLUGINS_PATH
69              Path to the directory containing plugins. This directory is only
70              considered  if  no  other  directory was specified using --plug‐
71              ins-dir.
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          H, L   Goto top or bottom of the current page
98
99          ^o, ^i Move backward and forward through the jump list
100
101          ^j, ^k Bisect forward and backward between the last two jump points
102
103          ^c, Escape
104                 Abort
105
106          a, s   Adjust window in best-fit or width mode
107
108          /, ?   Search for text
109
110          n, N   Search for the next or previous result
111
112          o, O   Open document
113
114          f      Follow links
115
116          F      Display link target
117
118          :      Enter command
119
120          r      Rotate by 90 degrees
121
122          ^r     Recolor (grayscale and invert colors)
123
124          R      Reload document
125
126          Tab    Show index and switch to Index mode
127
128          d      Toggle dual page view
129
130          F5     Switch to presentation mode
131
132          F11    Switch to fullscreen mode
133
134          ^m     Toggle inputbar
135
136          ^n     Toggle statusbar
137
138          +, -, =
139                 Zoom in, out or to the original size
140
141          zI, zO, z0
142                 Zoom in, out or to the original size
143
144          n=     Zoom to size n
145
146          mX     Set a quickmark to a letter or number X
147
148          'X     Goto quickmark saved at letter or number X
149
150          q      Quit
151
152       Fullscreen mode
153
154          J, K   Go to the next or previous page
155
156          space, <S-space>, <BackSpace>
157                 Scroll a full page down or up
158
159          gg, G, nG
160                 Goto to the first, the last or to the nth page
161
162          ^c, Escape
163                 Abort
164
165          F11    Switch to normal mode
166
167          +, -, =
168                 Zoom in, out or to the original size
169
170          zI, zO, z0
171                 Zoom in, out or to the original size
172
173          n=     Zoom to size n
174
175          q      Quit
176
177       Presentation mode
178
179          space, <S-space>, <BackSpace>
180                 Scroll a full page down or up
181
182          ^c, Escape
183                 Abort
184
185          F5     Switch to normal mode
186
187          q      Quit
188
189       Index mode
190
191          k, j   Move to upper or lower entry
192
193          l      Expand entry
194
195          L      Expand all entries
196
197          h      Collapse entry
198
199          H      Collapse all entries
200
201          space, Return
202                 Select and open entry
203
204       Mouse bindings
205
206          Scroll Scroll up or down
207
208          ^Scroll
209                 Zoom in or out
210
211          Hold Button2
212                 Pan the document
213
214          Button1
215                 Follow link
216

COMMANDS

218       bmark  Save a bookmark
219
220       bdelete
221              Delete a bookmark
222
223       blist  List bookmarks
224
225       close  Close document
226
227       exec   Execute an external command
228
229       info   Show document information
230
231       open   Open a document
232
233       offset Set page offset
234
235       print  Print document
236
237       write(!)
238              Save document (and force overwriting)
239
240       export Export attachments
241
242       dump   Write values, descriptions, etc. of all current  settings  to  a
243              file.
244

CONFIGURATION

246       The  default  appearance and behaviour of zathura can be overwritten by
247       modifying the zathurarc file  (default  path:  ~/.config/zathura/zathu‐
248       rarc). For a detailed description please consult zathurarc(5).
249

SYNCTEX SUPPORT

251       Both  synctex  forward  and  backwards synchronization are supported by
252       zathura, To enable synctex forward synchronization, please look at  the
253       --synctex-forward  and --synctex-editor options. zathura will also emit
254       a signal via the D-Bus interface. To support synctex backwards synchro‐
255       nization,  zathura provides a D-Bus interface that can be called by the
256       editor. For convince zathura also knows how to parse the output of  the
257       synctex  view  command.  It  is enough to pass the arguments to synctex
258       view's -i option to zathura via --synctex-forward and zathura will pass
259       the information to the correct instance.
260
261       For gvim forward and backwards synchronization support can be set up as
262       follows: First add the following to the vim configuration:
263
264          function! Synctex()
265            execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
266            redraw!
267          endfunction
268          map <C-enter> :call Synctex()<cr>
269
270       Then launch zathura with
271
272          zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
273
274       Some editors support zathura as viewer out of the box:
275
276       · LaTeXTools              for              SublimeText               (‐
277         https://latextools.readthedocs.io/en/latest/available-view
278         ers/#zathura)
279
280       · LaTeX for Atom (https://atom.io/packages/latex)
281

KNOWN BUGS

283       If GDK_NATIVE_WINDOWS is enabled  you  will  experience  problems  with
284       large  documents.  In  this case zathura might crash or pages cannot be
285       rendered properly. Disabling GDK_NATIVE_WINDOWS fixes this  issue.  The
286       same issue may appear, if overlay-scrollbar is enabled in GTK_MODULES.
287

SEE ALSO

289       zathurarc(5)
290

AUTHOR

292       pwmt.org
293
295       2009-2018, pwmt.org
296
297
298
299
3000.4.3                             2018-12-22                        ZATHURA(1)
Impressum