nsxiv/sxiv.1

206 lines
4.0 KiB
Groff
Raw Normal View History

2011-01-23 18:20:08 +01:00
.TH SXIV 1 sxiv\-VERSION
.SH NAME
sxiv \- Simple (or small or suckless) X Image Viewer
.SH SYNOPSIS
.B sxiv
.RB [ \-adFfhpqrstvZ ]
.RB [ \-g
.IR GEOMETRY ]
2011-01-28 13:34:16 +01:00
.RB [ \-z
.IR ZOOM ]
.IR FILE ...
2011-01-23 18:20:08 +01:00
.SH DESCRIPTION
sxiv is a simple image viewer for X. It only has the most basic features
required for fast image viewing.
.P
2011-02-14 18:06:30 +01:00
sxiv opens all named
.IR FILE s,
or reads the names of the files to open from standard input, if only a single
hyphen\-minus
.RB ( \- )
is given.
.P
2011-02-21 17:06:32 +01:00
sxiv has two modes of operation: image and thumbnail mode. The default is image
mode, in which only the current image is shown. In thumbnail mode a grid of
small previews is displayed, making it easy to choose an image to open.
.P
2011-01-23 18:20:08 +01:00
Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
manager.
.SH OPTIONS
.TP
.B \-a
Display all given files, do not filter out unsupported files. This might result
in a much shorter startup time, when the file list is very long or contains
large files of slow loadable types, e.g. gif and progressive jpg.
.TP
2011-01-28 13:34:16 +01:00
.B \-d
Scale all images to 100%, but fit large images into window.
.TP
2011-02-01 18:25:47 +01:00
.B \-F
Make the window fixed/floating by setting the minimum and maximum width/height
size-hints to the window width/height.
.TP
2011-01-28 13:34:16 +01:00
.B \-f
Start in fullscreen mode.
.TP
.BI "\-g " GEOMETRY
Set window position and size. See section GEOMETRY SPECIFICATIONS of X(7) for
more information on
.IR GEOMETRY .
.TP
2011-01-23 18:20:08 +01:00
.B \-h
Print brief usage information to standard output and exit.
.TP
2011-01-28 13:34:16 +01:00
.B \-p
Pixelize images, i.e. turn off anti-aliasing.
.TP
.B \-q
Be quiet, disable warnings to standard error stream.
.TP
.B \-r
Search the given directories recursively for images to view.
.TP
2011-01-28 13:34:16 +01:00
.B \-s
Scale all images to fit into window.
.TP
2011-02-21 17:06:32 +01:00
.B \-t
Start in thumbnail mode.
.TP
2011-01-23 18:20:08 +01:00
.B \-v
Print version information to standard output and exit.
2011-01-27 16:15:43 +01:00
.TP
2011-01-28 13:34:16 +01:00
.B \-Z
The same as `-z 100'.
.TP
.BI "\-z " ZOOM
Scale all images to the current zoom level, use a zoom level of
.I ZOOM
at startup.
2011-01-23 18:20:08 +01:00
.SH KEYBOARD COMMANDS
The differences of the following key mappings between image view and thumbnail
mode are denoted via brackets.
2011-01-23 18:20:08 +01:00
.SS General
.TP
.B q
Quit sxiv.
.TP
2011-02-21 17:06:32 +01:00
.B Return
Switch to thumbnail mode [open selected image].
2011-01-26 18:38:54 +01:00
.SS Navigate image list
2011-01-23 18:20:08 +01:00
.TP
2011-01-28 13:42:39 +01:00
.BR n ", " Space
2011-01-23 18:20:08 +01:00
Go to the next image.
.TP
2011-01-28 13:42:39 +01:00
.BR p ", " Backspace
2011-01-23 18:20:08 +01:00
Go to the previous image.
.TP
.B g
Go to [select] the first image.
2011-01-23 18:20:08 +01:00
.TP
.B G
Go to [select] the last image.
2011-01-23 18:20:08 +01:00
.TP
.B [
Go 10 images backward.
.TP
.B ]
Go 10 images forward.
.SS Zooming
.TP
.BR + ", " =
Zoom in.
.TP
.B \-
Zoom out.
2011-02-06 18:45:00 +01:00
.TP
.B 0
Set zoom level to 100%.
.TP
.B w
Set zoom level to fit image into window.
2011-02-21 17:06:32 +01:00
.SS Panning/Moving
2011-01-23 18:20:08 +01:00
.TP
2011-01-28 13:42:39 +01:00
.BR h ", " Left
Pan image [move selection] left.
2011-01-23 18:20:08 +01:00
.TP
2011-01-28 13:42:39 +01:00
.BR j ", " Down
Pan image [move selection] down.
2011-01-23 18:20:08 +01:00
.TP
2011-01-28 13:42:39 +01:00
.BR k ", " Up
Pan image [move selection] up.
2011-01-23 18:20:08 +01:00
.TP
2011-01-28 13:42:39 +01:00
.BR l ", " Right
Pan image [move selection] right.
2011-01-26 14:42:10 +01:00
.SS Rotation
.TP
.B <
Rotate image counter-clockwise by 90 degrees.
.TP
.B >
Rotate image clockwise by 90 degrees.
2011-01-23 18:20:08 +01:00
.SS Control window
.TP
2011-02-06 18:45:00 +01:00
.B W
Resize window to fit image.
.TP
2011-01-23 18:20:08 +01:00
.B f
Toggle fullscreen mode.
.SS Miscellaneous
.TP
.B a
Toggle anti-aliasing.
2011-01-31 16:06:40 +01:00
.TP
2011-03-10 11:51:47 +01:00
.B A
Toggle visibility of alpha-channel, i.e. image transparency.
.TP
.B D
Remove current [selected] image from file list and go to [select] next image.
.TP
2011-01-31 16:06:40 +01:00
.B r
Reload image.
2011-01-26 18:38:54 +01:00
.SH MOUSE COMMANDS
The differences of the following mouse mappings between image view and
thumbnail mode are denoted via brackets.
2011-01-26 18:38:54 +01:00
.SS Navigate image list
.TP
.B Button1
Go to [select/open] next image.
.TP
2011-01-26 18:38:54 +01:00
.B Button3
Go to the previous image.
.SS Zooming
.TP
.B Ctrl+ScrollUp
Zoom in.
.TP
.B Ctrl+ScrollDown
Zoom out.
2011-02-21 17:06:32 +01:00
.SS Panning/Moving
.TP
.B Button2
Drag the image with the mouse while keeping this button pressed down.
2011-01-26 18:38:54 +01:00
.TP
.B ScrollUp
Pan image up [scroll up one thumbnail row].
2011-01-26 18:38:54 +01:00
.TP
.B ScrollDown
Pan image down [scroll down one thumbnail row].
2011-01-26 18:38:54 +01:00
.TP
.B Shift+ScrollUp
2011-02-21 17:06:32 +01:00
Pan image left.
2011-01-26 18:38:54 +01:00
.TP
.B Shift+ScrollDown
2011-02-21 17:06:32 +01:00
Pan image right.
2011-01-23 18:20:08 +01:00
.SH AUTHORS
2011-01-27 10:18:23 +01:00
.EX
2011-01-23 18:20:08 +01:00
Bert Muennich <ber.t at gmx.com>
2011-01-27 10:18:23 +01:00
Dave Reisner <d at falconindy.com>
2011-02-09 10:55:40 +01:00
Fung SzeTat <sthorde at gmail.com>
2011-01-27 10:18:23 +01:00
.EE
2011-01-23 18:35:01 +01:00
.SH HOMEPAGE
2011-01-23 18:20:08 +01:00
.TP
http://github.com/muennich/sxiv
.SH SEE ALSO
2011-01-26 18:38:54 +01:00
.BR feh (1),
.BR qiv (1)