DMENU DROP-IN REPLACEMENT¶

If argv[0] (calling command) is dmenu, rofi will start in dmenu mode. This way, it can be used as a drop-in replacement for dmenu. Just copy or symlink rofi to dmenu in $PATH.

ln -s /usr/bin/rofi /usr/bin/dmenu

DMENU VS SCRIPT MODE¶

Script mode is used to extend rofi, dmenu mode is used to extend a script. The two do share much of the same input format. Please see the rofi-script(5) manpage for more information.

DMENU SPECIFIC COMMANDLINE FLAGS¶

A lot of these options can also be modified by the script using special input. See the rofi-script(5) manpage for more information about this syntax.

-sep separator

Separator for dmenu. Example: To show a list of 'a' to 'e' with '|' as a separator:

echo "a|b|c|d|e" | rofi -sep '|' -dmenu

-p prompt

Specify the prompt to show in dmenu mode. For example, select 'monkey', a,b,c,d, or e.

echo "a|b|c|d|e" | rofi -sep '|' -dmenu -p "monkey"

Default: dmenu

-l number of lines to show

Maximum number of lines the menu may show before scrolling.

rofi -dmenu -l 25

Default: 15

-i

Makes dmenu searches case-insensitive

-a X

Active row, mark X as active. Where X is a comma-separated list of python(1)-style indices and ranges, e.g. indices start at 0, -1 refers to the last row with -2 preceding it, ranges are left-open and right-close, and so on. You can specify:

-u X

Urgent row, mark X as urgent. See -a option for details.

-only-match

Only return a selected item, do not allow custom entry. This mode always returns an entry. It will not return if no matching entry is selected.

-no-custom

Only return a selected item, do not allow custom entry. This mode returns directly when no entries given.

-format format

Allows the output of dmenu to be customized (N is the total number of input entries):

Default: 's'

-select string

Select first line that matches the given string

-mesg string

Add a message line below the filter entry box. Supports Pango markup. For more information on supported markup, see here ⟨https://docs.gtk.org/Pango/pango_markup.html⟩

-dump

Dump the filtered list to stdout and quit. This can be used to get the list as rofi would filter it. Use together with -filter command.

-input file

Reads from file instead of stdin.

-password

Hide the input text. This should not be considered secure!

-markup-rows

Tell rofi that DMenu input is Pango markup encoded, and should be rendered. See here ⟨https://developer.gnome.org/pygtk/stable/pango-markup-language.html⟩ for details about Pango markup.

-multi-select

Allow multiple lines to be selected. Adds a small selection indicator to the left of each entry.

-sync

Force rofi mode to first read all data from stdin before showing the selection window. This is original dmenu behavior.

Note: the default asynchronous mode will also be automatically disabled if used with conflicting options, such as -dump, -only-match or -auto-select.

-window-title title

Set name used for the window title. Will be shown as Rofi - title

-w windowid

Position rofi over the window with the given X11 window ID.

-keep-right

Set ellipsize mode to start. So, the end of the string is visible.

-display-columns

A comma seperated list of columns to show.

-display-column-separator

The column separator. This is a regex.

default: '\t'

-ballot-selected-str string

When multi-select is enabled, prefix this string when element is selected.

default: "☑ "

-ballot-unselected-str string

When multi-select is enabled, prefix this string when element is not selected.

default: "☐ "