1ROFI(1) ROFI(1)
2
6 rofi - A window switcher, application launcher, ssh dialog and dmenu
7 replacement
8
10 rofi [ -show mode ]|[ -dmenu ]|[ -e msg ] [ CONFIGURATION ]
11
13 rofi is an X11 pop-up window switcher, run dialog, dmenu replacement,
14 and more. It focuses on being fast to use and have minimal distraction.
15 It supports keyboard and mouse navigation, type to filter, tokenized
16 search and more.
17
19 rofi´s main functionality is to assist in your workflow, allowing you
20 to quickly switch between windows, start applications or log into a
21 remote machine via ssh. There are different modi for different types of
22 actions.
23 rofi can also function as (drop-in) replacement for dmenu(1).
25 Running rofi
27 To launch rofi directly in a certain mode, specify a mode with rofi
28 -show <mode>. To show the run dialog:
29 rofi -show run
33 Emulating dmenu
37 rofi can emulate dmenu(1) (a dynamic menu for X) when launched with the
38 -dmenu flag.
39 The website for dmenu can be found here http://tools.suck‐
41 less.org/dmenu/.
42 rofi does not aim to be 100% compatible with dmenu. There are simply
44 too many different flavors of dmenu. The idea is that the basic usage
45 command-line flags are obeyed, theme-related flags are not. Besides,
46 rofi offers some extended features (like multi-select, highlighting,
47 message bar, extra key bindings).
48 Display Error message
50 rofi error dialog can also be called from the command line.
51 rofi -e "my message"
55 Markup support can be enabled, see CONFIGURATION options.
59
61 There are currently three methods of setting configuration options
62 (evaluated in order below):
63 · System configuration file (for example /etc/rofi.conf).
65 · Xresources: A method of storing key values in the Xserver. See here
67 https://en.wikipedia.org/wiki/X_resources for more information.
68 · Rasi theme file: The new theme format can be used to set configura‐
70 tion values.
71 · Configuration File: This uses the same format as the Xresources
73 file. By default it looks in XDG_USER_CONFIG_DIR/rofi/config, but
74 can be overridden on commandline. By default XDG_USER_CONFIG_DIR
75 defaults to $HOME/.config. (See rofi -h for current location). This
76 is the recommended way of configuring rofi.
77 · Command-line options: Arguments passed to rofi.
79 TIP: To get a template config file run: rofi -dump-xresources >
83 rofi-example.config. NOTE: In version 1.4.0 we support configuration in
84 a new format, a config for this can be generated by: rofi -dump-config
85 > config.rasi NOTE: If you want to use the new configuration format,
86 the config file should be named config.rasi.
87 The Xresources file expects options starting with rofi. followed by its
89 name. An example to set the number of lines:
90 rofi.lines: 10
94 Command line options override settings from Xresources file. The same
98 option set as argument — prefixed with a ´-´:
99 rofi -lines 10
103 To get a list of available options formatted as Xresources entries,
107 run:
108 rofi -dump-xresources
112 The configuration system supports the following types:
116 · string
118 · integer (signed and unsigned)
120 · char
122 · Boolean
124 Boolean options have a non-default command-line syntax. Example to
128 enable option X:
129 -X
133 To disable option X:
137 -no-X
141 Below is a list of the most important options:
145 General
147 -help
148 The help option shows the full list of commandline options and the cur‐
150 rent set value. These include dynamic (run-time generated) options.
151 -dump-xresources
153 Dump the current active configuration in Xresources format to the com‐
155 mand-line. This does not validate all passed values (for example, col‐
156 ors).
157 -threads num
159 Specify the number of threads rofi should use:
161 · 0: Autodetect the number of supported hardware threads.
163 · 1: Disable threading
165 · 2..N: Specify the maximum number of threads to use in the thread
167 pool.
168 -dmenu
172 Run rofi in dmenu mode. This allows for interactive scripts. In dmenu
174 mode, rofi reads from STDIN, and output to STDOUT. A simple example,
175 displaying three pre-defined options:
176 echo -e "Option #1\nOption #2\nOption #3" | rofi -dmenu
180 Or get the options from a script:
184 ~/my_script.sh | rofi -dmenu
188 -show mode
192 Open rofi in a certain mode. Available modes are window, run, drun,
194 ssh, combi. The special argument keys can be used to open a searchable
195 list of supported key bindings (see KEY BINDINGS)
196 To show the run-dialog:
198 rofi -show run
202 -modi mode1,mode1
206 Specify an ordered, comma-separated list of modes to enable. Enabled
208 modes can be changed at runtime. Default key is Ctrl+Tab. If no modes
209 are specified, all modes will be enabled. To only show the run and ssh
210 launcher:
211 rofi -modi "run,ssh" -show run
215 Custom modes can be added using the internal ´script´ mode. Each mode
219 has two parameters:
220 <name>:<script>
224 Example: Have a mode ´Workspaces´ using the i3_switch_workspaces.sh
228 script:
229 rofi -modi "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
233 Notes: The I3 Window manager does not like commas in the command when
237 specifying an exec command. For that case ´#´ can be used as an separa‐
238 tor.
239 -case-sensitive
241 Start in case sensitive mode. This option can be changed at run-time
243 using the -kb-toggle-case-sensitivity key binding.
244 -cycle
246 Cycle through the result list. Default is ´true´.
248 -filter filter
250 Filter the list by setting text in input bar to filter
252 -config filename
254 Load an alternative configuration file.
256 -cache-dir filename
258 Directory that is used to place temporary files, like history.
260 -scroll-method method
262 Select the scrolling method. 0: Per page, 1: continuous.
264 -[no-]show-match
266 Show the indicator that shows what part of the string is matched.
268 Default: *true*
272 -no-lazy-grab
276 Disables lazy grab, this forces the keyboard being grabbed before gui
278 is shown.
279 -no-plugins
281 Disable plugin loading.
283 -plugin-path directory
285 Specify the directory where rofi should look for plugins.
287 -show-icons
289 Show application icons in drun and window modes.
291 -icon-theme
293 Specify icon theme to be used. If not specified default theme from DE
295 is used, Adwaita and gnome themes act as fallback themes.
296 Matching
298 -matching method
299 Specify the matching algorithm used. Current the following methods are
301 supported.
302 · normal: match the int string
304 · regex: match a regex input
306 · glob: match a glob pattern
308 · fuzzy: do a fuzzy match
310 Default: normal
312 Note: glob matching might be slow for larger lists
316 -tokenize
318 Tokenize the input.
320 -drun-match-fields field1,field2,...
322 When using drun, match only with the specified Desktop entry fields.
324 The different fields are:
325 · name: the application´s name
327 · generic: the application´s generic name
329 · exec: the application´s executable
331 · categories: the application´s categories
333 · comment: the application comment
335 · all: all of the above
337 Default: name,generic,exec,categories
339 -drun-display-format
343 The format string for the drun dialog:
345 · name: the application´s name
347 · generic: the application´s generic name
349 · exec: the application´s executable
351 · categories: the application´s categories
353 · comment: the application comment
355 Pango markup can be used to formatting the output.
359 Default: {name} [<span weight=´light´ size=´small´><i>({generic})</i></span>]
363 Note: Only fields enabled in -drun-match-fields can be used in the for‐
367 mat string.
368 -[no-]drun-show-actions
370 Show actions present in the Desktop files.
372 Default: false
376 -window-match-fields field1,field2,...
380 When using window mode, match only with the specified fields. The dif‐
382 ferent fields are:
383 · title: window´s title
385 · class: window´s class
387 · role: window´s role
389 · name: window´s name
391 · desktop: window´s current desktop
393 · all: all of the above
395 Default: all
397 -matching-negate-char char
401 Set the character used to negate the query (i.e. if it does not match
403 the next keyword ). Set to ´\x0´ to disable.
404 Default: ´-´
408 Layout
412 Most of the following options are deprecated and should not be used.
413 Please use the new theme format to customize rofi. More information
414 about the new format can be found in the rofi-theme(5) manpage.
415 -lines
417 Maximum number of lines to show before scrolling.
419 rofi -lines 25
423 Default: 15
427 -columns
429 Number of columns to show before scrolling.
431 rofi -columns 2
435 Default: 1
439 -width [value]
441 Set width of menu. [value] is specified in percentage.
443 rofi -width 60
447 If [value] is larger then 100, size is set in pixels. Example to span a
451 full-HD monitor:
452 rofi -width 1920
456 If [value] is negative, it tries to estimates a character width. To
460 show 30 characters in a row:
461 rofi -width -30
465 Character width is a rough estimate, and might not be correct, but
469 should work for most monospaced fonts.
470 Default: 50
472 -location
474 Specify where the window should be located. The numbers map to the fol‐
476 lowing locations on screen:
477 1 2 3
481 8 0 4
482 7 6 5
483 Default: 0
487 -fixed-num-lines
489 Keep a fixed number of visible lines (See the -lines option.)
491 -padding
493 Define the inner margin of the window.
495 Default: 5
497 -fullscreen
499 Use the full-screen height and width.
501 -sidebar-mode
503 Open in sidebar-mode. In this mode a list of all enabled modes is shown
505 at the bottom. (See -modi option) To show sidebar, use:
506 rofi -show run -sidebar-mode -lines 0
510 -auto-select
514 When one entry is left, automatically select it.
516 -m num
518 -m name
520 -monitor num
522 -monitor name
524 Select monitor to display rofi on. It accepts as input: primary (if
526 primary output is set), the xrandr output name, or integer number (in
527 order of detection). Negative numbers are handled differently:
528 · -1: the currently focused monitor.
530 · -2: the currently focused window (that is, rofi will be displayed
532 on top of the focused window).
533 · -3: Position at mouse (overrides the location setting to get normal
535 context menu behavior.)
536 · -4: the monitor with the focused window.
538 · -5: the monitor that shows the mouse pointer.
540 Default: -5
542 See rofi -h output for the detected monitors, their position, and size.
546 -theme filename
548 Path to the new theme file format. This overrides the old theme set‐
550 tings.
551 -theme-str string
553 Allow theme parts to be specified on the command line as an override.
555 For example:
557 rofi -theme-str ´#window { fullscreen: true; }´
561 This option can be specified multiple times.
565 -dpi number
567 Override the default DPI setting. If set to 0, it tries to auto-detect
569 based on X11 screen size (similar to i3 and GTK). If set to 1, it tries
570 to auto-detect based on the size of the monitor that rofi is displayed
571 on (similar to latest Qt 5).
572 PATTERN setting
574 -terminal
575 Specify which terminal to start.
577 rofi -terminal xterm
581 Pattern: {terminal} Default: x-terminal-emulator
585 -ssh-client client
587 Override the used ssh client.
589 Pattern: {ssh-client} Default: ssh
591 SSH settings
593 -ssh-command cmd
594 Set the command to execute when starting a ssh session. The pattern
596 {host} is replaced by the selected ssh entry.
597 Pattern: {ssh-client} Default: {terminal} -e {ssh-client} {host}
599 -parse-hosts
601 Parse the /etc/hosts file for entries.
603 Default: disabled
605 -parse-known-hosts -no-parse-known-hosts
607 Parse the ~/.ssh/known_hosts file for entries.
609 Default: enabled
611 Run settings
613 -run-command cmd
614 Set command ({cmd}) to execute when running an application. See PAT‐
616 TERN.
617 Default: {cmd}
619 -run-shell-command cmd
621 Set command to execute when running an application in a shell. See PAT‐
623 TERN.
624 Default: {terminal} -e {cmd}
626 -run-list-command cmd
628 If set, use an external tool to generate list of executable commands.
630 Uses run-command.
631 Default: {cmd}
633 Window switcher settings
635 -window-format format
636 Format what is being displayed for windows.
638 format: {field[:len]}
640 field:
642 · w: desktop name
644 · t: title of window
646 · n: name
648 · r: role
650 · c: class
652 len: maximum field length (0 for auto-size). If length and window width
656 are negative, field length is width - len. if length is positive, the
657 entry will be truncated or padded to fill that length.
658 default: {w} {c} {t}
660 -window-command cmd
662 Set command to execute on selected window for a custom action. See PAT‐
664 TERN.
665 Default: "wmctrl -i -R {window}"
667 Combi settings
669 -combi-modi mode1,mode2
670 The modi to combine in combi mode. For syntax to see -modi. To get one
672 merge view, of window,run, and ssh:
673 rofi -show combi -combi-modi "window,run,ssh" -modi combi
677 Notes: The I3 Window manager does not like commas in the command when
681 specifying an exec command. For that case ´#´ can be used as a separa‐
682 tor.
683 History and Sorting
685 -disable-history -no-disable-history (re-enable history)
686 Disable history
688 -sort to enable -no-sort to disable
690 Enable, disable sorting. This setting can be changed at runtime (see
692 -kb-toggle-sort).
693 -sorting-method ´method´ to specify the sorting method.
695 There are 2 sorting method:
697 · levenshtein (Default)
699 · fzf sorting.
701 Dmenu specific
705 -sep separator
706 Separator for dmenu. Example: To show a list of ´a´ to ´e´ with ´|´ as
708 a separator:
709 echo "a|b|c|d|e" | rofi -sep ´|´ -dmenu
713 -p prompt
717 Specify the prompt to show in dmenu mode. For example, select ´monkey´,
719 a,b,c,d, or e.
720 echo "a|b|c|d|e" | rofi -sep ´|´ -dmenu -p "monkey:"
724 Default: dmenu
728 -selected-row selected row
730 Select a certain row.
732 Default: 0
734 -l number of lines to show
736 Maximum number of lines the menu may show before scrolling.
738 rofi -lines 25
742 Default: 15
746 -i
748 Makes dmenu searches case-insensitive
750 -a X
752 Active row, mark row X as active (starting at 0). You can specify sin‐
754 gle element: -a 3 A range: -a 3-8 or a set of rows: -a 0,2 or any com‐
755 bination: -a 0,2-3,9
756 -u X
758 Urgent row, mark row X as urgent (starting at 0). You can specify sin‐
760 gle element: -u 3 A range: -u 3-8 or a set of rows: -u 0,2 or any com‐
761 bination: -u 0,2-3,9
762 -only-match
764 Only return a selected item, do not allow custom entry. This mode
766 always returns an entry, or returns directly when no entries given.
767 -no-custom
769 Only return a selected item, do not allow custom entry. This mode
771 returns directly when no entries given.
772 -format format
774 Allows the output of dmenu to be customized (N is the total number of
776 input entries):
777 · ´s´ selected string
779 · ´i´ index (0 - (N-1))
781 · ´d´ index (1 - N)
783 · ´q´ quote string
785 · ´p´ Selected string stripped from pango markup (Needs to be a valid
787 string)
788 · ´f´ filter string (user input)
790 · ´F´ quoted filter string (user input)
792 Default: ´s´
796 -select string
798 Select first line that matches the given string
800 -mesg string
802 Add a message line below the filter entry box. Supports pango markup.
804 For more information on supported markup see here https://devel‐
805 oper.gnome.org/pango/stable/PangoMarkupFormat.html
806 -normal-window
808 Make rofi react like a normal application window. Useful for scripts
810 like Clerk that are basically an application.
811 -dump
813 Dump the filtered list to stdout and quit. This can be used to get the
815 list as rofi would filter it. Use together with -filter command.
816 -input file
818 Reads from file instead of stdin.
820 -password
822 Hide the input text. This should not be considered secure!
824 -markup-rows
826 Tell rofi that DMenu input is pango markup encoded, and should be ren‐
828 dered. See here https://developer.gnome.org/pango/stable/PangoMarkup‐
829 Format.html for details about pango markup.
830 -multi-select
832 Allow multiple lines to be selected. Adds a small selection indicator
834 to the left of each entry.
835 -sync
837 Force rofi mode to first read all data from stdin before showing the
839 selection window. This is original dmenu behavior.
840 Note: the default asynchronous mode will also be automatically disabled
842 if used with conflicting options, such as -dump, -only-match or
843 -auto-select.
844 -async-pre-read number
846 Reads the first 25 entries blocking, then switches to async mode. This
848 makes it feel more ´snappy´.
849 default: 25
851 Message dialog
853 -e message
854 Pops up a message dialog (used internally for showing errors) with mes‐
856 sage. Message can be multi-line.
857 Other
859 -pid path
860 Make rofi create a pid file and check this on startup. The pid file
862 prevents multiple rofi instances from running simultaneously. This is
863 useful when running rofi from a key-binding daemon.
864 -fake-transparency
866 Enable fake transparency. This only works with transparent background
868 color in the theme.
869 -fake-background
871 Select what to use as background for fake transparency. This can be
873 ´background´, ´screenshot´ or a path to an image file (currently only
874 supports png).
875 -display-{mode} string
877 Set the name to use for mode. This is used as prompt and in
879 combi-browser.
880 -click-to-exit -no-click-to-exit
882 Click the mouse outside of the rofi window to exit.
884 Default: enabled
886 Debug
888 -no-config
889 Disable parsing of configuration. This runs rofi in stock mode.
891 -no-plugins
893 Disables the loading of plugins.
895 To get a trace with (lots of) debug information, set the following
897 environment variable when executing rofi:
898 G_MESSAGES_DEBUG=all
902 The trace can be filtered by only outputting the relevant domains, for
906 example:
907 G_MESSAGES_DEBUG=Dialogs.DRun
911 For more information on debugging, see the wiki https://github.com/Dav‐
915 eDavenport/rofi/wiki/Debugging%20Rofi
916
918 To launch commands (for example, when using the ssh launcher), the user
919 can enter the used command-line. The following keys can be used that
920 will be replaced at runtime:
921 · {host}: the host to connect to
923 · {terminal}: the configured terminal (see -terminal-emulator)
925 · {ssh-client}: the configured ssh client (see -ssh-client)
927 · {cmd}: the command to execute
929 · {window}: the window ID of the selected window (in window-command)
931
935 If argv[0] (calling command) is dmenu, rofi will start in dmenu mode.
936 This way it can be used as a drop-in replacement for dmenu. Just copy
937 or symlink rofi to dmenu in $PATH.
938 ln -s /usr/bin/rofi /usr/bin/dmenu
942
946 The theme format below describes the old (pre version 1.4) theme for‐
947 mat. Please see rofi-theme(5) manpage for an updated manual.
948 The theme setup allows you to specify colors per state, similar to i3
950 Currently 3 states exist:
951 · normal: normal row
953 · urgent: highlighted row (urgent)
955 · active: highlighted row (active)
957 For each state, the following 5 colors must be set:
961 · bg: background color row
963 · fg: text color
965 · bgalt: background color alternating row
967 · hlfg: foreground color selected row
969 · hlbg: background color selected row
971 The window background and border color should be specified separately.
975 The key color-window contains a tuple background,border,separator. An
976 example for Xresources file:
977 ! State: ´bg´, ´fg´, ´bgalt´, ´hlbg´, ´hlfg´
981 rofi.color-normal: #fdf6e3, #002b36, #eee8d5, #586e75, #eee8d5
982 rofi.color-urgent: #fdf6e3, #dc322f, #eee8d5, #dc322f, #fdf6e3
983 rofi.color-active: #fdf6e3, #268bd2, #eee8d5, #268bd2, #fdf6e3
984 ! ´background´, ´border´, ´separator´
986 rofi.color-window: #fdf6e3, #002b36, #002b36
987 Same settings can also be specified on command-line:
991 rofi -color-normal "#fdf6e3,#002b36,#eee8d5,#586e75,#eee8d5"
995
999 RGB colors can be specified by either their X11 name or hexadecimal
1000 notation. For example:
1001 white
1005 Or:
1009 #FFFFFF
1013 ARGB colors are also supported. These can be used to create a transpar‐
1017 ent window if (1) your Xserver supports TrueColor, and (2) you are run‐
1018 ning a composite manager. For example: argb:FF444444
1019 Or:
1021 #FF444444
1025 The first two fields specify the alpha level. This determines the
1029 amount of transparency (00 everything, FF nothing). The other fields
1030 represent the actual color, in hex.
1031 Transparency can be used within rofi, for example if the selected back‐
1033 ground color is 50% transparent, the background color of the window
1034 will be visible through it.
1035
1037 rofi has the following key bindings:
1038 · Ctrl-v, Insert: Paste from clipboard
1040 · Ctrl-Shift-v, Shift-Insert: Paste primary selection
1042 · Ctrl-u: Clear the line
1044 · Ctrl-a: Beginning of line
1046 · Ctrl-e: End of line
1048 · Ctrl-f, Right: Forward one character
1050 · Alt-f, Ctrl-Right: Forward one word
1052 · Ctrl-b, Left: Back one character
1054 · Alt-b, Ctrl-Left: Back one word
1056 · Ctrl-d, Delete: Delete character
1058 · Ctrl-Alt-d: Delete word
1060 · Ctrl-h, Backspace, Shift-Backspace: Backspace (delete previous
1062 character)
1063 · Ctrl-Alt-h: Delete previous word
1065 · Ctrl-j,Ctrl-m,Enter: Accept entry
1067 · Ctrl-n,Down: Select next entry
1069 · Ctrl-p,Up: Select previous entry
1071 · Page Up: Go to previous page
1073 · Page Down: Go to next page
1075 · Ctrl-Page Up: Go to previous column
1077 · Ctrl-Page Down: Go to next column
1079 · Ctrl-Enter: Use entered text as a command (in ssh/run modi)
1081 · Shift-Enter: Launch the application in a terminal (in run mode)
1083 · Shift-Enter: Return the selected entry and move to the next item
1085 while keeping rofi open. (in dmenu)
1086 · Shift-Right: Switch to the next mode. The list can be customized
1088 with the -switchers argument.
1089 · Shift-Left: Switch to the previous mode. The list can be customized
1091 with the -switchers argument.
1092 · Ctrl-Tab: Switch to the next mode. The list can be customized with
1094 the -switchers argument.
1095 · Ctrl-Shift-Tab: Switch to the previous mode. The list can be cus‐
1097 tomized with the -switchers argument.
1098 · Ctrl-space: Set selected item as input text.
1100 · Shift-Del: Delete entry from history.
1102 · grave: Toggle case sensitivity.
1104 · Alt-grave: Toggle sorting.
1106 · Alt-Shift-S: Take a screenshot and store it in the Pictures direc‐
1108 tory.
1109 To get a full list of key bindings on the commandline, see rofi -h. The
1113 options starting with -kb are keybindings. Key bindings can be modified
1114 using the configuration systems. To get a searchable list of key bind‐
1115 ings, run rofi -show keys.
1116 A key binding starting with ! will act when all keys have been
1118 released.
1119
1121 Window
1122 Show a list of all the windows and allow switching between them. Press‐
1123 ing the delete-entry binding (shift-delete) will close the window.
1124 Pressing the accept-custom binding (control-enter or shift-enter) will
1125 run a command on the window. (See option window-command );
1126 WindowCD
1128 Shows a list of the windows on the current desktop and allows switching
1129 between them. Pressing the delete-entry binding (shift-delete) will
1130 kill the window. Pressing the accept-custom binding (control-enter or
1131 shift-enter) will run a command on the window. (See option window-com‐
1132 mand );
1133 Run
1135 Shows a list of executables in $PATH and can launch them (optional in a
1136 terminal). Pressing the delete-entry binding (shift-delete) will remove
1137 this entry from the run history. Pressing the accept-custom binding
1138 (control-enter or shift-enter) will run the command in a terminal.
1139 DRun
1141 Same as the run launches, but the list is created from the installed
1142 desktop files. It automatically launches them in a terminal if speci‐
1143 fied in the Desktop File. Pressing the delete-entry binding
1144 (shift-delete) will remove this entry from the run history. Pressing
1145 the accept-custom binding (control-enter or shift-enter) with custom
1146 input (no entry matching) will run the command in a terminal.
1147 SSH
1149 Shows a list of SSH targets based on your ssh config file, and allows
1150 to quickly ssh into them.
1151 Keys
1153 Shows a searchable list of key bindings.
1154 Script
1156 Allows custom scripted Modi to be added.
1157
1159 The text in the window switcher is not nicely lined out.
1160 Try using a mono-space font.
1161 The window is completely black.
1163 Check quotes used on the commandline: you might have used “ ("smart
1164 quotes") instead of " ("machine quotes").
1165 What does the icon in the top right show?
1167 The indicator shows:
1168 ` ` Case insensitive and no sorting.
1172 `-` Case sensitivity enabled, no sorting.
1173 `+` Case insensitive and Sorting enabled
1174 `±` Sorting and Case sensitivity enabled"
1175
1179 Some basic usage examples of rofi:
1180 Show the run dialog:
1182 rofi -modi run -show run
1186 Show the the run dialog, and allow switching to Desktop File run dialog
1190 (drun):
1191 rofi -modi run,drun -show run
1195 Combine the run and Desktop File run dialog (drun):
1199 rofi -modi combi -show combi -combi-modi run,drun
1203 Combine the run and Desktop File run dialog (drun), and allow switching
1207 to window switcher:
1208 rofi -modi combi,window -show combi -combi-modi run,drun
1212 Run rofi full monitor width at the top of the monitor like a dropdown
1216 menu:
1217 rofi -show run -width 100 -location 1 -lines 5 -bw 2 -yoffset -2
1221 Pop up a text message claiming that this is the end:
1225 rofi -e "This is the end"
1229 Pop up a text message in red, bold font claiming that this is still the
1233 end:
1234 rofi -e "<span color=´red´><b>This is still the end</b></span>" -markup
1238 Show all key bindings:
1242 rofi -show keys
1246 Use qalc to get a simple calculator in rofi:
1250 rofi -show calc -modi "calc:qalc +u8 -nocurrencies"
1254
1258 In i3 http://i3wm.org/ you want to bind rofi to be launched on key
1259 release. Otherwise, it cannot grab the keyboard. See also the i3 manual
1260 http://i3wm.org/docs/userguide.html:
1261 Some tools (such as import or xdotool) might be unable to run upon a
1263 KeyPress event, because the keyboard/pointer is still grabbed. For
1264 these situations, the --release flag can be used, as it will execute
1265 the command after the keys have been released.
1266
1268 MIT/X11
1269 Permission is hereby granted, free of charge, to any person obtaining
1271 a copy of this software and associated documentation files (the
1272 "Software"), to deal in the Software without restriction, including
1273 without limitation the rights to use, copy, modify, merge, publish,
1274 distribute, sublicense, and/or sell copies of the Software, and to
1275 permit persons to whom the Software is furnished to do so, subject to
1276 the following conditions:
1277 The above copyright notice and this permission notice shall be
1279 included in all copies or substantial portions of the Software.
1280 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
1282 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
1283 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
1284 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
1285 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
1286 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
1287 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1288
1290 rofi website can be found here https://davedavenport.github.io/rofi/
1291
1293 rofi support can be obtained here irc://irc.freenode.net/#rofi (#rofi
1294 on irc.freenode.net), or via the forum https://reddit.com/r/qtools//
1295
1297 Please see this https://github.com/DaveDavenport/rofi/wiki/Debug‐
1298 ging%20Rofi wiki entry.
1299
1301 rofi issue tracker can be found here https://github.com/DaveDaven‐
1302 port/rofi/issues
1303 When creating an issue, please read this https://github.com/DaveDaven‐
1305 port/rofi/blob/master/.github/CONTRIBUTING.md first.
1306
1308 rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-theme-selec‐
1309 tor(1)
1310
1312 Qball Cow qball@gmpclient.org
1313 Rasmus Steinke rasi@xssn.at
1315 Quentin Glidic sardemff7+rofi@sardemff7.net
1317 Original code based on work by: Sean Pringle sean.pringle@gmail.com
1319 For a full list of authors, check the AUTHORS file.
1321 June 2019 ROFI(1)