rofi-dmenu - Man Page
Rofi dmenu emulation
Description
To integrate rofi into scripts as simple selection dialogs, rofi supports emulating dmenu(1) (A dynamic menu for X11).
The website for dmenu
can be found here ⟨http://tools.suckless.org/dmenu/⟩.
rofi does not aim to be 100% compatible with dmenu
. There are simply too many flavors of dmenu
. The idea is that the basic usage command-line flags are obeyed, theme-related flags are not. Besides, rofi offers some extended features (like multi-select, highlighting, message bar, extra key bindings).
Basic Concept
In dmenu
mode, rofi reads data from standard in, splits them into separate entries and displays them. If the user selects a row, this is printed out to standard out, allowing the script to process it further.
By default separation of rows is done on new lines, making it easy to pipe the output a one application into rofi and the output of rofi into the next.
Usage
By launching rofi with the -dmenu
flag it will go into dmenu emulation mode.
ls | rofi -dmenu
Parsing Row Options
Extra options for individual rows can be also set. See the rofi-script(5) manpage for details; the syntax and supported features are identical.
Return Value
- 0: Row has been selected accepted by user.
- 1: User cancelled the selection.
- 10-28: Row accepted by custom keybinding.
See Also
rofi(1), rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-script(5), rofi-theme-selector(1), ascii(7)
Author
Qball Cow qball@gmpclient.org ⟨mailto:qball@gmpclient.org⟩
Rasmus Steinke rasi@xssn.at ⟨mailto:rasi@xssn.at⟩
Morgane Glidic sardemff7+rofi@sardemff7.net ⟨mailto:sardemff7+rofi@sardemff7.net⟩
Original code based on work by: Sean Pringle sean.pringle@gmail.com ⟨mailto:sean.pringle@gmail.com⟩
For a full list of authors, check the AUTHORS file.