summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 5bcbdc7e02852220da0f3971d2b58ccda853d4cd (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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# Rofi 

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 rofi -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
-----------

    autoreconf --install
    ./configure
    make
    make install

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 rofi has been made available on the
[AUR](https://aur.archlinux.org/packages/rofi-git/).

Contact
-------

Issues, feature requests can be filed at the github [issue
tracker](https://github.com/DaveDavenport/rofi/issues).

If you need to ask a direct question or get support installing, please find us on IRC: #gmpc on
[freenode.net](https://webchat.freenode.net/?channels=#gmpc).