sxiv(1) - f14

1SXIV(1)                     General Commands Manual                    SXIV(1)
2
3
4

NAME

6       sxiv - Simple (or small or suckless) X Image Viewer
7

SYNOPSIS

9       sxiv [-cdFfhpqrstvZ] [-g GEOMETRY] [-z ZOOM] FILE...
10

DESCRIPTION

12       sxiv  is  a  simple image viewer for X. It only has the most basic fea‐
13       tures required for fast image viewing.
14
15       sxiv opens all named FILEs, or reads the names of  the  files  to  open
16       from standard input, if only a single hyphen-minus (-) is given.
17
18       sxiv  has two modes of operation: image and thumbnail mode. The default
19       is image mode, in which only the current image is shown.  In  thumbnail
20       mode a grid of small previews is displayed, making it easy to choose an
21       image to open.
22
23       sxiv can also cache its thumbnails. Please see  the  section  THUMBNAIL
24       CACHING for information on how to enable this feature.
25
26       Please  note, that the fullscreen mode requires an EWMH/NetWM compliant
27       window manager.
28

OPTIONS

30       -c     Remove all orphaned cache files from the thumbnail cache  direc‐
31              tory and exit.
32
33       -d     Scale all images to 100%, but fit large images into window.
34
35       -F     Make  the window fixed/floating by setting the minimum and maxi‐
36              mum width/height size-hints to the window width/height.
37
38       -f     Start in fullscreen mode.
39
40       -g GEOMETRY
41              Set window position and size. See  section  GEOMETRY  SPECIFICA‐
42              TIONS of X(7) for more information on GEOMETRY.
43
44       -h     Print brief usage information to standard output and exit.
45
46       -p     Pixelize images, i.e. turn off anti-aliasing.
47
48       -q     Be quiet, disable warnings to standard error stream.
49
50       -r     Search the given directories recursively for images to view.
51
52       -s     Scale all images to fit into window.
53
54       -t     Start in thumbnail mode.
55
56       -v     Print version information to standard output and exit.
57
58       -Z     The same as `-z 100'.
59
60       -z ZOOM
61              Scale  all images to the current zoom level, use a zoom level of
62              ZOOM at startup.
63

KEYBOARD COMMANDS

65       The differences of the following key mappings between  image  view  and
66       thumbnail mode are denoted via brackets.
67
68   General
69       q      Quit sxiv.
70
71       Return Switch to thumbnail mode [open selected image].
72
73   Navigate image list
74       n, Space
75              Go to the next image.
76
77       p, Backspace
78              Go to the previous image.
79
80       g      Go to [select] the first image.
81
82       G      Go to [select] the last image.
83
84       [      Go 10 images backward.
85
86       ]      Go 10 images forward.
87
88   Zooming
89       +, =   Zoom in.
90
91       -      Zoom out.
92
93       0      Set zoom level to 100%.
94
95       w      Set zoom level to fit image into window.
96
97   Panning/Moving
98       h, Left
99              Pan image [move selection] left.
100
101       j, Down
102              Pan image [move selection] down.
103
104       k, Up  Pan image [move selection] up.
105
106       l, Right
107              Pan image [move selection] right.
108
109   Rotation
110       <      Rotate image counter-clockwise by 90 degrees.
111
112       >      Rotate image clockwise by 90 degrees.
113
114   Control window
115       W      Resize window to fit image.
116
117       f      Toggle fullscreen mode.
118
119   Miscellaneous
120       a      Toggle anti-aliasing.
121
122       A      Toggle visibility of alpha-channel, i.e. image transparency.
123
124       D      Remove  current  [selected]  image  from  file  list  and  go to
125              [select] next image.
126
127       r      Reload image.
128

MOUSE COMMANDS

130       The differences of the following mouse mappings between image view  and
131       thumbnail mode are denoted via brackets.
132
133   Navigate image list
134       Button1
135              Go to [select/open] next image.
136
137       Button3
138              Go to the previous image.
139
140   Zooming
141       Ctrl+ScrollUp
142              Zoom in.
143
144       Ctrl+ScrollDown
145              Zoom out.
146
147   Panning/Moving
148       Button2
149              Drag  the image with the mouse while keeping this button pressed
150              down.
151
152       ScrollUp
153              Pan image up [scroll up one thumbnail row].
154
155       ScrollDown
156              Pan image down [scroll down one thumbnail row].
157
158       Shift+ScrollUp
159              Pan image left.
160
161       Shift+ScrollDown
162              Pan image right.
163

THUMBNAIL CACHING

165       To enable thumbnail caching, please make sure to create  the  directory
166       ~/.sxiv/  with  write  permissions. sxiv will then store all thumbnails
167       inside this directory, but it will not create this directory by itself.
168       It  rather uses the existance of this directory as an affirmation, that
169       the user wants thumbnails to be cached.
170
171       Use the command line option -c to keep the  cache  directory  clean  by
172       removing  all  orphaned  cache  files.  Additionally, run the following
173       command afterwards inside the cache directory to remove empty subdirec‐
174       tories:
175
176              find -type d -empty -delete
177

AUTHORS

179       Bert Muennich <ber.t at gmx.com>
180       Dave Reisner  <d at falconindy.com>
181       Fung SzeTat   <sthorde at gmail.com>
182

HOMEPAGE

184       http://github.com/muennich/sxiv
185