nsxiv/sxiv.1

203 lines
4.0 KiB
Groff
Raw Normal View History

2011-01-23 17:20:08 +00: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 12:34:16 +00:00
.RB [ \-z
.IR ZOOM ]
.IR FILE ...
2011-01-23 17:20:08 +00: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 17:06:30 +00: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 16:06:32 +00: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 17:20:08 +00: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 12:34:16 +00:00
.B \-d
Scale all images to 100%, but fit large images into window.
.TP
2011-02-01 17:25:47 +00: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 12:34:16 +00: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 17:20:08 +00:00
.B \-h
Print brief usage information to standard output and exit.
.TP
2011-01-28 12:34:16 +00: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 12:34:16 +00:00
.B \-s
Scale all images to fit into window.
.TP
2011-02-21 16:06:32 +00:00
.B \-t
Start in thumbnail mode.
.TP
2011-01-23 17:20:08 +00:00
.B \-v
Print version information to standard output and exit.
2011-01-27 15:15:43 +00:00
.TP
2011-01-28 12:34:16 +00: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 17:20:08 +00:00
.SH KEYBOARD COMMANDS
.SS General
.TP
.B q
Quit sxiv.
.TP
2011-02-21 16:06:32 +00:00
.B Return
Switch to thumbnail mode; in thumbnail mode: open selected image.
2011-01-26 17:38:54 +00:00
.SS Navigate image list
2011-01-23 17:20:08 +00:00
.TP
2011-01-28 12:42:39 +00:00
.BR n ", " Space
2011-01-23 17:20:08 +00:00
Go to the next image.
.TP
2011-01-28 12:42:39 +00:00
.BR p ", " Backspace
2011-01-23 17:20:08 +00:00
Go to the previous image.
.TP
.B g
Go to the first image.
.TP
.B G
Go to the last image.
.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 17:45:00 +00:00
.TP
.B 0
Set zoom level to 100%.
.TP
.B w
Set zoom level to fit image into window.
2011-02-21 16:06:32 +00:00
.SS Panning/Moving
2011-01-23 17:20:08 +00:00
.TP
2011-01-28 12:42:39 +00:00
.BR h ", " Left
2011-02-21 16:06:32 +00:00
Pan image left; in thumbnail mode: move selection left.
2011-01-23 17:20:08 +00:00
.TP
2011-01-28 12:42:39 +00:00
.BR j ", " Down
2011-02-21 16:06:32 +00:00
Pan image down; in thumbnail mode: move selection down.
2011-01-23 17:20:08 +00:00
.TP
2011-01-28 12:42:39 +00:00
.BR k ", " Up
2011-02-21 16:06:32 +00:00
Pan image up; in thumbnail mode: move selection up.
2011-01-23 17:20:08 +00:00
.TP
2011-01-28 12:42:39 +00:00
.BR l ", " Right
2011-02-21 16:06:32 +00:00
Pan image right; in thumbnail mode: move selection right.
2011-01-26 13:42:10 +00:00
.SS Rotation
.TP
.B <
Rotate image counter-clockwise by 90 degrees.
.TP
.B >
Rotate image clockwise by 90 degrees.
2011-01-23 17:20:08 +00:00
.SS Control window
.TP
2011-02-06 17:45:00 +00:00
.B W
Resize window to fit image.
.TP
2011-01-23 17:20:08 +00:00
.B f
Toggle fullscreen mode.
.SS Miscellaneous
.TP
.B a
Toggle anti-aliasing.
2011-01-31 15:06:40 +00:00
.TP
2011-03-10 10:51:47 +00:00
.B A
Toggle visibility of alpha-channel, i.e. image transparency.
.TP
2011-01-31 15:06:40 +00:00
.B r
Reload image.
.TP
.B D
Remove image from file list and go to next image; in thumbnail mode: remove
selected image from file list and select next image.
2011-01-26 17:38:54 +00:00
.SH MOUSE COMMANDS
.SS Navigate image list
.TP
.B Button1
2011-02-21 16:06:32 +00:00
Go to the next image; in thumbnail mode: select/open image.
.TP
2011-01-26 17:38:54 +00: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 16:06:32 +00:00
.SS Panning/Moving
.TP
.B Button2
Drag the image with the mouse while keeping this button pressed down.
2011-01-26 17:38:54 +00:00
.TP
.B ScrollUp
2011-02-21 16:06:32 +00:00
Pan image up; in thumbnail mode: Scroll one row up.
2011-01-26 17:38:54 +00:00
.TP
.B ScrollDown
2011-02-21 16:06:32 +00:00
Pan image down; in thumbnail mode: Scroll one row down.
2011-01-26 17:38:54 +00:00
.TP
.B Shift+ScrollUp
2011-02-21 16:06:32 +00:00
Pan image left.
2011-01-26 17:38:54 +00:00
.TP
.B Shift+ScrollDown
2011-02-21 16:06:32 +00:00
Pan image right.
2011-01-23 17:20:08 +00:00
.SH AUTHORS
2011-01-27 09:18:23 +00:00
.EX
2011-01-23 17:20:08 +00:00
Bert Muennich <ber.t at gmx.com>
2011-01-27 09:18:23 +00:00
Dave Reisner <d at falconindy.com>
2011-02-09 09:55:40 +00:00
Fung SzeTat <sthorde at gmail.com>
2011-01-27 09:18:23 +00:00
.EE
2011-01-23 17:35:01 +00:00
.SH HOMEPAGE
2011-01-23 17:20:08 +00:00
.TP
http://github.com/muennich/sxiv
.SH SEE ALSO
2011-01-26 17:38:54 +00:00
.BR feh (1),
.BR qiv (1)