.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "ROFI\-MANPAGE" "" "April 2016" "" ""
.
.SH "NAME"
\fBrofi\fR \- A window switcher, run launcher, ssh dialog and dmenu replacement
.
.SH "SYNOPSIS"
\fBrofi\fR [ \-width \fIpct_scr\fR ] [ \-lines \fIlines\fR ] [ \-columns \fIcolumns\fR ] [ \-font \fIpangofont\fR ] [ \-terminal \fIterminal\fR ] [ \-location \fIposition\fR ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fR ] [ \-opacity \fIopacity%\fR ] [ \-display \fIdisplay\fR ] [ \-bw \fIwidth\fR ] [ \-dmenu [ \-p \fIprompt\fR ] [ \-sep \fIseparator\fR ] [ \-l \fIselected line\fR ] [ \-mesg ] [ \-select ] [ \-input \fIinput\fR ] ] [ \-filter \fIfilter\fR ] [ \-ssh\-client \fIclient\fR ] [ \-ssh\-command \fIcommand\fR ] [ \-disable\-history ] [ \-levenshtein\-sort ] [ \-case\-sensitive ] [ \-show \fImode\fR ] [ \-modi \fImode1,mode2\fR ] [ \-eh \fIelement height\fR ] [ \-lazy\-filter\-limit \fIlimit\fR ] [ \-e \fImessage\fR] [ \-a \fIrow\fR ] [ \-u \fIrow\fR ] [ \-pid \fIpath\fR ] [ \-now ] [ \-rnow ] [ \-snow ] [ \-version ] [ \-help ] [ \-dump\-xresources ] [ \-dump\-xresources\-theme ] [ \-auto\-select ] [ \-parse\-hosts ] [ \-no\-parse\-known\-hosts ] [ \-combi\-modi \fImode1,mode2\fR ] [ \-normal\-window ] [ \-fake\-transparency ] [ \-glob ] [ \-regex ] [ \-tokenize ] [ \-threads \fInum\fR ] [ \-config \fIfilename\fR ]
.
.SH "DESCRIPTION"
\fBrofi\fR is an X11 popup 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"
\fBrofi\fR can be used in two ways, single\-shot (runs a mode then exits) or emulating dmenu\.
.
.SS "Single\-shot mode"
To launch \fBrofi\fR directly in a certain mode, specify a mode with \fBrofi \-show <mode>\fR\. To show the run dialog:
.
.IP "" 4
.
.nf
rofi \-show run
.
.fi
.
.IP "" 0
.
.SS "Emulating dmenu"
\fBrofi\fR can emulate \fBdmenu\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fR flag\.
.
.P
The official website for \fBdmenu\fR can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\.
.
.SH "OPTIONS"
There are currently three methods of setting configuration options (evaluated in order below):
.
.IP "\(bu" 4
Xresources: A method of storing key values in the Xserver\. See here \fIhttps://en\.wikipedia\.org/wiki/X_resources\fR for more information\. This is the recommended way of configuring \fBrofi\fR\.
.
.IP "\(bu" 4
Configuration File: This uses the same format as the Xresources file\. By default it looks in \fBXDG_USER_CONFIG_DIR\fR/rofi/config, but can be overriden on commandline\.
.
.IP "\(bu" 4
Command\-line options: Arguments passed to \fBrofi\fR\.
.
.IP "\(bu" 4
System configuration file (f\.e\. /etc/rofi\.conf)\.
.
.IP "" 0
.
.P
The Xresources file expects options starting with \fBrofi\.\fR followed by it\'s name\. An Example to set the number of lines:
.
.IP "" 4
.
.nf
rofi\.lines: 10
.
.fi
.
.IP "" 0
.
.P
Command line options override settings from Xresources file\. The same option set as argument: prefixed with a \'\-\':
.
.IP "" 4
.
.nf
rofi \-lines 10
.
.fi
.
.IP "" 0
.
.P
To get a list of available options, formatted as Xresources entries run:
.
.IP "" 4
.
.nf
rofi \-dump\-xresources
.
.fi
.
.IP "" 0
.
.P
The configuration system supports the following types:
.
.IP "\(bu" 4
String
.
.IP "\(bu" 4
Integer (signed and unsigned)
.
.IP "\(bu" 4
Char
.
.IP "\(bu" 4
Boolean
.
.IP "" 0
.
.P
Boolean options have a non\-default command\-line syntax\. Example to enable option X:
.
.IP "" 4
.
.nf