.TH ROFI 1 rofi .SH NAME .PP rofi \- A window switcher, run dialog and dmenu replacement .SH SYNOPSIS .PP \fBrofi\fP [ \-width \fIpct_scr\fP ] [ \-lines \fIlines\fP ] [ \-columns \fIcolumns\fP ] [ \-font \fIpangofont\fP ] [ \-fg \fIcolor\fP ] [ \-fg\-urgent \fIcolor\fP ] [ \-fg\-active \fIcolor\fP ] [ \-bg\-urgent \fIcolor\fP ] [ \-bg\-active \fIcolor\fP ] [ \-bg \fIcolor\fP ] [ \-bgalt \fIcolor\fP ] [ \-hlfg \fIcolor\fP ] [ \-hlbg \fIcolor\fP ] [ \-key\-\fBmode\fP \fIcombo\fP ] [ \-terminal \fIterminal\fP ] [ \-location \fIposition\fP ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fP ] [ \-opacity \fIopacity%\fP ] [ \-display \fIdisplay\fP ] [ \-bc \fIcolor\fP ] [ \-bw \fIwidth\fP ] [ \-dmenu [ \-p \fIprompt\fP ] [ \-sep \fIseparator\fP ] [ \-l \fIselected line\fP ] ] [ \-ssh\-client \fIclient\fP ] [ \-ssh\-command \fIcommand\fP ] [ \-disable\-history ] [ \-levenshtein\-sort ] [ \-case\-sensitive ] [ \-show \fImode\fP ] [ \-modi \fImode1,mode2\fP ] [ \-eh \fIelement height\fP ] [ \-lazy\-filter\-limit \fIlimit\fP ] [ \-e \fImessage\fP] [ \-a \fIrow\fP ] [ \-u \fIrow\fP ] [ \-pid \fIpath\fP ] [ \-now ] [ \-rnow ] [ \-snow ] [ \-version ] [ \-help] [ \-dump\-xresources ] [ \-auto\-select ] [ \-parse\-hosts ] [ \-combi\-modi \fImode1,mode2\fP ] [ \-quiet ] .SH DESCRIPTION .PP \fBrofi\fP is an X11 popup window switcher, run dialog, dmenu replacement and more. It focusses on being fast to use and have minimal distraction. It supports keyboard and mouse navigation, type to filter, tokenized search and more. .SH License .PP MIT/X11 .SH USAGE .PP \fBrofi\fP can be used in three ways, single\-shot; executes once and directly exits when done, as a daemon listening to specific key\-combination or emulating dmenu. .SS Single\-shot mode .PP To launch \fBrofi\fP directly in a certain mode, specifying \fB\fCrofi \-show \fR\&. To show the run dialog: .PP .RS .nf rofi \-show run .fi .RE .SS Daemon mode .PP To launch \fBrofi\fP in daemon mode don't specify a mode to show (\fB\fC\-show \fR), instead you can bind keys to launch a certain mode. To have run mode open when pressing \fB\fCF2\fR start \fBrofi\fP like: .PP .RS .nf rofi \-key\-run F2 .fi .RE .PP Keybindings can also be specified in the \fB\fCXresources\fR file. .SS Emulating dmenu .PP \fBrofi\fP can emulate \fB\fCdmenu\fR (a dynamic menu for X) when launched with the \fB\fC\-dmenu\fR flag. .PP The official website for \fB\fCdmenu\fR can be found: \[la]http://tools.suckless.org/dmenu/\[ra] .SH OPTIONS .PP There are currently three methods of setting configuration options: .RS .IP \(bu 2 Compile time: edit config.c. This method is strongly discouraged. .IP \(bu 2 Xresources: A method of storing key values in the Xserver. See here \[la]https://en.wikipedia.org/wiki/X_resources\[ra] for more information. .IP \(bu 2 Commandline options: Arguments passed to \fBrofi\fP\&. .RE .PP The Xresources options and the commandline options are aliased. So to set option X you would set: .IP rofi.X: value .PP In the Xresources file, and to (override) this via the commandline you would pass the same key prefixed with a '\-': .PP .RS .nf rofi \-X value .fi .RE .PP To get a list of available options, formatted as Xresources entries run: .PP .RS .nf rofi \-dump\-xresources .fi .RE .PP The configuration system supports the following types: .RS .IP \(bu 2 String .IP \(bu 2 Integer (signed and unsigned) .IP \(bu 2 Char .IP \(bu 2 Boolean .RE .PP The boolean option has a non\-default commandline syntax, to enable option X you do: .PP \-X .PP to disable it: .PP \-no\-X .PP Below is a list of the most important options: .SS General .PP \fB\fC\-key\-{mode}\fR \fBKEY\fP .IP Set the key combination to display a {mode} in daemon mode. .PP .RS .nf rofi \-key\-run F12 rofi \-key\-ssh control+shift+s rofi \-key\-window mod1+Tab .fi .RE .PP \fB\fC\-dmenu\fR .IP Run rofi in dmenu mode. Allowing it to be used for user interaction in scripts. .IP In \fB\fCdmenu\fR mode, \fBrofi\fP will read input from STDIN, and will output to STDOUT by default. .IP Example to let the user choose between three pre\-defined options: .PP .RS .nf echo \-e "Option #1\\nOption #2\\nOption #3" | rofi \-dmenu .fi .RE .IP Or get the options from a script: .PP .RS .nf ~/my_script.sh | rofi \-dmenu .fi .RE .IP Pressing \fB\fCshift\-enter\fR will open the selected entries and move to the next entry. .PP \fB\fC\-show\fR \fImode\fP .IP Open rofi in a certain mode. .IP For example to show the run\-dialog: .PP .RS .nf rofi \-show run .fi .RE .IP This function deprecates \-rnow,\-snow and \-now .PP \fB\fC\-switchers\fR \fImode1,mode1\fP \fB\fC\-modi\fR \fImode1,mode1\fP .IP Give a comma separated list of modes to enable, in what order. .IP For example to only show the run and ssh launcher (in that order): .PP .RS .nf rofi \-modi "run,ssh" \-show run .fi .RE .IP Custom modes can be added using the internal 'script' mode. Each mode has two parameters: .PP .RS .nf :