summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 5d02d9fd6667213eb245edf4cb926806b905c847 (plain)
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
# simpleswitcher

A popup window switcher roughly based on [superswitcher](http://code.google.com/p/superswitcher/), requiring only xlib and xft.
This version is based on the version from [Sean
Pringle](http://github.com/seanpringle/simpleswitcher). All credit for this great tool should go to him.

* Switcher centered on screen (or monitor for multi-head).

* Vertical list with two columns:
	1. Window class.
	2. Window title.

* Controls like dmenu:
	* Type to filter windows.
    * Tokonized filter. Type any word in any order to filter.
	* Arrows to highlight selections.
	* Return to select.

* Rudimentary run dialog
    * Type to filter.
    * Tokonized filter. Type any word in any order to filter.
	* Arrows to highlight selections.
	* Return to select.
    * Shift-Return to run in terminal.

* Runs in background or once-off.

If compiled with I3 support, it should autodetect if I3 window manager is running. 

Usage
-----

e.g.

  bindsym $mod+Tab exec simpleswitcher -now -font "snap-10" -fg "#505050" -bg "#000000" -hlfg "#ffb964" -hlbg "#000000" -o 85

Switching Between Modi
----------------------

Type '?' (enter)  to switch from Window list mode to Run mode and back.

Compilation
-----------

Type `make I3=` to disable compiling with i3 support.
If during compilation it complains about not finding i3/ipc.h either disable i3 support
or install the headers.

Type `make PREFIX=<path> install` to install in a different prefix.

Archlinux
---------

This version of simpleswitcher has been made available on the
[AUR](https://aur.archlinux.org/packages/simpleswitcher-dd-git/) by 1ace.