Rofi: A window switcher, application launcher and dmenu replacement
Go to file
Qball Cow 7ec4bc8d4e Update readme, add it to distribution. 2014-03-18 08:40:23 +01:00
config Small fix forgot one header file entry. 2014-03-12 08:52:11 +01:00
doc Rename simpleswitcher to rofi. 2014-03-01 17:27:52 +01:00
include Remove profile. 2014-03-17 19:28:11 +01:00
source Remove unused header. 2014-03-18 00:05:38 +01:00
.gitignore Restructure a bit. 2014-01-19 14:18:42 +01:00
COPYING Use autotools (1) 2014-03-17 19:16:09 +01:00
Makefile.am Update readme, add it to distribution. 2014-03-18 08:40:23 +01:00
README.md Update readme, add it to distribution. 2014-03-18 08:40:23 +01:00
configure.ac Silence make a bit 2014-03-18 00:11:46 +01:00

README.md

Rofi

A popup window switcher roughly based on superswitcher, requiring only xlib and xft. This version is based on the version from Sean Pringle. All credit for this great tool should go to him.

Some of the features of rofi are:

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

  • Vertical list with two columns:

    1. Desktop number (optional, not shown in i3 mode)
    2. Window class.
    3. 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.
    • Favorites list.
  • Quickly ssh into remote machines

    • Parses ~/.ssh/config to find hosts.
  • Runs in background or once-off.

  • Drop in dmenu replacement.

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

If compiling from GIT, first run to generate the needed build files:

autoreconf --install

To build rofi, run the following steps:

mkdir build/
cd build/
../configure
make
make install

The build system will autodetect the i3 header file during compilation. If it fails, make sure you have i3/ipc.h installed. Check config.log for more information.

Dependencies

Rofi requires the following tools and libraries to be installed:

  • libx11
  • libxinerama
  • libxdg-basedir
  • libxft

Archlinux

This version of rofi has been made available on the AUR.

Contact

Issues, feature requests can be filed at the github issue tracker.

If you need to ask a direct question or get support installing, please find us on IRC: #gmpc on freenode.net.