doc/simpleswitcher.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

.TH SIMPLESWITCHER 1 simpleswitcher
.SH NAME
simpleswitcher \- a simple EWMH window switcher
.SH SYNOPSIS
.B simpleswitcher
.RB [ \-width
.IR pct_scr ]
.RB [ \-lines
.IR lines ]
.RB [ \-font
.IR xftfont ]
.RB [ \-fg
.IR color ]
.RB [ \-bg
.IR color ]
.RB [ \-hlfg
.IR color ]
.RB [ \-hlbg
.IR color ]
.RB [ \-key
.IR combo ]
.RB [ \-dkey
.IR comdo ]
.RB [ \-mkey
.IR comdo ]
.RB [ \-now ]
.RB [ \-rnow ]
.RB [ \-snow ]
.RB [ \-mnow ]
.RB [ \-term
.IR terminal ]
.RB [ \-loc
.IR position ]
.RB [ \-hmode ]
.RB [ \-padding
.IR padding ]

.SH DESCRIPTION
.I simpleswitcher
is an X11 popup window switcher. A list is displayed center-screen showing open window titles, WM_CLASS, and desktop number. The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels.
.P
License: MIT/X11
.SH USAGE
See options below for custom key combinations. These are the defaults.
.TP
.B F12
Show all windows on all desktops.
.TP
.B mod1-F2
Show run-dialog.
.SH OPTIONS
.TP
.B -key
Change the key combination to display all windows (default: F12).
.P
.RS
simpleswitcher -key F12
.br
simpleswitcher -key control+shift+s
.br
simpleswitcher -key mod1+Tab
.RE
.TP
.B -rkey
Change the key combination to display the run dialog (default: mod1-F2).
.P
.RS
simpleswitcher -rkey F11
.br
simpleswitcher -rkey control+shift+d
.br
simpleswitcher -rkey mod1+grave (grave=backtick)
.RE
.TP
.B -skey
Change the key combination to display the ssh dialog (default: Alt-F3).
.P
.RS
simpleswitcher -skey F10
.br
simpleswitcher -skey control+shift+s
.br
simpleswitcher -skey mod1+grave (grave=backtick)
.RE
.TP
.B -mkey
Change the key combination to display the mark dialog (default: Alt-F5)
(only if i3 support is enabled).
.P
.RS
simpleswitcher -mkey Alt-F2
.RE
.TP
.B -now
Run simpleswitcher in all-windows mode once then exit. Does not bind any keys.
.TP
.B -rnow
Run simpleswitcher in run-dialog mode once then exit. Does not bind any keys.
.TP
.B -snow
Run simpleswitcher in ssh mode once then exit. Does not bind any keys.
.TP
.B -mnow
Run simpleswitcher in mark mode once then exit. Does not bind any keys (only if i3 support is
enabled).
.TP
.B -bg
Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222).
.P
.RS
simpleswitcher -fg "#222222"
.RE
.TP
.B -bc
Set the border color (X11 named color or hex #rrggbb) for the menu (default: #000000).
.P
.RS
simpleswitcher -bc black
.RE
.TP
.B -bw
Set the border width in pixels (default: 1).
.P
.RS
simpleswitcher -bw 1
.RE
.TP
.B -fg
Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc).
.P
.RS
simpleswitcher -fg "#cccccc"
.RE
.TP
.B -font
Xft font name for use by the menu (default: mono-14).
.P
.RS
simpleswitcher -font monospace-14:medium
.RE
.TP
.B -hlbg
Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #005577).
.P
.RS
simpleswitcher -fg "#005577"
.RE
.TP
.B -hlfg
Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #ffffff).
.P
.RS
simpleswitcher -fg "#ffffff"
.RE
.TP
.B -o
Set the window opacity (0-100).
.P
.RS
simpleswitcher -o "75"
.RE
.TP
.B -lines
Maximum number of entries the menu may show before scrolling (default: 25).
.P
.RS
simpleswitcher -lines 25
.RE
.TP
.B -width
Set the width of the menu as a percentage of the screen width (default: 60).
.P
.RS
simpleswitcher -width 60
.RE
.TP
.B -term
Specify what terminal to start (default x-terminal-emulator)
.P
.RS
simpleswitcher -term xterm
.RE
.TP
.B -loc
Specify where the window should be located. The numbers map to the following location on the
monitor:
.RS
.TP
1 2 3
.TP
8 0 4
.TP
7 6 5
.RE
.TP
.B -hmode
Switch to horizontal mode (ala dmenu). You can specify the number of elements with the
.IR -lines
option.
.TP
.B -padding
Define the inner margin of the window. Default is 5 pixels.
.RS
To make simpleswitcher look like dmenu:
.TP
simpleswitcher -hmode -padding 0
.RE
.SH Switch between modi
Type '?'<enter> to switch between window list and run mode.
.SH SEE ALSO
.BR simpleswitcher (1)
.SH AUTHOR
Sean Pringle <sean.pringle@gmail.com>
Qball Cow <qball@gmpclient.org>