Krolyxon
Commit 5c77e1a

Branches

Refs →

nsxivsxiv.1

252 lines · 5.0 KB · Groff/troff

Raw Blame History Download
1.TH SXIV 1 sxiv\-VERSION
2.SH NAME
3sxiv \- Simple (or small or suckless) X Image Viewer
4.SH SYNOPSIS
5.B sxiv
6.RB [ \-cdFfhpqrstvZ ]
7.RB [ \-g
8.IR GEOMETRY ]
9.RB [ \-n
10.IR NUM ]
11.RB [ \-z
12.IR ZOOM ]
13.IR FILE ...
14.SH DESCRIPTION
15sxiv is a simple image viewer for X. It only has the most basic features
16required for fast image viewing.
17.P
18sxiv opens all named
19.IR FILE s,
20or reads the names of the files to open from standard input, if only a single
21hyphen\-minus
22.RB ( \- )
23is given.
24.P
25sxiv has two modes of operation: image and thumbnail mode. The default is image
26mode, in which only the current image is shown. In thumbnail mode a grid of
27small previews is displayed, making it easy to choose an image to open.
28.P
29sxiv can also cache its thumbnails. Please see the section THUMBNAIL CACHING
30for information on how to enable this feature.
31.P
32Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
33manager.
34.SH OPTIONS
35.TP
36.B \-c
37Remove all orphaned cache files from the thumbnail cache directory and exit.
38.TP
39.B \-d
40Scale all images to 100%, but fit large images into window.
41.TP
42.B \-F
43Make the window fixed/floating by setting the minimum and maximum width/height
44size-hints to the window width/height.
45.TP
46.B \-f
47Start in fullscreen mode.
48.TP
49.BI "\-g " GEOMETRY
50Set window position and size. See section GEOMETRY SPECIFICATIONS of X(7) for
51more information on
52.IR GEOMETRY .
53.TP
54.BI "\-n " NUM
55Start at picture number NUM.
56.TP
57.B \-h
58Print brief usage information to standard output and exit.
59.TP
60.B \-p
61Pixelize images, i.e. turn off anti-aliasing.
62.TP
63.B \-q
64Be quiet, disable warnings to standard error stream.
65.TP
66.B \-r
67Search the given directories recursively for images to view.
68.TP
69.B \-s
70Scale all images to fit into window.
71.TP
72.B \-t
73Start in thumbnail mode.
74.TP
75.B \-v
76Print version information to standard output and exit.
77.TP
78.B \-Z
79The same as `\-z 100'.
80.TP
81.BI "\-z " ZOOM
82Scale all images to the current zoom level, use a zoom level of
83.I ZOOM
84at startup.
85.SH KEYBOARD COMMANDS
86The differences of the following key mappings between image view and thumbnail
87mode are denoted via brackets.
88.SS General
89.TP
90.B q
91Quit sxiv.
92.TP
93.B Return
94Switch to thumbnail mode [open selected image].
95.SS Navigate image list
96.TP
97.BR n ", " Space
98Go to the next image.
99.TP
100.BR p ", " Backspace
101Go to the previous image.
102.TP
103.B g
104Go to [select] the first image.
105.TP
106.B G
107Go to [select] the last image.
108.TP
109.B [
110Go 10 images backward.
111.TP
112.B ]
113Go 10 images forward.
114.SS Zooming
115.TP
116.BR + ", " =
117Zoom in.
118.TP
119.B \-
120Zoom out.
121.TP
122.B 0
123Set zoom level to 100%.
124.TP
125.B w
126Set zoom level to fit image into window.
127.SS Panning/Moving
128.TP
129.BR h ", " Left
130Pan image [move selection] left.
131.TP
132.BR j ", " Down
133Pan image [move selection] down.
134.TP
135.BR k ", " Up
136Pan image [move selection] up.
137.TP
138.BR l ", " Right
139Pan image [move selection] right.
140.TP
141.B H
142Pan to left image edge.
143.TP
144.B J
145Pan to bottom image edge.
146.TP
147.B K
148Pan to top image edge.
149.TP
150.B L
151Pan to right image edge.
152.TP
153.BR Ctrl-h ", " Ctrl-Left
154Pan image one window width left.
155.TP
156.BR Ctrl-j ", " Ctrl-Down
157Pan image one window height down.
158.TP
159.BR Ctrl-k ", " Ctrl-Up
160Pan image one window height up.
161.TP
162.BR Ctrl-l ", " Ctrl-Right
163Pan image one window width right.
164.SS Rotation
165.TP
166.B <
167Rotate image counter-clockwise by 90 degrees.
168.TP
169.B >
170Rotate image clockwise by 90 degrees.
171.SS Control window
172.TP
173.B W
174Resize window to fit image.
175.TP
176.B f
177Toggle fullscreen mode.
178.SS Miscellaneous
179.TP
180.B a
181Toggle anti-aliasing.
182.TP
183.B A
184Toggle visibility of alpha-channel, i.e. image transparency.
185.TP
186.B D
187Remove current [selected] image from file list and go to [select] next image.
188.TP
189.B r
190Reload image.
191.SH MOUSE COMMANDS
192The differences of the following mouse mappings between image view and
193thumbnail mode are denoted via brackets.
194.SS Navigate image list
195.TP
196.B Button1
197Go to [select/open] next image.
198.TP
199.B Button3
200Go to the previous image.
201.SS Zooming
202.TP
203.B Ctrl+ScrollUp
204Zoom in.
205.TP
206.B Ctrl+ScrollDown
207Zoom out.
208.SS Panning/Moving
209.TP
210.B Button2
211Drag the image with the mouse while keeping this button pressed down.
212.TP
213.B ScrollUp
214Pan image up [scroll up one thumbnail row].
215.TP
216.B ScrollDown
217Pan image down [scroll down one thumbnail row].
218.TP
219.B Shift+ScrollUp
220Pan image left.
221.TP
222.B Shift+ScrollDown
223Pan image right.
224.SH THUMBNAIL CACHING
225To enable thumbnail caching, please make sure to create the directory
226.I ~/.sxiv/
227with write permissions. sxiv will then store all thumbnails inside this
228directory, but it will not create this directory by itself. It rather uses the
229existance of this directory as an affirmation, that the user wants thumbnails
230to be cached.
231.P
232Use the command line option
233.I \-c
234to keep the cache directory clean by removing all orphaned cache files.
235Additionally, run the following command afterwards inside the cache directory
236to remove empty subdirectories:
237.P
238.RS
239find \-type d \-empty \-delete
240.RE
241.SH AUTHORS
242.EX
243Bert Muennich <ber.t at gmx.com>
244Dave Reisner <d at falconindy.com>
245Fung SzeTat <sthorde at gmail.com>
246.EE
247.SH HOMEPAGE
248.TP
249http://github.com/muennich/sxiv
250.SH SEE ALSO
251.BR feh (1),
252.BR qiv (1)