2021-01-17 10:36:51 -05:00
|
|
|
[](https://app.codacy.com/app/davatorium/rofi?utm_source=github.com\&utm_medium=referral\&utm_content=davatorium/rofi\&utm_campaign=Badge_Grade_Settings)
|
2019-05-14 05:52:21 -04:00
|
|
|
[](https://travis-ci.org/davatorium/rofi)
|
|
|
|
|
[](https://codecov.io/github/davatorium/rofi?branch=master)
|
|
|
|
|
[](https://github.com/davatorium/rofi/issues)
|
|
|
|
|
[](https://github.com/davatorium/rofi/network)
|
|
|
|
|
[](https://github.com/davatorium/rofi/stargazers)
|
|
|
|
|
[](https://github.com/davatorium/rofi/releases)
|
2016-10-17 14:58:50 -04:00
|
|
|
[](https://scan.coverity.com/projects/davedavenport-rofi)
|
2017-04-11 03:06:11 -04:00
|
|
|
[](https://reddit.com/r/qtools/)
|
2021-01-17 10:36:51 -05:00
|
|
|
[](https://repology.org/metapackage/rofi/versions)
|
2015-12-31 15:33:20 -05:00
|
|
|
|
2017-03-24 04:51:57 -04:00
|
|
|
# A window switcher, Application launcher and dmenu replacement
|
2014-08-28 15:36:53 -04:00
|
|
|
|
2019-01-02 04:51:59 -05:00
|
|
|
**Rofi** started as a clone of simpleswitcher, written by [Sean Pringle](http://github.com/seanpringle/simpleswitcher) - a
|
2016-12-07 12:20:05 -05:00
|
|
|
popup window switcher roughly based on [superswitcher](http://code.google.com/p/superswitcher/).
|
2019-01-02 04:51:59 -05:00
|
|
|
Simpleswitcher laid the foundations, and therefore Sean Pringle deserves most of the credit for this tool. **Rofi**
|
2021-01-17 10:36:51 -05:00
|
|
|
(renamed, as it lost the *simple* property) has been extended with extra features, like an application launcher and
|
2019-01-02 04:51:59 -05:00
|
|
|
ssh-launcher, and can act as a drop-in dmenu replacement, making it a very versatile tool.
|
2016-07-04 11:29:58 -04:00
|
|
|
|
|
|
|
|
**Rofi**, like dmenu, will provide the user with a textual list of options where one or more can be selected.
|
2019-01-02 04:51:59 -05:00
|
|
|
This can either be running an application, selecting a window, or options provided by an external script.
|
2015-01-20 17:34:53 -05:00
|
|
|
|
2017-07-31 08:30:05 -04:00
|
|
|
Its main features are:
|
|
|
|
|
|
2021-01-17 10:36:51 -05:00
|
|
|
* Fully configurable keyboard navigation
|
|
|
|
|
* Type to filter
|
|
|
|
|
* Tokenized: type any word in any order to filter
|
|
|
|
|
* Case insensitive (togglable)
|
|
|
|
|
* Support for fuzzy-, regex-, and glob matching
|
|
|
|
|
* UTF-8 enabled
|
|
|
|
|
* UTF-8-aware string collating
|
|
|
|
|
* International keyboard support (\`e -> è)
|
|
|
|
|
* RTL language support
|
|
|
|
|
* Cairo drawing and Pango font rendering
|
|
|
|
|
* Built-in modes:
|
|
|
|
|
* Window switcher mode
|
|
|
|
|
* EWMH compatible WM
|
|
|
|
|
* Application launcher
|
|
|
|
|
* Desktop file application launcher
|
|
|
|
|
* SSH launcher mode
|
|
|
|
|
* Combi mode, allowing several modes to be merged into one list
|
|
|
|
|
* History-based ordering — last 25 choices are ordered on top based on use (optional)
|
2021-05-04 13:40:45 -04:00
|
|
|
* Levenshtein distance or fzf like sorting of matches (optional)
|
2021-01-17 10:36:51 -05:00
|
|
|
* Drop-in dmenu replacement
|
|
|
|
|
* Many added improvements
|
2021-05-04 13:40:45 -04:00
|
|
|
* Easily extensible using scripts and plugins
|
|
|
|
|
* Advanced Theming
|
2017-07-31 08:30:05 -04:00
|
|
|
|
2021-04-22 05:10:28 -04:00
|
|
|
**Rofi** has several built-in modi implementing common use cases and can be extended by scripts (either called from
|
2021-05-04 13:40:45 -04:00
|
|
|
**Rofi** or calling **Rofi**) or plugins.
|
2015-05-04 09:37:54 -04:00
|
|
|
|
2021-04-22 05:10:28 -04:00
|
|
|
Below is a list of the different modi:
|
2015-05-04 09:37:54 -04:00
|
|
|
|
2021-04-22 05:10:28 -04:00
|
|
|
* **run**: launch applications from $PATH, with option to launch in terminal.
|
|
|
|
|
* **drun**: launch applications based on desktop files. It tries to be compliant to the XDG standard.
|
|
|
|
|
* **window**: Switch between windows on an EWMH compatible window manager.
|
|
|
|
|
* **ssh**: Connect to a remote host via ssh.
|
|
|
|
|
* **file-browser**: A basic file-browser for opening files.
|
|
|
|
|
* **keys**: list internal keybindings.
|
|
|
|
|
* **script**: Write (limited) custom mode using simple scripts.
|
|
|
|
|
* **combi**: Combine multiple modi into one.
|
2015-05-04 09:37:54 -04:00
|
|
|
|
2021-04-22 05:10:28 -04:00
|
|
|
**Rofi** is known to work on Linux and BSD.
|
2017-03-24 04:51:57 -04:00
|
|
|
|
2021-05-04 11:29:03 -04:00
|
|
|
|
|
|
|
|
# Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2016-12-13 15:32:42 -05:00
|
|
|
# Manpage
|
|
|
|
|
|
2021-06-08 17:16:01 -04:00
|
|
|
For more up to date information, please see the manpages:
|
|
|
|
|
|
|
|
|
|
* Manpages:
|
|
|
|
|
* [rofi](doc/rofi.1.markdown)
|
|
|
|
|
* [rofi-theme](doc/rofi.5.markdown)
|
|
|
|
|
* [rofi-script](doc/rofi-script.5.markdown)
|
|
|
|
|
* [rofi-theme-selector](doc/rofi-theme-selector.1.markdown)
|
|
|
|
|
* Discussion places:
|
|
|
|
|
* [Reddit](https://reddit.com/r/qtools/)
|
|
|
|
|
* [GitHub Discussions](https://github.com/davatorium/rofi/discussions)
|
|
|
|
|
* IRC (#rofi on irc.libera.chat)
|
|
|
|
|
* [wiki](https://github.com/davatorium/rofi/wiki) (Currently unmaintained).
|
2015-05-04 09:37:54 -04:00
|
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
2019-05-14 05:52:21 -04:00
|
|
|
Please see the [installation guide](https://github.com/davatorium/rofi/blob/next/INSTALL.md) for instructions on how to
|
2016-07-04 11:29:58 -04:00
|
|
|
install **Rofi**.
|
2016-12-22 09:59:13 -05:00
|
|
|
|
|
|
|
|
# What is rofi not?
|
|
|
|
|
|
|
|
|
|
Rofi is not:
|
|
|
|
|
|
2021-01-17 10:36:51 -05:00
|
|
|
* A UI toolkit.
|
|
|
|
|
* A library to be used in other applications.
|
|
|
|
|
* An application that can support every possible use-case. It tries to be generic enough to be usable by everybody.
|
2021-06-08 17:16:01 -04:00
|
|
|
* Specific functionality can be added using scripts or plugins, many exists.
|
2021-01-17 10:36:51 -05:00
|
|
|
* Just a dmenu replacement. The dmenu functionality is a nice 'extra' to **rofi**, not its main purpose.
|
