2012-06-29 13:29:23 -04:00
.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 [ \- now ]
2014-01-14 00:36:12 -05:00
.RB [ \- rnow ]
2014-01-20 15:17:19 -05:00
.RB [ \- term
.IR terminal ]
2012-06-29 13:29:23 -04:00
.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
2014-01-14 00:36:12 -05:00
.B mod1-F2
Show run-dialog.
2012-06-29 13:29:23 -04:00
.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
2012-08-26 01:51:12 -04:00
simpleswitcher -key mod1+Tab
2012-06-29 13:29:23 -04:00
.RE
.TP
2014-01-14 00:36:12 -05:00
.B -rkey
Change the key combination to display the run dialog (default: mod1-F2).
2012-06-29 13:29:23 -04:00
.P
.RS
2014-01-14 00:36:12 -05:00
simpleswitcher -rkey F11
2012-06-29 13:29:23 -04:00
.br
2014-01-14 00:36:12 -05:00
simpleswitcher -rkey control+shift+d
2012-06-29 13:29:23 -04:00
.br
2014-01-14 00:36:12 -05:00
simpleswitcher -rkey mod1+grave (grave=backtick)
2012-06-29 13:29:23 -04:00
.RE
.TP
.B -now
Run simpleswitcher in all-windows mode once then exit. Does not bind any keys.
.TP
2014-01-14 00:36:12 -05:00
.B -rnow
Run simpleswitcher in run-dialog mode once then exit. Does not bind any keys.
.TP
2012-06-29 13:29:23 -04:00
.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
2012-07-18 08:14:13 -04:00
.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
2012-06-29 13:29:23 -04:00
.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
2013-01-20 08:20:05 -05:00
.B -o
Set the window opacity (0-100).
.P
.RS
simpleswitcher -o "75"
.RE
.TP
2012-06-29 13:29:23 -04:00
.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
2014-01-20 15:17:19 -05:00
.TP
.B -term
Specify what terminal to start (default x-terminal-emulator)
.P
.RS
simpleswitcher -term xterm
.RE
2014-01-16 03:21:48 -05:00
.SH Switch between modi
Type '?'<enter> to switch between window list and run mode.
2012-06-29 13:29:23 -04:00
.SH SEE ALSO
.BR simpleswitcher (1)
.SH AUTHOR
Sean Pringle <sean.pringle@gmail.com>
2014-01-14 00:36:12 -05:00
Qball Cow <qball@gmpclient.org>