forked from soulthreads/xwinmosaic
-
Notifications
You must be signed in to change notification settings - Fork 0
/
xwinmosaic.1
223 lines (206 loc) · 4.96 KB
/
xwinmosaic.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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
.\" Man page for xwinmosaic
.TH XWINMOSAIC 1 "June 12, 2013"
.SH NAME
xwinmosaic \- show X11 windows as a colourful mosaic
.SH SYNOPSYS
.B xwinmosaic
.RI [ "options" ] ...
.SH DESCRIPTION
.B xwinmosaic
is a X11 window switcher that draws windows list as colour mosaic.
It is inspired by XMonad.Actions.GridSelect, but written in C + GTK+2, uses
nice-looking colours and has some set of helpful features.
.P
.B xwinmosaic
can also be used as
.B dmenu
to select item from newline-separated list given from stdin and print it to stdout.
.P
For using
.B xwinmosaic
as a window switcher you should run it in WM that supports EWMH (Extended Window Manager Hints) specification. However, it is not necessary for read_stdin mode.
.SH OPTIONS
.TP
.BR \-r ", " \-\^\-read\-stdin
Read items from stdin and print selected item to stdout.
.TP
.BR \-p ", " \-\^\-permissive
Lets search entry text to be used as individual item (i.e. when no one item is mathed, text from search entry is printed to stdout).
Can be used only with
.BR \-r
option.
.TP
.BR \-t ", " \-\^\-format
Read items from stdin in next format (comma separated):
<desktop_num>, <box_color>, <icon>, <label>, <opt_name>
Any option, except <label> can be skipped (only comma is necessary).
<icon> should be a path to png file or icon name from theme.
Any positive value of <desktop_num> is allowed.
Can be used only with
.BR \-r
option.
.TP
.TP
.BR \-V ", " \-\^\-vim\-mode
Turn on vim\-like navigation (hjkl, search on /)
.TP
.BR \-C ", " \-\^\-no\-colors
Turn off box colorizing
.TP
.BR \-I ", " \-\^\-no\-icons
Turn off showing icons
.TP
.BR \-D ", " \-\^\-no\-desktops
Turn off showing desktop number
.TP
.BR \-T ", " \-\^\-no\-titles
Turn off showing titles
.TP
.BR \-S ", " \-\^\-screenshot
Get screenshot and set it as a background (for WMs that do not support XShape)
.TP
.BR \-P ", " \-\^\-at\-pointer
Place center of mosaic at pointer position.
.TP
.BI \-W " <int>" "\fR,\fP \-\^\-box\-width=" <int>
Width of the boxes (default: 200)
.TP
.BI \-H " <int>" "\fR,\fP \-\^\-box\-height=" <int>
Height of the boxes (default: 40)
.TP
.BI \-i " <int>" "\fR,\fP \-\^\-icon\-size=" <int>
Size of window icons (default: 16)
.TP
.BI \-f " 'font [size]'" "\fR,\fP \-\^\-font=" "'font [size]'"
Which font to use for displaying widgets. (default: 'Sans 10')
.TP
.BI \-o " <int>" "\fR,\fP\-\^\-hue\-offset=" <int>
Set color hue offset (from 0 to 255)
.TP
.BI \-F " /path/to/file" "\fR,\fP \-\^\-color\-file=" /path/to/file
Pick colors from file. File format is described in USAGE section.
.SH USAGE
.SS Keybindings
Use arrow keys or mouse to navigate through windows. Start typing to search for required window. Use Return or mouse button 1 to confirm selection (switch to selected window or print selected item to stdout). Following hotkeys are also available:
.SB Default (Emacs) mode:
.TP
C\-n
Move down.
.TP
C\-p
Move up.
.TP
C\-f
Move right.
.TP
C\-b
Move left.
.TP
C\-h
Delete character backward.
.TP
C\-w
Delete word backward.
.TP
C\-m
Confirm selection.
.P
.SB Vim mode:
.TP
h
Move left.
.TP
j
Move down.
.TP
k
Move up.
.TP
l
Move right.
.TP
/
Activate search.
.SS Configuration
Config file is created automatically on first program run and stored in
.IR ~/.config/xwinmosaic/config "."
It has the following entries:
.TP
.I vim_mode
Should program run in vim mode.
.TP
.I box_width
Width of the boxes.
.TP
.I box_height
Height of the boxes.
.TP
.I colorize
Should program colorize boxes or not?
.TP
.I color_offset
Set hue offset for default colorizing method (save values are beetwen 0 and 255).
.TP
.I show_icons
Should program show icons?
.TP
.I show_desktop
Should program show desktop number?
.TP
.I show_titles
Should program show titles?
.TP
.I icon_size
Size of the icons in boxes.
.TP
.I font
Which font to use in all program widgets.
.TP
.I screenshot
Set screenshot as a background. Useful for WM's that don't work properly with shaped windows.
.TP
.I screenshot_offset_x
Screenshot offset by x coordinate. Can be useful if your WM does not support _NET_WM_STRUT and/or _NET_WM_STRUT_PARTIAL property.
.TP
.I screenshot_offset_y
Screenshot offset by y coordinate. As above.
.TP
.I at_pointer
If true, center of the mosaic is placed at the current pointer position.
.TP
.I icon_position
Defines icon position inside the box. Can be one of:
.BR top ,
.B left
(default).
.TP
.I color_file
Path to file with colors that
.B xwinmoasic
should use. Colors can be set for each window class individually or be taken from
.I fallback
list (note each color is separated by semicolon).
.SB Color file format:
.RS
.TP
.PD 0
[colors]
.TP
# Use xprop to determine window class
.TP
WindowClass1 = #112233
.TP
WindowClass2 = #445566
.TP
# For other windows to use. You can omit that line and it will use standard colorizing scheme.
.TP
fallback = #778899; #AABBCC; #DDEEFF
.PD
.RE
.SH BUGS
If you found some bug in
.BR xwinmosaic ", "
please report it at
.IR https://github.com/soulthreads/xwinmosaic/issues "."
.SH AUTHOR
xwinmosaic and this manual page is written by Anton Lobashev <[email protected]>