mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-11 13:50:48 -05:00
240 lines
8.6 KiB
Markdown
240 lines
8.6 KiB
Markdown
<p align="center">
|
|
<a href="https://github.com/davatorium/rofi/issues"><img src="https://img.shields.io/github/issues/davatorium/rofi.svg"></a>
|
|
<a href="https://img.shields.io/github/forks/davatorium/rofi.svg"><img src="https://img.shields.io/github/forks/davatorium/rofi.svg"></a>
|
|
<a href="https://github.com/davatorium/rofi/stargazers"><img src="https://img.shields.io/github/stars/davatorium/rofi.svg"></a>
|
|
<a href="https://github.com/davatorium/rofi/releases"><img src="https://img.shields.io/github/downloads/davatorium/rofi/total.svg"></a>
|
|
<a href="https://repology.org/metapackage/rofi/versions"><img src="https://repology.org/badge/tiny-repos/rofi.svg"></a>
|
|
</p>
|
|
|
|
|
|
# Please match the documentation and example scripts to the version of rofi used:
|
|
|
|
* [next version](https://github.com/davatorium/rofi)
|
|
* [1.7.5](https://github.com/davatorium/rofi/tree/1.7.5)
|
|
* [1.7.4](https://github.com/davatorium/rofi/tree/1.7.4)
|
|
* [1.7.3](https://github.com/davatorium/rofi/tree/1.7.3)
|
|
* [1.7.2](https://github.com/davatorium/rofi/tree/1.7.2)
|
|
* [1.7.1](https://github.com/davatorium/rofi/tree/1.7.1)
|
|
* [1.7.0](https://github.com/davatorium/rofi/tree/1.7.0)
|
|
|
|
Also see the locally installed documentation (manpages).
|
|
|
|
|
|
<h1 align="center">
|
|
Rofi
|
|
</h1>
|
|
<p align="center"><i>A window switcher, Application launcher and dmenu replacement</i>.</p>
|
|
|
|
https://user-images.githubusercontent.com/84911063/139428874-fe182dd6-82c6-49b8-8da1-920ddda3d1ed.mp4
|
|
|
|
|
|
**Rofi** started as a clone of simpleswitcher, written by [Sean Pringle](http://github.com/seanpringle/simpleswitcher) - a
|
|
popup window switcher roughly based on [superswitcher](http://code.google.com/p/superswitcher/).
|
|
Simpleswitcher laid the foundations, and therefore Sean Pringle deserves most of the credit for this tool. **Rofi**
|
|
(renamed, as it lost the *simple* property) has been extended with extra features, like an application launcher and
|
|
ssh-launcher, and can act as a drop-in dmenu replacement, making it a very versatile tool.
|
|
|
|
**Rofi**, like dmenu, will provide the user with a textual list of options where one or more can be selected.
|
|
This can either be running an application, selecting a window, or options provided by an external script.
|
|
|
|
|
|
## What is rofi not?
|
|
|
|
Rofi is not:
|
|
|
|
* 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.
|
|
* Specific functionality can be added using scripts or plugins, many exists.
|
|
* Just a dmenu replacement. The dmenu functionality is a nice 'extra' to
|
|
**rofi**, not its main purpose.
|
|
|
|
|
|
# Table of Contents
|
|
|
|
- [Features](#features)
|
|
- [Modes](#modes)
|
|
- [Manpages](#manpage)
|
|
- [Installation](#installation)
|
|
- [Quickstart](#quickstart)
|
|
- [Usage](#usage)
|
|
- [Configuration](#configuration)
|
|
- [Themes](#themes)
|
|
- [Screenshots](#screenshots)
|
|
- [Wiki](#wiki)
|
|
- [Discussion places](#discussion-places)
|
|
|
|
# Features
|
|
|
|
Its main features are:
|
|
|
|
* Fully configurable keyboard navigation
|
|
* Type to filter
|
|
* Tokenized: type any word in any order to filter
|
|
* Case insensitive (togglable)
|
|
* Support for fuzzy-, regex-, prefix-, 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
|
|
* Work arounds for i3,bspwm
|
|
* Application launcher
|
|
* Desktop file application launcher
|
|
* SSH launcher mode
|
|
* File browser
|
|
* 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)
|
|
* Levenshtein distance or fzf like sorting of matches (optional)
|
|
* Drop-in dmenu replacement
|
|
* Many added improvements
|
|
* Easily extensible using scripts and plugins
|
|
* Advanced Theming
|
|
|
|
# Modes
|
|
|
|
**Rofi** has several built-in modes implementing common use cases and can be extended by scripts (either called from
|
|
**Rofi** or calling **Rofi**) or plugins.
|
|
|
|
Below is a list of the different modes:
|
|
|
|
* **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.
|
|
* **filebrowser**: A basic file-browser for opening files.
|
|
* **keys**: list internal keybindings.
|
|
* **script**: Write (limited) custom mode using simple scripts.
|
|
* **combi**: Combine multiple modes into one.
|
|
|
|
**Rofi** is known to work on Linux and BSD.
|
|
|
|
# Manpage
|
|
|
|
For more up to date information, please see the manpages. The other sections
|
|
and links might have outdated information as they have relatively less
|
|
maintainance than the manpages. So, if you come across any issues please
|
|
consult manpages, [discussion](https://github.com/davatorium/rofi/discussions)
|
|
and [issue tracker](https://github.com/davatorium/rofi/issues?q=) before filing
|
|
new issue.
|
|
|
|
* Manpages:
|
|
* [rofi](doc/rofi.1.markdown)
|
|
* [rofi-theme](doc/rofi-theme.5.markdown)
|
|
* [rofi-debugging](doc/rofi-debugging.5.markdown)
|
|
* [rofi-script](doc/rofi-script.5.markdown)
|
|
* [rofi-theme-selector](doc/rofi-theme-selector.1.markdown)
|
|
* [rofi-keys](doc/rofi-keys.5.markdown)
|
|
* [rofi-dmenu](doc/rofi-dmenu.5.markdown)
|
|
|
|
# Installation
|
|
|
|
Please see the [installation
|
|
guide](https://github.com/davatorium/rofi/blob/next/INSTALL.md) for
|
|
instructions on how to install **Rofi**.
|
|
|
|
# Quickstart
|
|
|
|
## Usage
|
|
|
|
> **This section just gives a brief overview of the various options. To get the full set of options see the [manpages](#manpage) section above**
|
|
|
|
#### Running rofi
|
|
|
|
To launch **rofi** directly in a certain mode, specify a mode with `rofi -show <mode>`.
|
|
To show the `run` dialog:
|
|
|
|
rofi -show run
|
|
|
|
Or get the options from a script:
|
|
|
|
~/my_script.sh | rofi -dmenu
|
|
|
|
Specify an ordered, comma-separated list of modes to enable.
|
|
Enabled modes can be changed at runtime. Default key is `Ctrl+Tab`.
|
|
If no modes are specified, all configured modes will be enabled.
|
|
To only show the `run` and `ssh` launcher:
|
|
|
|
rofi -modes "run,ssh" -show run
|
|
|
|
|
|
The modes to combine in combi mode.
|
|
For syntax to `-combi-modes `, see `-modes`.
|
|
To get one merge view, of `window`,`run`, and `ssh`:
|
|
|
|
rofi -show combi -combi-modes "window,run,ssh" -modes combi
|
|
|
|
## Configuration
|
|
|
|
Generate a default configuration file
|
|
|
|
```
|
|
mkdir -p ~/.config/rofi
|
|
rofi -dump-config > ~/.config/rofi/config.rasi
|
|
```
|
|
|
|
This creates a file called `config.rasi` in the `~/.config/rofi/` folder. You can modify this file to set configuration settings and modify themes. `config.rasi` is the file rofi looks to by default.
|
|
|
|
Please see the [configuration
|
|
guide](https://github.com/davatorium/rofi/blob/next/CONFIG.md) for a summary of
|
|
configuration options. More detailed options are provided in the manpages.
|
|
|
|
## Themes
|
|
|
|
Please see the [themes
|
|
manpages](https://github.com/davatorium/rofi/blob/next/doc/rofi-theme.5.markdown)
|
|
for a detailed description.
|
|
|
|
|
|
The latest bundled themes can be found
|
|
[here](https://github.com/davatorium/rofi/tree/next/themes).
|
|
|
|
# Screenshots
|
|
|
|
Rezlooks:
|
|
|
|
|
|
|
|
Arthur:
|
|
|
|
|
|
|
|
Default theme:
|
|
|
|
|
|
|
|
# Wiki
|
|
|
|
| ❗ **The Wiki is currently unmaintained and might contain outdated data ** |
|
|
| --- |
|
|
|
|
[Go to wiki](https://github.com/davatorium/rofi/wiki) .
|
|
|
|
#### Contents
|
|
|
|
* [User scripts](https://github.com/davatorium/rofi/wiki/User-scripts)
|
|
* [Examples](https://github.com/davatorium/rofi/wiki#examples)
|
|
* [dmenu Specs](https://github.com/davatorium/rofi/wiki/dmenu_specs)
|
|
* [mode Specs](https://github.com/davatorium/rofi/wiki/mode-Specs)
|
|
* [F.A.Q.](https://github.com/davatorium/rofi/wiki/Frequently-Asked-Questions).
|
|
* [Script mode](https://github.com/davatorium/rofi/wiki/rfc-script-mode)
|
|
* [Creating an issue](https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUTING.md)
|
|
* [Creating a Pull request](https://github.com/davatorium/rofi/wiki/Creating-a-pull-request)
|
|
|
|
# Discussion places:
|
|
|
|
The [GitHub Discussions](https://github.com/davatorium/rofi/discussions) is the preferred location
|
|
for discussions.
|
|
|
|
* [GitHub Discussions](https://github.com/davatorium/rofi/discussions)
|
|
* IRC (#rofi on irc.libera.chat)
|
|
* [Reddit](https://reddit.com/r/qtools/)
|
|
|
|
|
|
## Stargazers over time
|
|
|
|
[](https://starchart.cc/davatorium/rofi)
|