zeniba-nsxiv/sxiv.1

160 lines
2.3 KiB
Groff

.TH SXIV 1 sxiv\-VERSION
.SH NAME
sxiv \- Simple (or small or suckless) X Image Viewer
.SH SYNOPSIS
.B sxiv
.RB [ \-dfhpsvWZ ]
.RB [ \-w
.IB WIDTH x HEIGHT
]
.RB [ \-z
.IR ZOOM ]
.IR FILE ...
.SH DESCRIPTION
sxiv is a simple image viewer for X. It only has the most basic features
required for fast image viewing.
.P
Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
manager.
.SH OPTIONS
.TP
.B \-d
Scale all images to 100%, but fit large images into window.
.TP
.B \-f
Start in fullscreen mode.
.TP
.B \-h
Print brief usage information to standard output and exit.
.TP
.B \-p
Pixelize images, i.e. turn off anti-aliasing.
.TP
.B \-s
Scale all images to fit into window.
.TP
.B \-v
Print version information to standard output and exit.
.TP
.B \-W
Enable printing of warnings to standard error stream.
.TP
.BI "\-w " WIDTH x HEIGHT
Set window width to
.I WIDTH
and height to
.IR HEIGHT .
If
.I HEIGHT
is omitted, height is also set to
.IR WIDTH .
.TP
.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.
.SH KEYBOARD COMMANDS
.SS General
.TP
.B q
Quit sxiv.
.TP
.B Escape
Quit sxiv and return an exit value of 2.
.SS Navigate image list
.TP
.BR n ", " Space
Go to the next image.
.TP
.BR p ", " Backspace
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.
.SS Panning
.TP
.BR h ", " Left
Pan left.
.TP
.BR j ", " Down
Pan down.
.TP
.BR k ", " Up
Pan up.
.TP
.BR l ", " Right
Pan right.
.SS Rotation
.TP
.B <
Rotate image counter-clockwise by 90 degrees.
.TP
.B >
Rotate image clockwise by 90 degrees.
.SS Control window
.TP
.B f
Toggle fullscreen mode.
.SS Miscellaneous
.TP
.B a
Toggle anti-aliasing.
.SH MOUSE COMMANDS
.SS Navigate image list
.TP
.B Button1
Go to the next image.
.TP
.B Button3
Go to the previous image.
.SS Zooming
.TP
.B Ctrl+ScrollUp
Zoom in.
.TP
.B Ctrl+ScrollDown
Zoom out.
.SS Panning
.TP
.B ScrollUp
Pan up.
.TP
.B ScrollDown
Pan down.
.TP
.B Shift+ScrollUp
Pan left.
.TP
.B Shift+ScrollDown
Pan right.
.SH AUTHORS
.EX
Bert Muennich <ber.t at gmx.com>
Dave Reisner <d at falconindy.com>
.EE
.SH HOMEPAGE
.TP
http://github.com/muennich/sxiv
.SH SEE ALSO
.BR feh (1),
.BR qiv (1)