Krolyxon
Commit 72ced4b

Branches

Refs →

nsxivsxiv.1

202 lines · 4.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 [ \-adFfhpqrstvZ ]
7.RB [ \-g
8.IR GEOMETRY ]
9.RB [ \-z
10.IR ZOOM ]
11.IR FILE ...
12.SH DESCRIPTION
13sxiv is a simple image viewer for X. It only has the most basic features
14required for fast image viewing.
15.P
16sxiv opens all named
17.IR FILE s,
18or reads the names of the files to open from standard input, if only a single
19hyphen\-minus
20.RB ( \- )
21is given.
22.P
23sxiv has two modes of operation: image and thumbnail mode. The default is image
24mode, in which only the current image is shown. In thumbnail mode a grid of
25small previews is displayed, making it easy to choose an image to open.
26.P
27Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
28manager.
29.SH OPTIONS
30.TP
31.B \-a
32Display all given files, do not filter out unsupported files. This might result
33in a much shorter startup time, when the file list is very long or contains
34large files of slow loadable types, e.g. gif and progressive jpg.
35.TP
36.B \-d
37Scale all images to 100%, but fit large images into window.
38.TP
39.B \-F
40Make the window fixed/floating by setting the minimum and maximum width/height
41size-hints to the window width/height.
42.TP
43.B \-f
44Start in fullscreen mode.
45.TP
46.BI "\-g " GEOMETRY
47Set window position and size. See section GEOMETRY SPECIFICATIONS of X(7) for
48more information on
49.IR GEOMETRY .
50.TP
51.B \-h
52Print brief usage information to standard output and exit.
53.TP
54.B \-p
55Pixelize images, i.e. turn off anti-aliasing.
56.TP
57.B \-q
58Be quiet, disable warnings to standard error stream.
59.TP
60.B \-r
61Search the given directories recursively for images to view.
62.TP
63.B \-s
64Scale all images to fit into window.
65.TP
66.B \-t
67Start in thumbnail mode.
68.TP
69.B \-v
70Print version information to standard output and exit.
71.TP
72.B \-Z
73The same as `-z 100'.
74.TP
75.BI "\-z " ZOOM
76Scale all images to the current zoom level, use a zoom level of
77.I ZOOM
78at startup.
79.SH KEYBOARD COMMANDS
80.SS General
81.TP
82.B q
83Quit sxiv.
84.TP
85.B Return
86Switch to thumbnail mode; in thumbnail mode: open selected image.
87.SS Navigate image list
88.TP
89.BR n ", " Space
90Go to the next image.
91.TP
92.BR p ", " Backspace
93Go to the previous image.
94.TP
95.B g
96Go to the first image.
97.TP
98.B G
99Go to the last image.
100.TP
101.B [
102Go 10 images backward.
103.TP
104.B ]
105Go 10 images forward.
106.SS Zooming
107.TP
108.BR + ", " =
109Zoom in.
110.TP
111.B \-
112Zoom out.
113.TP
114.B 0
115Set zoom level to 100%.
116.TP
117.B w
118Set zoom level to fit image into window.
119.SS Panning/Moving
120.TP
121.BR h ", " Left
122Pan image left; in thumbnail mode: move selection left.
123.TP
124.BR j ", " Down
125Pan image down; in thumbnail mode: move selection down.
126.TP
127.BR k ", " Up
128Pan image up; in thumbnail mode: move selection up.
129.TP
130.BR l ", " Right
131Pan image right; in thumbnail mode: move selection right.
132.SS Rotation
133.TP
134.B <
135Rotate image counter-clockwise by 90 degrees.
136.TP
137.B >
138Rotate image clockwise by 90 degrees.
139.SS Control window
140.TP
141.B W
142Resize window to fit image.
143.TP
144.B f
145Toggle fullscreen mode.
146.SS Miscellaneous
147.TP
148.B a
149Toggle anti-aliasing.
150.TP
151.B A
152Toggle visibility of alpha-channel, i.e. image transparency.
153.TP
154.B r
155Reload image.
156.TP
157.B D
158Remove image from file list and go to next image; in thumbnail mode: remove
159selected image from file list and select next image.
160.SH MOUSE COMMANDS
161.SS Navigate image list
162.TP
163.B Button1
164Go to the next image; in thumbnail mode: select/open image.
165.TP
166.B Button3
167Go to the previous image.
168.SS Zooming
169.TP
170.B Ctrl+ScrollUp
171Zoom in.
172.TP
173.B Ctrl+ScrollDown
174Zoom out.
175.SS Panning/Moving
176.TP
177.B Button2
178Drag the image with the mouse while keeping this button pressed down.
179.TP
180.B ScrollUp
181Pan image up; in thumbnail mode: Scroll one row up.
182.TP
183.B ScrollDown
184Pan image down; in thumbnail mode: Scroll one row down.
185.TP
186.B Shift+ScrollUp
187Pan image left.
188.TP
189.B Shift+ScrollDown
190Pan image right.
191.SH AUTHORS
192.EX
193Bert Muennich <ber.t at gmx.com>
194Dave Reisner <d at falconindy.com>
195Fung SzeTat <sthorde at gmail.com>
196.EE
197.SH HOMEPAGE
198.TP
199http://github.com/muennich/sxiv
200.SH SEE ALSO
201.BR feh (1),
202.BR qiv (1)