.TH ROFI 1 rofi .SH NAME .PP rofi \- A window switcher, run dialog and dmenu replacement .SH SYNOPSIS .PP \fB\fCrofi\fR [ \-width \fIpct_scr\fP ] [ \-lines \fIlines\fP ] [ \-columns \fIcolumns\fP ] [ \-font \fIxftfont\fP ] [ \-fg \fIcolor\fP ] [ \-bg \fIcolor\fP ] [ \-hlfg \fIcolor\fP ] [ \-hlbg \fIcolor\fP ] [ \-key \fIcombo\fP ] [ \-dkey \fIcomdo\fP ] [ \-rkey \fIcomdo\fP ] [ \-terminal \fIterminal\fP ] [ \-location \fIposition\fP ] [ \-hmode ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fP ] [ \-opacity \fIopacity%\fP ] [ \-display \fIdisplay\fP ] [ \-bc \fIcolor\fP ] [ \-bw \fIwidth\fP ] [ \-dmenu [ \-p \fIprompt\fP ] ] [ \-ssh\-set\-title \fItrue|false\fP ] [ \-now ] [ \-rnow ] [ \-snow ] [ \-version ] [ \-help] [ \-dump\-xresources ] [ \-disable\-history ] [ \-levenshtein\-sort ] [ \-show \fImode\fP ] [ \-switcher \fImode1,mode2\fP ] .SH DESCRIPTION .PP \fB\fCrofi\fR is an X11 popup window switcher. A list is displayed center\-screen showing open window titles, WM_CLASS, and desktop number. The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels. .SH License .PP MIT/X11 .SH USAGE .PP \fB\fCrofi\fR can be used in two ways, single\-shot; executes once and directly exits when done or as daemon listening to specific key\-combinations. .PP The default key combinations are: .RS .IP \(bu 2 \fB\fCF12\fR .RE .PP Show all windows on all desktops. .RS .IP \(bu 2 \fB\fCmod1\-F2\fR .RE .PP Show run\-dialog. .RS .IP \(bu 2 \fB\fCmod1\-F3\fR .RE .PP Show run\-dialog. .SH OPTIONS .PP \fB\fC\-key\fR .PP .RS .nf Change the key combination to display all windows (default: F12). rofi \-key F12 rofi \-key control+shift+s rofi \-key mod1+Tab .fi .RE .PP \fB\fC\-rkey\fR .PP .RS .nf Change the key combination to display the run dialog (default: mod1\-F2). rofi \-rkey F11 rofi \-rkey control+shift+d rofi \-rkey mod1+grave (grave=backtick) .fi .RE .PP \fB\fC\-skey\fR .PP .RS .nf Change the key combination to display the ssh dialog (default: Alt\-F3). rofi \-skey F10 rofi \-skey control+shift+s rofi \-skey mod1+grave (grave=backtick) .fi .RE .PP \fB\fC\-now\fR .PP .RS .nf Run rofi in all\-windows mode once then exit. Does not bind any keys. .fi .RE .PP \fB\fC\-rnow\fR .PP .RS .nf Run rofi in run\-dialog mode once then exit. Does not bind any keys. .fi .RE .PP \fB\fC\-snow\fR .PP .RS .nf Run rofi in ssh mode once then exit. Does not bind any keys. .fi .RE .PP \fB\fC\-bg\fR .PP .RS .nf Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222). rofi \-fg "#222222" .fi .RE .PP \fB\fC\-bc\fR .PP .RS .nf Set the border color (X11 named color or hex #rrggbb) for the menu (default: #000000). rofi \-bc black .fi .RE .PP \fB\fC\-bw\fR .PP .RS .nf Set the border width in pixels (default: 1). rofi \-bw 1 .fi .RE .PP \fB\fC\-fg\fR .PP .RS .nf Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc). rofi \-fg "#cccccc" .fi .RE .PP \fB\fC\-font\fR .PP .RS .nf Xft font name for use by the menu (default: mono\-14). rofi \-font monospace\-14:medium .fi .RE .PP \fB\fC\-hlbg\fR .PP .RS .nf Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #005577). rofi \-fg "#005577" .fi .RE .PP \fB\fC\-hlfg\fR .PP .RS .nf Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #ffffff). rofi \-fg "#ffffff" .fi .RE .PP \fB\fC\-opacity\fR .PP .RS .nf Set the window opacity (0\-100). rofi \-opacity "75" .fi .RE .PP \fB\fC\-lines\fR .PP .RS .nf Maximum number of lines the menu may show before scrolling (default: 25). rofi \-lines 25 .fi .RE .PP \fB\fC\-columns\fR .PP .RS .nf The number of columns the menu may show before scrolling (default: 25). rofi \-columns 2 .fi .RE .PP \fB\fC\-width\fR .PP .RS .nf Set the width of the menu as a percentage of the screen width (default: 60). rofi \-width 60 .fi .RE .PP \fB\fC\-terminal\fR .PP .RS .nf Specify what terminal to start (default x\-terminal\-emulator) rofi \-terminal xterm .fi .RE .PP \fB\fC\-location\fR .PP .RS .nf Specify where the window should be located. The numbers map to the following location on the monitor: 1 2 3 8 0 4 7 6 5 .fi .RE .PP \fB\fC\-hmode\fR .IP Switch to horizontal mode (ala dmenu). The number of elements is the number of \fB\fClines\fR times the number of \fB\fCcolumns\fR\&. .PP \fB\fC\-fixed\-num\-lines\fR .PP Keep a fixed number of visible lines (See the \fB\fC\-lines\fR option.) .PP \fB\fC\-padding\fR .PP .RS .nf Define the inner margin of the window. Default is 5 pixels. To make rofi look like dmenu: rofi \-hmode \-padding 0 .fi .RE .PP \fB\fC\-dmenu\fR .IP Run rofi in dmenu mode. Allowing it to be used for user interaction in scripts. .PP \fB\fC\-dump\-xresources\fR .IP Dump the current active configuration in xresources format to the command\-line. .PP \fB\fC\-ssh\-set\-title\fR \fItrue|false\fP .IP SSH dialogs tries to set 'ssh hostname' of the spawned terminal. Not all terminals support this. Default value is true. .PP \fB\fC\-disable\-history\fR .IP Disable history .PP \fB\fC\-levenshtein\-sort\fR .IP When searching sort the result based on levenshtein distance. .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 .IP Give a comma separated list of modes to enable, in what order. .IP For example to only show the run and ssh dialog (in that order): .PP .RS .nf rofi \-switchers "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 :