1SXIV(1) General Commands Manual SXIV(1)
2
6 sxiv - Simple X Image Viewer
7
9 sxiv [-abcfhiopqrtvZ] [-A FRAMERATE] [-e WID] [-G GAMMA] [-g GEOMETRY]
10 [-N NAME] [-n NUM] [-S DELAY] [-s MODE] [-z ZOOM] FILE...
11
13 sxiv is a simple image viewer for X.
14 It has two modes of operation: image and thumbnail mode. The default is
16 image mode, in which only the current image is shown. In thumbnail mode
17 a grid of small previews is displayed, making it easy to choose an
18 image to open.
19 Please note, that the fullscreen mode requires an EWMH/NetWM compliant
21 window manager.
22
24 -A FRAMERATE
25 Play animations with a constant frame rate set to FRAMERATE.
26 -a Play animations of multi-frame images.
28 -b Do not show info bar on bottom of window.
30 -c Remove all orphaned cache files from the thumbnail cache direc‐
32 tory and exit.
33 -e WID Embed sxiv's window into window whose ID is WID.
35 -f Start in fullscreen mode.
37 -G GAMMA
39 Set image gamma to GAMMA (-32..32).
40 -g GEOMETRY
42 Set window position and size. See section GEOMETRY SPECIFICA‐
43 TIONS of X(7) for more information on GEOMETRY argument.
44 -N NAME
46 Set the resource name of sxiv's X window to NAME.
47 -n NUM Start at picture number NUM.
49 -h Print brief usage information to standard output and exit.
51 -i Read names of files to open from standard input. Also done if
53 FILE is `-'.
54 -o Write list of all marked files to standard output when quitting.
56 In combination with -i sxiv can be used as a visual filter/pipe.
57 -p Enable private mode, in which sxiv does not write any cache or
59 temporary files.
60 -q Be quiet, disable warnings to standard error stream.
62 -r Search the given directories recursively for images to view.
64 -S DELAY
66 Start in slideshow mode. Set the delay between images to DELAY
67 seconds. DELAY may be a floating point number.
68 -s MODE
70 Set scale mode according to MODE character. Supported modes are:
71 [d]own, [f]it, [w]idth, [h]eight.
72 -t Start in thumbnail mode.
74 -v Print version information to standard output and exit.
76 -Z The same as `-z 100'.
78 -z ZOOM
80 Set zoom level to ZOOM percent.
81
83 General
84 The following keyboard commands are available in both image and thumb‐
85 nail mode:
86 0-9 Prefix the next command with a number (denoted via count).
88 q Quit sxiv.
90 Return Switch to thumbnail mode / open selected image in image mode.
92 f Toggle fullscreen mode.
94 b Toggle visibility of info bar on bottom of window.
96 Ctrl-x Send the next key to the external key-handler. See section
98 EXTERNAL KEY HANDLER for more information.
99 g Go to the first image.
101 G Go to the last image, or image number count.
103 r Reload image.
105 D Remove current image from file list and go to next image.
107 Ctrl-h, Ctrl-Left
109 Scroll left one screen width.
110 Ctrl-j, Ctrl-Down
112 Scroll down one screen height.
113 Ctrl-k, Ctrl-Up
115 Scroll up one screen height.
116 Ctrl-l, Ctrl-Right
118 Scroll right one screen width.
119 + Zoom in.
121 - Zoom out.
123 m Mark/unmark the current image.
125 M Reverse all image marks.
127 Ctrl-M Repeat last mark action on all images from the last
129 marked/unmarked up to the current one.
130 Ctrl-m Remove all image marks.
132 N Go count marked images forward.
134 P Go count marked images backward.
136 { Decrease gamma correction by count steps.
138 } Increase gamma correction by count steps.
140 Ctrl-g Reset gamma correction.
142 Thumbnail mode
144 The following keyboard commands are only available in thumbnail mode:
145 h, Left
147 Move selection left count times.
148 j, Down
150 Move selection down count times.
151 k, Up Move selection up count times.
153 l, Right
155 Move selection right count times.
156 R Reload all thumbnails.
158 Image mode
160 The following keyboard commands are only available in image mode:
161 Navigate image list:
163 n, Space
165 Go count images forward.
166 p, Backspace
168 Go count images backward.
169 [ Go count * 10 images backward.
171 ] Go count * 10 images forward.
173 Handle multi-frame images:
175 Ctrl-n Go count frames of a multi-frame image forward.
177 Ctrl-p Go count frames of a multi-frame image backward.
179 Ctrl-Space
181 Play/stop animations of multi-frame images.
182 Panning:
184 h, Left
186 Scroll image 1/5 of window width or count pixel left.
187 j, Down
189 Scroll image 1/5 of window height or count pixel down.
190 k, Up Scroll image 1/5 of window height or count pixel up.
192 l, Right
194 Scroll image 1/5 of window width or count pixel right.
195 H Scroll to left image edge.
197 J Scroll to bottom image edge.
199 K Scroll to top image edge.
201 L Scroll to right image edge.
203 Zooming:
205 = Set zoom level to 100%, or count%.
207 w Set zoom level to 100%, but fit large images into window.
209 W Fit image to window.
211 e Fit image to window width.
213 E Fit image to window height.
215 Rotation:
217 < Rotate image counter-clockwise by 90 degrees.
219 > Rotate image clockwise by 90 degrees.
221 ? Rotate image by 180 degrees.
223 Flipping:
225 | Flip image horizontally.
227 _ Flip image vertically.
229 Miscellaneous:
231 a Toggle anti-aliasing.
233 A Toggle visibility of alpha-channel, i.e. image transparency.
235 s Toggle slideshow mode and/or set the delay between images to
237 count seconds.
238
240 The following mouse mappings are available in image mode:
241 General:
243 Button3
245 Switch to thumbnail mode.
246 Navigate image list:
248 Button1
250 Go to the next image if the mouse cursor is in the right part of
251 the window or to the previous image if it is in the left part.
252 Panning:
254 Button2
256 Pan the image according to the mouse cursor position in the win‐
257 dow while keeping this button pressed down.
258 Zooming:
260 ScrollUp
262 Zoom in.
263 ScrollDown
265 Zoom out.
266
268 The information displayed on the left side of the status bar can be
269 replaced with the output of a user-provided script, which is called by
270 sxiv whenever an image gets loaded. The path of this script is
271 $XDG_CONFIG_HOME/sxiv/exec/image-info and the arguments given to it
272 are: 1) path to image file, 2) image width, 3) image height.
273 There is also an example script installed together with sxiv as
275 /usr/share/sxiv/exec/image-info.
276
278 Additional external keyboard commands can be defined using a handler
279 program located in $XDG_CONFIG_HOME/sxiv/exec/key-handler. The handler
280 is invoked by pressing Ctrl-x. The next key combo is passed as its
281 first argument. Passed via stdin are the images to act upon, one path
282 per line: all marked images, if in thumbnail mode and at least one
283 image has been marked, otherwise the current image. sxiv(1) will block
284 until the handler terminates. It then checks which images have been
285 modified and reloads them.
286 The key combo argument has the following form: "[C-][M-][S-]KEY", where
288 C/M/S indicate Ctrl/Meta(Alt)/Shift modifier states and KEY is the X
289 keysym as listed in /usr/include/X11/keysymdef.h without the "XK_" pre‐
290 fix.
291 There is also an example script installed together with sxiv as
293 /usr/share/sxiv/exec/key-handler.
294
296 sxiv stores all thumbnails under $XDG_CACHE_HOME/sxiv/.
297 Use the command line option -c to remove all orphaned cache files.
299 Additionally, run the following command afterwards inside the cache
300 directory to remove empty subdirectories:
301 find . -depth -type d -empty ! -name '.' -exec rmdir {} \;
303
305 Bert Muennich <ber.t at posteo.de>
306
308 Bastien Dejean <nihilhill at gmail.com>
309 Dave Reisner <d at falconindy.com>
310 Fung SzeTat <sthorde at gmail.com>
311 Max Voit <mvdev at with-eyes.net>
312
314 https://github.com/muennich/sxiv
315
317 feh(1), qiv(1)
318 sxiv-25 SXIV(1)