Krolyxon
Commit facd7e3

Branches

Refs →

nsxivsxiv.1

201 lines · 3.9 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 Escape
86Quit sxiv and return an exit value of 2.
87.TP
88.B Return
89Switch to thumbnail mode; in thumbnail mode: open selected image.
90.SS Navigate image list
91.TP
92.BR n ", " Space
93Go to the next image.
94.TP
95.BR p ", " Backspace
96Go to the previous image.
97.TP
98.B g
99Go to the first image.
100.TP
101.B G
102Go to the last image.
103.TP
104.B [
105Go 10 images backward.
106.TP
107.B ]
108Go 10 images forward.
109.SS Zooming
110.TP
111.BR + ", " =
112Zoom in.
113.TP
114.B \-
115Zoom out.
116.TP
117.B 0
118Set zoom level to 100%.
119.TP
120.B w
121Set zoom level to fit image into window.
122.SS Panning/Moving
123.TP
124.BR h ", " Left
125Pan image left; in thumbnail mode: move selection left.
126.TP
127.BR j ", " Down
128Pan image down; in thumbnail mode: move selection down.
129.TP
130.BR k ", " Up
131Pan image up; in thumbnail mode: move selection up.
132.TP
133.BR l ", " Right
134Pan image right; in thumbnail mode: move selection right.
135.SS Rotation
136.TP
137.B <
138Rotate image counter-clockwise by 90 degrees.
139.TP
140.B >
141Rotate image clockwise by 90 degrees.
142.SS Control window
143.TP
144.B W
145Resize window to fit image.
146.TP
147.B f
148Toggle fullscreen mode.
149.SS Miscellaneous
150.TP
151.B a
152Toggle anti-aliasing.
153.TP
154.B A
155Toggle visibility of alpha-channel, i.e. image transparency.
156.TP
157.B r
158Reload image.
159.SH MOUSE COMMANDS
160.SS Navigate image list
161.TP
162.B Button1
163Go to the next image; in thumbnail mode: select/open image.
164.TP
165.B Button3
166Go to the previous image.
167.SS Zooming
168.TP
169.B Ctrl+ScrollUp
170Zoom in.
171.TP
172.B Ctrl+ScrollDown
173Zoom out.
174.SS Panning/Moving
175.TP
176.B Button2
177Drag the image with the mouse while keeping this button pressed down.
178.TP
179.B ScrollUp
180Pan image up; in thumbnail mode: Scroll one row up.
181.TP
182.B ScrollDown
183Pan image down; in thumbnail mode: Scroll one row down.
184.TP
185.B Shift+ScrollUp
186Pan image left.
187.TP
188.B Shift+ScrollDown
189Pan image right.
190.SH AUTHORS
191.EX
192Bert Muennich <ber.t at gmx.com>
193Dave Reisner <d at falconindy.com>
194Fung SzeTat <sthorde at gmail.com>
195.EE
196.SH HOMEPAGE
197.TP
198http://github.com/muennich/sxiv
199.SH SEE ALSO
200.BR feh (1),
201.BR qiv (1)