-
Notifications
You must be signed in to change notification settings - Fork 1
/
mage.1
106 lines (106 loc) · 2.01 KB
/
mage.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
.TH MAGE 1 mage\-VERSION
.SH NAME
mage \- image viewer
.SH SYNOPSIS
.B mage
.RB [ \-fhpqrv ]
.RB [ \-s
.IR scalemode ]
.RB [ \-n
.IR class ]
.RI [ "file \- directory ..." ]
.SH DESCRIPTION
.B mage
is an image viewer for X, heavily inspired by
.BR sxiv(1)
image operations. Made it to be simple to tweak to add a feature you
may wish, since by default it offers some 'basics' operations.
.P
.SH OPTIONS
When
.I file
is
.B \-
, read standard input.
.TP
.B \-f
Starts the window in fullscreen.
.TP
.B \-h
Prints the usage and exits.
.TP
.B \-p
Pixelate images.
.TP
.B \-q
Quiet. Does not print different warnings, whether it's ignoring a directory because it's missing the
.I \-r
flag or whether the file isn't an image or doesn't exist, etc.
.TP
.B \-r
True recursiveness. If the argument is a directory, mage by default will not load sub-directories (similar to what
.I find -maxdepth 1
does), unless you specify otherwise.
.TP
.B \-v
Prints the version and exits.
.TP
.BI \-s " scalemode"
Will set the scaling mode to
.IR scalemode ,
supported modes are: down, fit, width and height.
.TP
.BI \-n " class"
Will set the WM_CLASS attribute to
.IR name .
.SH USAGE
Keybindings are defined on config.h, below are default bindings.
.TP
.B b
Toggles the bar.
.TP
.B Space, BackSpace
Moves to the next/prev image.
.TP
.B Equal, Minus
Adds/decrease zoom, default steps are +/\-12.5.
.TP
.B Plus
Sets the zoom to a 100.
.TP
.B f
Toggles fullscreen.
.TP
.B h/j/k/l
Pan while the image is bigger than the window (zoommed).
.TP
.B Shift\-,
Rotate image 90 degrees right.
.TP
.B Shift\-.
Rotate image 90 degrees left.
.TP
.B backslash
Cycles scale modes +1.
.TP
.B Shitft\-backslash
Cycles scale modes -1.
.TP
.B s
Saves the state of the current 'image buffer' into the 'real image' (e.g if you rotate the image it won't get overwritten into the actual file).
.TP
.B r
Reloads the current image.
.TP
.B u
Vertically flips the image.
.TP
.B ShiftMask\-u
Horizontally flips the image.
.TP
.B g/G
Go to the first/last image.
.SH SEE ALSO
.IR feh (1),
.IR imv (1),
.IR sxiv (1)