aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md3
-rw-r--r--sxiv.140
2 files changed, 27 insertions, 16 deletions
diff --git a/README.md b/README.md
index b15d1ce..095c3cc 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,6 @@ Use the following keys to control the basic behaviour of sxiv:
q Quit sxiv
Escape Quit sxiv and return an exit value of 2 (useful for scripting)
- Return Switch operation mode
f Toggle fullscreen mode (requires an EWMH/NetWM compliant
window manager)
@@ -71,6 +70,7 @@ Inside image view mode, the following key mappings are available:
W Resize window to fit image
a Toggle anti-aliasing
r Reload image
+ Return Switch to thumbnail mode
Additionally, the image view offers the following mouse commands:
@@ -88,6 +88,7 @@ In thumbnail mode, the following key and mouse mappings are available:
h,j,k,l Move selection left/down/up/right (also with arrow keys)
g/G Move selection to first/last image
+ Return Open selected image
Button1 Select image/open image if it is already selected
ScrollUp Scroll up one row
diff --git a/sxiv.1 b/sxiv.1
index 974b546..396f3e9 100644
--- a/sxiv.1
+++ b/sxiv.1
@@ -3,7 +3,7 @@
sxiv \- Simple (or small or suckless) X Image Viewer
.SH SYNOPSIS
.B sxiv
-.RB [ \-dFfhpqrsvZ ]
+.RB [ \-dFfhpqrstvZ ]
.RB [ \-g
.IR GEOMETRY ]
.RB [ \-z
@@ -20,6 +20,10 @@ hyphen\-minus
.RB ( \- )
is given.
.P
+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
Please note, that the fullscreen mode requires an EWMH/NetWM compliant window
manager.
.SH OPTIONS
@@ -54,6 +58,9 @@ Search the given directories recursively for images to view.
.B \-s
Scale all images to fit into window.
.TP
+.B \-t
+Start in thumbnail mode.
+.TP
.B \-v
Print version information to standard output and exit.
.TP
@@ -72,6 +79,9 @@ Quit sxiv.
.TP
.B Escape
Quit sxiv and return an exit value of 2.
+.TP
+.B Return
+Switch to thumbnail mode; in thumbnail mode: open selected image.
.SS Navigate image list
.TP
.BR n ", " Space
@@ -104,19 +114,19 @@ Set zoom level to 100%.
.TP
.B w
Set zoom level to fit image into window.
-.SS Panning
+.SS Panning/Moving
.TP
.BR h ", " Left
-Pan left.
+Pan image left; in thumbnail mode: move selection left.
.TP
.BR j ", " Down
-Pan down.
+Pan image down; in thumbnail mode: move selection down.
.TP
.BR k ", " Up
-Pan up.
+Pan image up; in thumbnail mode: move selection up.
.TP
.BR l ", " Right
-Pan right.
+Pan image right; in thumbnail mode: move selection right.
.SS Rotation
.TP
.B <
@@ -142,10 +152,7 @@ Reload image.
.SS Navigate image list
.TP
.B Button1
-Go to the next image.
-.TP
-.B Button2
-Drag the image with the mouse while keeping this button pressed down.
+Go to the next image; in thumbnail mode: select/open image.
.TP
.B Button3
Go to the previous image.
@@ -156,19 +163,22 @@ Zoom in.
.TP
.B Ctrl+ScrollDown
Zoom out.
-.SS Panning
+.SS Panning/Moving
+.TP
+.B Button2
+Drag the image with the mouse while keeping this button pressed down.
.TP
.B ScrollUp
-Pan up.
+Pan image up; in thumbnail mode: Scroll one row up.
.TP
.B ScrollDown
-Pan down.
+Pan image down; in thumbnail mode: Scroll one row down.
.TP
.B Shift+ScrollUp
-Pan left.
+Pan image left.
.TP
.B Shift+ScrollDown
-Pan right.
+Pan image right.
.SH AUTHORS
.EX
Bert Muennich <ber.t at gmx.com>