2019-05-14 11:52:21 +02:00
|
|
|
[](https://github.com/davatorium/rofi/issues)
|
|
|
|
|
[](https://github.com/davatorium/rofi/network)
|
|
|
|
|
[](https://github.com/davatorium/rofi/stargazers)
|
|
|
|
|
[](https://github.com/davatorium/rofi/releases)
|
2021-08-20 16:09:09 +02:00
|
|
|
[](https://github.com/davatorium/rofi/discussions)
|
2021-01-17 16:36:51 +01:00
|
|
|
[](https://repology.org/metapackage/rofi/versions)
|
2015-12-31 21:33:20 +01:00
|
|
|
|
2017-03-24 09:51:57 +01:00
|
|
|
# A window switcher, Application launcher and dmenu replacement
|
2014-08-28 21:36:53 +02:00
|
|
|
|
2019-01-02 09:51:59 +00:00
|
|
|
**Rofi** started as a clone of simpleswitcher, written by [Sean Pringle](http://github.com/seanpringle/simpleswitcher) - a
|
2016-12-07 18:20:05 +01:00
|
|
|
popup window switcher roughly based on [superswitcher](http://code.google.com/p/superswitcher/).
|
2019-01-02 09:51:59 +00:00
|
|
|
Simpleswitcher laid the foundations, and therefore Sean Pringle deserves most of the credit for this tool. **Rofi**
|
2021-01-17 16:36:51 +01:00
|
|
|
(renamed, as it lost the *simple* property) has been extended with extra features, like an application launcher and
|
2019-01-02 09:51:59 +00:00
|
|
|
ssh-launcher, and can act as a drop-in dmenu replacement, making it a very versatile tool.
|
2016-07-04 17:29:58 +02:00
|
|
|
|
|
|
|
|
**Rofi**, like dmenu, will provide the user with a textual list of options where one or more can be selected.
|
2019-01-02 09:51:59 +00:00
|
|
|
This can either be running an application, selecting a window, or options provided by an external script.
|
2015-01-20 23:34:53 +01:00
|
|
|
|
2017-07-31 14:30:05 +02:00
|
|
|
Its main features are:
|
|
|
|
|
|
2021-01-17 16:36:51 +01: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 19:40:45 +02:00
|
|
|
* Levenshtein distance or fzf like sorting of matches (optional)
|
2021-01-17 16:36:51 +01:00
|
|
|
* Drop-in dmenu replacement
|
|
|
|
|
* Many added improvements
|
2021-05-04 19:40:45 +02:00
|
|
|
* Easily extensible using scripts and plugins
|
|
|
|
|
* Advanced Theming
|
2017-07-31 14:30:05 +02:00
|
|
|
|
2021-04-22 11:10:28 +02:00
|
|
|
**Rofi** has several built-in modi implementing common use cases and can be extended by scripts (either called from
|
2021-05-04 19:40:45 +02:00
|
|
|
**Rofi** or calling **Rofi**) or plugins.
|
2015-05-04 15:37:54 +02:00
|
|
|
|
2021-04-22 11:10:28 +02:00
|
|
|
Below is a list of the different modi:
|
2015-05-04 15:37:54 +02:00
|
|
|
|
2021-04-22 11:10:28 +02: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 15:37:54 +02:00
|
|
|
|
2021-04-22 11:10:28 +02:00
|
|
|
**Rofi** is known to work on Linux and BSD.
|
2017-03-24 09:51:57 +01:00
|
|
|
|
2021-05-04 17:29:03 +02:00
|
|
|
|
|
|
|
|
# Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2016-12-13 21:32:42 +01:00
|
|
|
# Manpage
|
|
|
|
|
|
2021-06-08 23:16:01 +02:00
|
|
|
For more up to date information, please see the manpages:
|
|
|
|
|
|
|
|
|
|
* Manpages:
|
|
|
|
|
* [rofi](doc/rofi.1.markdown)
|
2021-08-15 12:02:07 -06:00
|
|
|
* [rofi-theme](doc/rofi-theme.5.markdown)
|
2021-06-08 23:16:01 +02:00
|
|
|
* [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 15:37:54 +02:00
|
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
2019-05-14 11:52:21 +02:00
|
|
|
Please see the [installation guide](https://github.com/davatorium/rofi/blob/next/INSTALL.md) for instructions on how to
|
2016-07-04 17:29:58 +02:00
|
|
|
install **Rofi**.
|
2016-12-22 15:59:13 +01:00
|
|
|
|
|
|
|
|
# What is rofi not?
|
|
|
|
|
|
|
|
|
|
Rofi is not:
|
|
|
|
|
|
2021-01-17 16:36:51 +01: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 23:16:01 +02:00
|
|
|
* Specific functionality can be added using scripts or plugins, many exists.
|
2021-01-17 16:36:51 +01:00
|
|
|
* Just a dmenu replacement. The dmenu functionality is a nice 'extra' to **rofi**, not its main purpose.
|
