56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
---
|
|
obj: application
|
|
arch-wiki: https://wiki.archlinux.org/title/rofi
|
|
website: https://davatorium.github.io/rofi/
|
|
repo: https://github.com/davatorium/rofi
|
|
---
|
|
# Rofi
|
|
Rofi is a window switcher, run dialog, ssh-launcher and dmenu replacement that started as a clone of simpleswitcher, written by Sean Pringle and later expanded by Dave Davenport.
|
|
|
|
## Configuration
|
|
There are two methods of setting configuration options:
|
|
- Local configuration. Normally, depending on XDG, in `~/.config/rofi/config.rasi`.
|
|
- Command line options:
|
|
|
|
```shell
|
|
rofi -combi-modi window,drun,ssh -theme solarized -font "hack 10" -show combi
|
|
```
|
|
|
|
can be expressed in a configuration file like this:
|
|
```
|
|
configuration {
|
|
modi: "window,drun,ssh,combi";
|
|
font: "hack 10";
|
|
combi-modi: "window,drun,ssh";
|
|
}
|
|
@theme "solarized"
|
|
```
|
|
|
|
To get a full list of options for `config.rasi` file run `rofi -dump-config` or `rofi -h`. You can write the output of the command directly to your configuration file while running `rofi -dump-config > ~/.config/rofi/config.rasi`.
|
|
|
|
## Themes
|
|
The easiest way to get started theming rofi is by modifying your existing theme.
|
|
|
|
Themes can be modified/tweaked by adding theming elements to the end of the
|
|
config file. The default location of this file is `~/.config/rofi/config.rasi`, if the file does not exists, you can create it.
|
|
|
|
A basic config:
|
|
```
|
|
configuration {
|
|
modes: [ combi ];
|
|
combi-modes: [ window, drun, run ];
|
|
}
|
|
|
|
@theme "gruvbox-light"
|
|
|
|
/* Insert theme modifications after this */
|
|
```
|
|
|
|
For example if we want to change the `Type to filter` text in the entry box we append the following:
|
|
```css
|
|
entry {
|
|
placeholder: "Type here";
|
|
}
|
|
```
|
|
|
|
In the above section, `entry` indicates the widget, `placeholder` is the property we want to modify and we set it to the string `"Type here"`.
|