Krolyxon
Commit 91d9b31

Branches

Refs →

nsxivsxiv.1

457 lines · 8.6 KB · Groff/troff

Raw Blame History Download
1.TH SXIV 1 sxiv\-VERSION
2.SH NAME
3sxiv \- Simple X Image Viewer
4.SH SYNOPSIS
5.B sxiv
6.RB [ \-abcfhiopqrtvZ ]
7.RB [ \-A
8.IR FRAMERATE ]
9.RB [ \-e
10.IR WID ]
11.RB [ \-G
12.IR GAMMA ]
13.RB [ \-g
14.IR GEOMETRY ]
15.RB [ \-N
16.IR NAME ]
17.RB [ \-n
18.IR NUM ]
19.RB [ \-S
20.IR DELAY ]
21.RB [ \-s
22.IR MODE ]
23.RB [ \-z
24.IR ZOOM ]
25.IR FILE ...
26.SH DESCRIPTION
27sxiv is a simple image viewer for X.
28.P
29It has two modes of operation: image and thumbnail mode. The default is image
30mode, in which only the current image is shown. In thumbnail mode a grid of
31small previews is displayed, making it easy to choose an image to open.
32.P
33Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
34manager.
35.SH OPTIONS
36.TP
37.BI "\-A " FRAMERATE
38Play animations with a constant frame rate set to
39.IR FRAMERATE .
40.TP
41.B \-a
42Play animations of multi-frame images.
43.TP
44.B \-b
45Do not show info bar on bottom of window.
46.TP
47.B \-c
48Remove all orphaned cache files from the thumbnail cache directory and exit.
49.TP
50.BI "\-e " WID
51Embed sxiv's window into window whose ID is
52.IR WID .
53.TP
54.B \-f
55Start in fullscreen mode.
56.TP
57.BI "\-G " GAMMA
58Set image gamma to GAMMA (\-32..32).
59.TP
60.BI "\-g " GEOMETRY
61Set window position and size. See section GEOMETRY SPECIFICATIONS of X(7) for
62more information on GEOMETRY argument.
63.TP
64.BI "\-N " NAME
65Set the resource name of sxiv's X window to NAME.
66.TP
67.BI "\-n " NUM
68Start at picture number NUM.
69.TP
70.B \-h
71Print brief usage information to standard output and exit.
72.TP
73.B \-i
74Read names of files to open from standard input. Also done if FILE is `-'.
75.TP
76.B \-o
77Write list of all marked files to standard output when quitting. In combination
78with
79.B \-i
80sxiv can be used as a visual filter/pipe.
81.TP
82.B \-p
83Enable private mode, in which sxiv does not write any cache or temporary files.
84.TP
85.B \-q
86Be quiet, disable warnings to standard error stream.
87.TP
88.B \-r
89Search the given directories recursively for images to view.
90.TP
91.BI "\-S " DELAY
92Start in slideshow mode. Set the delay between images to
93.I DELAY
94seconds.
95.I DELAY
96may be a floating point number.
97.TP
98.BI "\-s " MODE
99Set scale mode according to MODE character. Supported modes are: [d]own,
100[f]it, [F]ill, [w]idth, [h]eight.
101.TP
102.B \-t
103Start in thumbnail mode.
104.TP
105.B \-v
106Print version information to standard output and exit.
107.TP
108.B \-Z
109The same as `\-z 100'.
110.TP
111.BI "\-z " ZOOM
112Set zoom level to ZOOM percent.
113.SH KEYBOARD COMMANDS
114.SS General
115The following keyboard commands are available in both image and thumbnail mode:
116.TP
117.BR 0 \- 9
118Prefix the next command with a number (denoted via
119.IR count ).
120.TP
121.B q
122Quit sxiv.
123.TP
124.B Return
125Switch to thumbnail mode / open selected image in image mode.
126.TP
127.B f
128Toggle fullscreen mode.
129.TP
130.B b
131Toggle visibility of info bar on bottom of window.
132.TP
133.B Ctrl-x
134Send the next key to the external key-handler. See section EXTERNAL KEY HANDLER
135for more information.
136.TP
137.B g
138Go to the first image.
139.TP
140.B G
141Go to the last image, or image number
142.IR count .
143.TP
144.B r
145Reload image.
146.TP
147.B D
148Remove current image from file list and go to next image.
149.TP
150.BR Ctrl-h ", " Ctrl-Left
151Scroll left one screen width.
152.TP
153.BR Ctrl-j ", " Ctrl-Down
154Scroll down one screen height.
155.TP
156.BR Ctrl-k ", " Ctrl-Up
157Scroll up one screen height.
158.TP
159.BR Ctrl-l ", " Ctrl-Right
160Scroll right one screen width.
161.TP
162.BR +
163Zoom in.
164.TP
165.B \-
166Zoom out.
167.TP
168.B m
169Mark/unmark the current image.
170.TP
171.B M
172Repeat last mark action on all images from the last marked/unmarked up to the
173current one.
174.TP
175.B Ctrl-m
176Reverse all image marks.
177.TP
178.B Ctrl-u
179Remove all image marks.
180.TP
181.B N
182Go
183.I count
184marked images forward.
185.TP
186.B P
187Go
188.I count
189marked images backward.
190.TP
191.B {
192Decrease gamma correction by
193.I count
194steps.
195.TP
196.B }
197Increase gamma correction by
198.I count
199steps.
200.TP
201.B Ctrl-g
202Reset gamma correction.
203.SS Thumbnail mode
204The following keyboard commands are only available in thumbnail mode:
205.TP
206.BR h ", " Left
207Move selection left
208.I count
209times.
210.TP
211.BR j ", " Down
212Move selection down
213.I count
214times.
215.TP
216.BR k ", " Up
217Move selection up
218.I count
219times.
220.TP
221.BR l ", " Right
222Move selection right
223.I count
224times.
225.TP
226.B R
227Reload all thumbnails.
228.SS Image mode
229The following keyboard commands are only available in image mode:
230.TP
231Navigate image list:
232.TP
233.BR n ", " Space
234Go
235.I count
236images forward.
237.TP
238.BR p ", " Backspace
239Go
240.I count
241images backward.
242.TP
243.B [
244Go
245.I count
246* 10 images backward.
247.TP
248.B ]
249Go
250.I count
251* 10 images forward.
252.TP
253Handle multi-frame images:
254.TP
255.B Ctrl-n
256Go
257.I count
258frames of a multi-frame image forward.
259.TP
260.B Ctrl-p
261Go
262.I count
263frames of a multi-frame image backward.
264.TP
265.BR Ctrl-a ", " Ctrl-Space
266Play/stop animations of multi-frame images.
267.TP
268Panning:
269.TP
270.BR h ", " Left
271Scroll image 1/5 of window width or
272.I count
273pixel left.
274.TP
275.BR j ", " Down
276Scroll image 1/5 of window height or
277.I count
278pixel down.
279.TP
280.BR k ", " Up
281Scroll image 1/5 of window height or
282.I count
283pixel up.
284.TP
285.BR l ", " Right
286Scroll image 1/5 of window width or
287.I count
288pixel right.
289.TP
290.B H
291Scroll to left image edge.
292.TP
293.B J
294Scroll to bottom image edge.
295.TP
296.B K
297Scroll to top image edge.
298.TP
299.B L
300Scroll to right image edge.
301.TP
302Zooming:
303.TP
304.B =
305Set zoom level to 100%, or
306.IR count %.
307.TP
308.B w
309Set zoom level to 100%, but fit large images into window.
310.TP
311.B W
312Fit image to window.
313.TP
314.B F
315Fill image to window.
316.TP
317.B e
318Fit image to window width.
319.TP
320.B E
321Fit image to window height.
322.TP
323Rotation:
324.TP
325.B <
326Rotate image counter-clockwise by 90 degrees.
327.TP
328.B >
329Rotate image clockwise by 90 degrees.
330.TP
331.B ?
332Rotate image by 180 degrees.
333.TP
334Flipping:
335.TP
336.B |
337Flip image horizontally.
338.TP
339.B _
340Flip image vertically.
341.TP
342Miscellaneous:
343.TP
344.B a
345Toggle anti-aliasing.
346.TP
347.B A
348Toggle visibility of alpha-channel, i.e. image transparency.
349.TP
350.B s
351Toggle slideshow mode and/or set the delay between images to
352.I count
353seconds.
354.SH MOUSE COMMANDS
355The following mouse mappings are available in image mode:
356.TP
357General:
358.TP
359.B Button3
360Switch to thumbnail mode.
361.TP
362Navigate image list:
363.TP
364.B Button1
365Go to the next image if the mouse cursor is in the right part of the window or
366to the previous image if it is in the left part.
367.TP
368Panning:
369.TP
370.B Button2
371Pan the image according to the mouse cursor position in the window while
372keeping this button pressed down.
373.TP
374Zooming:
375.TP
376.B ScrollUp
377Zoom in.
378.TP
379.B ScrollDown
380Zoom out.
381.SH CONFIGURATION
382The following X resources are supported:
383.TP
384.B window.background
385Color of the window background
386.TP
387.B window.foreground
388Color of the window foreground
389.TP
390.B bar.background
391Color of the bar background. Defaults to window.foreground
392.TP
393.B bar.foreground
394Color of the bar foreground. Defaults to window.background
395.TP
396.B font
397Name of Xft bar font
398.TP
399Please see xrdb(1) on how to change them.
400.SH STATUS BAR
401The information displayed on the left side of the status bar can be replaced
402with the output of a user-provided script, which is called by sxiv whenever an
403image gets loaded. The path of this script is
404.I $XDG_CONFIG_HOME/sxiv/exec/image-info
405and the arguments given to it are: 1) path to image file, 2) image width,
4063) image height.
407.P
408There is also an example script installed together with sxiv as
409.IR PREFIX/share/sxiv/exec/image-info .
410.SH EXTERNAL KEY HANDLER
411Additional external keyboard commands can be defined using a handler program
412located in
413.IR $XDG_CONFIG_HOME/sxiv/exec/key-handler .
414The handler is invoked by pressing
415.BR Ctrl-x .
416The next key combo is passed as its first argument. Passed via stdin are the
417images to act upon, one path per line: all marked images, if in thumbnail mode
418and at least one image has been marked, otherwise the current image.
419sxiv(1) will block until the handler terminates. It then checks which images
420have been modified and reloads them.
421
422The key combo argument has the following form: "[C-][M-][S-]KEY",
423where C/M/S indicate Ctrl/Meta(Alt)/Shift modifier states and KEY is the X
424keysym as listed in /usr/include/X11/keysymdef.h without the "XK_" prefix.
425
426There is also an example script installed together with sxiv as
427.IR PREFIX/share/sxiv/exec/key-handler .
428.SH THUMBNAIL CACHING
429sxiv stores all thumbnails under
430.IR $XDG_CACHE_HOME/sxiv/ .
431.P
432Use the command line option
433.I \-c
434to remove all orphaned cache files. Additionally, run the following command
435afterwards inside the cache directory to remove empty subdirectories:
436.P
437.RS
438find . \-depth \-type d \-empty ! \-name '.' \-exec rmdir {} \\;
439.RE
440.SH AUTHOR
441.EX
442Bert Muennich <ber.t at posteo.de>
443.EE
444.SH CONTRIBUTORS
445.EX
446Bastien Dejean <nihilhill at gmail.com>
447Dave Reisner <d at falconindy.com>
448Fung SzeTat <sthorde at gmail.com>
449Max Voit <mvdev at with-eyes.net>
450.EE
451.SH HOMEPAGE
452.EX
453https://github.com/muennich/sxiv
454.EE
455.SH SEE ALSO
456.BR X (7),
457.BR xrdb (1)