.TH "ROFI" "" "August 2019" "" ""
.SH "NAME"
\fBROFI\fR
.SH NAME
.P
\fBrofi\fR \- A window switcher, application launcher, ssh dialog and dmenu replacement
.SH SYNOPSIS
.P
\fBrofi\fR [ \-show \fImode\fR ]|[ \-dmenu ]|[ \-e \fImsg\fR ] [ CONFIGURATION ]
.SH DESCRIPTION
.P
\fBrofi\fR is an X11 pop\-up window switcher, run dialog, dmenu replacement, and more\. It focuses on
being fast to use and have minimal distraction\. It supports keyboard and mouse navigation, type to
filter, tokenized search and more\.
.SH USAGE
.P
\fBrofi\fR\|'s main functionality is to assist in your workflow, allowing you to quickly switch
between windows, start applications or log into a remote machine via ssh\. There are different \fImodi\fR for different types of
actions\.
.P
\fBrofi\fR can also function as (drop\-in) replacement for \fBdmenu(1)\fR\|\.
.SS Running rofi
.P
To launch \fBrofi\fR directly in a certain mode, specify a mode with \fBrofi \-show <mode>\fP\|\.
To show the run dialog:
.P
.RS 2
.nf
rofi \-show run
.fi
.RE
.SS Emulating dmenu
.P
\fBrofi\fR can emulate \fBdmenu(1)\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fP flag\.
.P
The website for \fBdmenu\fP can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\|\.
.P
\fBrofi\fR does not aim to be 100% compatible with dmenu\. There are simply too many different flavors of dmenu\.
The idea is that the basic usage command\-line flags are obeyed, theme\-related flags are not\.
Besides, \fBrofi\fR offers some extended features (like multi\-select, highlighting, message bar, extra key bindings)\.
.SS Display Error message
.P
\fBrofi\fR error dialog can also be called from the command line\.
.P
.RS 2
.nf
rofi \-e "my message"
.fi
.RE
.P
Markup support can be enabled, see CONFIGURATION options\.
.SH CONFIGURATION
.P
There are currently three methods of setting configuration options (evaluated in order below):
.RS 0
.IP \(bu 2
System configuration file (for example \fB/etc/rofi\.conf\fP)\.
.IP \(bu 2
Xresources: A method of storing key values in the Xserver\. See
here \fIhttps://en\.wikipedia\.org/wiki/X_resources\fR for more information\.
.IP \(bu 2
Rasi theme file: The new \fItheme\fR format can be used to set configuration values\.
.IP \(bu 2
Configuration File: This uses the same format as the Xresources file\.
By default it looks in \fBXDG_USER_CONFIG_DIR\fP/rofi/config, but can be overridden on commandline\.
By default XDG_USER_CONFIG_DIR defaults to \fB$HOME/\.config\fP\|\. (See \fBrofi \-h\fP for current location)\.
This is the recommended way of configuring \fBrofi\fR\|\.
.IP \(bu 2
Command\-line options: Arguments passed to \fBrofi\fR\|\.
.RE
.P
\fBTIP\fR: To get a template config file run: \fBrofi \-dump\-xresources > rofi\-example\.config\fP\|\.
\fBNOTE\fR: In version 1\.4\.0 we support configuration in a new format, a config for this can be generated by: \fBrofi
\-dump\-config > config\.rasi\fP
\fBNOTE\fR: If you want to use the new configuration format, the config file should be named \fBconfig\.rasi\fP\|\.
.P
The Xresources file expects options starting with \fBrofi\.\fP followed by its name\. An example to set the number of lines:
.P
.RS 2
.nf
rofi\.lines: 10
.fi
.RE
.P
Command line options override settings from Xresources file\. The same option set as argument — prefixed with a '\-':
.P
.RS 2
.nf
rofi \-lines 10
.fi
.RE
.P
To get a list of available options formatted as Xresources entries, run:
.P
.RS 2
.nf
rofi \-dump\-xresources
.fi
.RE
.P
The configuration system supports the following types:
.RS 0
.IP \(bu 2
string
.IP \(bu 2
integer (signed and unsigned)
.IP \(bu 2
char
.IP \(bu 2
Boolean
.RE
.P
Boolean options have a non\-default command\-line syntax\. Example to enable option X:
.P
.RS 2
.nf
\-X
.fi
.RE
.P
To disable option X:
.P
.RS 2
.nf
\-no\-X
.fi
.RE
.P
Below is a list of the most important options:
.SS General
.P
\fB\-help\fP
.P
The help option shows the full list of commandline options and the current