1ROFI(1) General Commands Manual ROFI(1)
2
3
4
6 rofi - A window switcher, application launcher, ssh dialog, dmenu re‐
7 placement and more
8
9
11 rofi [ -show mode ]|[ -dmenu ]|[ -e msg ] [ CONFIGURATION ]
12
13
15 rofi is an X11 pop-up window switcher, run dialog, dmenu replacement,
16 and more. It focuses on being fast to use and have minimal distraction.
17 It supports keyboard and mouse navigation, type to filter, tokenized
18 search and more.
19
20
22 rofi's main functionality is to assist in your workflow, allowing you
23 to quickly switch between windows, start applications or log into a re‐
24 mote machine via ssh. There are different modes for different types of
25 actions. rofi is a standalone application and should not be integrated
26 into scripts. For integration into scripts it has a special mode that
27 functions as a (drop-in) replacement for dmenu(1). See emulating dmenu
28 below.
29
30
31 Running rofi
32 To launch rofi directly in a certain mode, specify a mode with rofi
33 -show <mode>. To show the drun dialog:
34
35
36 rofi -show drun
37
38
39
40 A very useful setup in minimalistic window managers is to combine drun,
41 run with window mode:
42
43
44 rofi -show combi -modes combi -combi-modes "window,drun,run"
45
46
47
48 In this setup it first list all open applications, then all installed
49 applications. So if you type firefox and hit return, it will switch to
50 the running firefox, or launch it when it is not running.
51
52
53 Emulating dmenu
54 rofi can emulate dmenu(1) (a dynamic menu for X11) when launched with
55 the -dmenu flag.
56
57
58 For more information see rofi-dmenu(5).
59
60
61 Display Error message
62 rofi error dialog can also be called from the command line.
63
64
65 rofi -e "my message"
66
67
68
69 Markup support can be enabled, see CONFIGURATION options.
70
71
73 There are currently three methods of setting configuration options
74 (evaluated in order below):
75
76
77 • System configuration file (for example /etc/rofi.rasi). It
78 first checks XDG_CONFIG_DIRS, and then SYSCONFDIR (that is
79 passed at compile time). It loads the first config file it
80 finds, it does not merge multiple system configuration files.
81
82 • Rasi theme file: The new theme format can be used to set con‐
83 figuration values.
84
85 • Command-line options: Arguments passed to rofi.
86
87
88
89 To get a template config file, run: rofi -dump-config > config.rasi
90
91
92 This will contain (commented) all current configuration options, modi‐
93 fied options are uncommented.
94
95
96 To get a template config file that sets the icon-theme run: rofi -icon-
97 theme hicolor -dump-config.
98
99
100 It is strongly recommended to use this as a starting point for your
101 configuration.
102
103
104 An empty configuration section in the config file looks like:
105
106
107 configuration {
108 // set config options here
109 }
110
111
112
113 Most of the configuration options mentioned below (beside options like
114 -show, -dump-config that apply to a single run) can be set here.
115
116
117 For example to set the dpi value to 72:
118
119
120 configuration {
121 dpi: 72;
122 }
123
124
125
126 The configuration system supports the following types:
127
128
129 • string
130
131 • integer (signed and unsigned)
132
133 • char
134
135 • boolean
136
137 • lists
138
139
140
141 For the syntax of these options, see the rofi-theme(5) manpage.
142
143
144 For use on the command line, Boolean options have a non-default com‐
145 mand-line syntax. Example to enable option X:
146
147
148 -X
149
150
151
152 To disable option X:
153
154
155 -no-X
156
157
158
159 Below is a list of the most important options:
160
161
162 General
163 -help
164
165
166 The help option shows the full list of command-line options and the
167 current set values. These include dynamic (run-time generated) options.
168
169
170 -version
171
172
173 Show the rofi version and exit.
174
175
176 -dump-config
177
178
179 Dump the current active configuration, in rasi format, to stdout and
180 exit. Information about the rasi format can be found in the rofi-
181 theme(5) manpage.
182
183
184 -dump-theme
185
186
187 Dump the current active theme, in rasi format, to stdout and exit.
188
189
190 -rasi-validate filename
191
192
193 Try to parse the file and return 0 when successful, non-zero when
194 failed.
195
196
197 -list-keybindings
198
199
200 List all known keybindings without trying to parse them. This can be
201 used to look for duplicate bindings.
202
203
204 -threads num
205
206
207 Specify the number of threads rofi should use:
208
209
210 • 0: Autodetect the number of supported hardware threads.
211
212 • 1: Disable threading
213
214 • 2..n: Specify the maximum number of threads to use in the
215 thread pool.Default: Autodetect
216
217
218
219 -display display
220
221
222 The X server to contact. Default is $DISPLAY.
223
224
225 -dmenu
226
227
228 Run rofi in dmenu mode. This allows for interactive scripts. In dmenu
229 mode, rofi reads from STDIN, and output to STDOUT. A simple example,
230 displaying three pre-defined options:
231
232
233 echo -e "Option #1\nOption #2\nOption #3" | rofi -dmenu
234
235
236
237 Or get the options from a script:
238
239
240 ~/my_script.sh | rofi -dmenu
241
242
243
244 See the rofi-dmenu(5) manpage for more information.
245
246
247 -show mode
248
249
250 Open rofi in a certain mode. Available modes are window, run, drun,
251 ssh, combi. The special argument keys can be used to open a searchable
252 list of supported key bindings (see the rofi-keys(5) manpage)
253
254
255 To show the run-dialog:
256
257
258 rofi -show run
259
260
261
262 If -show is the last option passed to rofi, the first enabled modes is
263 shown.
264
265
266 -modes mode1,mode2
267
268
269 Specify an ordered, comma-separated list of modes to enable. Enabled
270 modes can be changed at runtime. Default key is Ctrl+Tab. If no modes
271 are specified, all configured modes will be enabled. To only show the
272 run and ssh launcher:
273
274
275 rofi -modes "run,ssh" -show run
276
277
278
279 Custom modes can be added using the internal script mode. Each such
280 mode has two parameters:
281
282
283 <name>:<script>
284
285
286
287 Example: Have a mode called 'Workspaces' using the
288 i3_switch_workspaces.sh script:
289
290
291 rofi -modes "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
292
293
294
295 Notes: The i3 window manager dislikes commas in the command when speci‐
296 fying an exec command. For that case, # can be used as a separator.
297
298
299 TIP: The name is allowed to contain spaces:
300
301
302 rofi -modes "My File Browser:fb.sh" -show "My File Browser"
303
304
305
306 -case-sensitive
307
308
309 Start in case-sensitive mode. This option can be changed at run-time
310 using the -kb-toggle-case-sensitivity key binding.
311
312
313 -cycle
314
315
316 Cycle through the result list. Default is 'true'.
317
318
319 -filter filter
320
321
322 Filter the list by setting text in input bar to filter
323
324
325 -config filename
326
327
328 Load an alternative configuration file.
329
330
331 -cache-dir filename
332
333
334 Directory that is used to place temporary files, like history.
335
336
337 -scroll-method method
338
339
340 Select the scrolling method. 0: Per page, 1: continuous.
341
342
343 -normalize-match
344
345
346 Normalize the string before matching, so o will match ö, and é matches
347 e.
348 This is not a perfect implementation, but works. For now, it disables
349 highlighting of the matched part.
350
351
352 -no-lazy-grab
353
354
355 Disables lazy grab, this forces the keyboard being grabbed before gui
356 is shown.
357
358
359 -no-plugins
360
361
362 Disable plugin loading.
363
364
365 -plugin-path directory
366
367
368 Specify the directory where rofi should look for plugins.
369
370
371 -show-icons
372
373
374 Show application icons in drun and window modes.
375
376
377 -icon-theme
378
379
380 Specify icon theme to be used. If not specified default theme from DE
381 is used, Adwaita and gnome themes act as fallback themes.
382
383
384 -markup
385
386
387 Use Pango markup to format output wherever possible.
388
389
390 -normal-window
391
392
393 Make rofi react like a normal application window. Useful for scripts
394 like Clerk that are basically an application.
395
396
397 -[no-]steal-focus
398
399
400 Make rofi steal focus on launch and restore close to window that held
401 it when launched.
402
403
404 -refilter-timeout-limit
405
406
407 The time (in ms) boundary filter may take before switch from instant to
408 delayed filter mode.
409
410
411 Default: 300
412
413
414 A fallback icon can be specified for each mode:
415
416
417 configuration {
418 <mode>{
419 fallback-icon: "<icon name>";
420 }
421 }
422
423
424
425 Example
426
427
428 configuration {
429 run,drun {
430 fallback-icon: "application-x-addon";
431 }
432 }
433
434
435
436 Matching
437 -matching method
438
439
440 Specify the matching algorithm used. Currently, the following methods
441 are supported:
442
443
444 • normal: match the int string
445
446 • regex: match a regex input
447
448 • glob: match a glob pattern
449
450 • fuzzy: do a fuzzy match
451
452 • prefix: match prefix
453
454
455
456 Default: normal
457
458
459 Note: glob matching might be slow for larger lists
460
461
462 -tokenize
463
464
465 Tokenize the input.
466
467
468 -drun-categories category1,category2
469
470
471 Only show desktop files that are present in the listed categories.
472
473
474 -drun-match-fields field1,field2,...
475
476
477 When using drun, match only with the specified Desktop entry fields.
478 The different fields are:
479
480
481 • name: the application's name
482
483 • generic: the application's generic name
484
485 • exec: the application's executable
486
487 • categories: the application's categories
488
489 • comment: the application comment
490
491 • all: all the aboveDefault: name,generic,exec,categories,key‐
492 words
493
494
495
496 -drun-display-format
497
498
499 The format string for the drun dialog:
500
501
502 • name: the application's name
503
504 • generic: the application's generic name
505
506 • exec: the application's executable
507
508 • categories: the application's categories
509
510 • comment: the application comment
511
512
513
514 Pango markup can be used to formatting the output.
515
516
517 Default: {name} [<span weight='light' size='small'><i>({generic})</i></span>]
518
519
520
521 Note: Only fields enabled in -drun-match-fields can be used in the for‐
522 mat string.
523
524
525 -[no-]drun-show-actions
526
527
528 Show actions present in the Desktop files.
529
530
531 Default: false
532
533
534
535 -window-match-fields field1,field2,...
536
537
538 When using window mode, match only with the specified fields. The dif‐
539 ferent fields are:
540
541
542 • title: window's title
543
544 • class: window's class
545
546 • role: window's role
547
548 • name: window's name
549
550 • desktop: window's current desktop
551
552 • all: all the above
553
554
555
556 For Wayland, the list of accepted fields is different:
557
558
559 • title: window's title
560
561 • app-id: Wayland Application ID or XWayland window's class
562
563 • class: same as app-id
564
565 • all: all of the above
566
567
568
569 Default: all
570
571
572 -matching-negate-char char
573
574
575 Set the character used to negate the query (i.e. if it does not match
576 the next keyword). Set to '\x0' to disable.
577
578
579 Default: '-'
580
581
582
583 Layout and Theming
584 IMPORTANT:
585 In newer rofi releases, all the theming options have been moved into
586 the new theme format. They are no longer normal
587 rofi options that can be passed directly on the command line (there
588 are too many).
589 Small snippets can be passed on the command line: rofi -theme-str
590 'window {width: 50%;}' to override a single
591 setting. They are merged into the current theme.
592 They can also be appended at the end of the rofi config file to over‐
593 ride parts of the theme.
594
595
596 Most of the following options are deprecated and should not be used.
597 Please use the new theme format to customize rofi. More information
598 about the new format can be found in the rofi-theme(5) manpage.
599
600
601 -location
602
603
604 Specify where the window should be located. The numbers map to the fol‐
605 lowing locations on screen:
606
607
608 1 2 3
609 8 0 4
610 7 6 5
611
612
613
614 Default: 0
615
616
617 -fixed-num-lines
618
619
620 Keep a fixed number of visible lines.
621
622
623 -sidebar-mode
624
625
626 Open in sidebar-mode. In this mode, a list of all enabled modes is
627 shown at the bottom. (See -modes option) To show sidebar, use:
628
629
630 rofi -show run -sidebar-mode
631
632
633
634 -hover-select
635
636
637 Automatically select the entry the mouse is hovering over. This option
638 is best combined with custom mouse bindings. To utilize hover-select
639 and accept an entry in a single click, use:
640
641
642 rofi -show run -hover-select -me-select-entry '' -me-accept-entry MousePrimary
643
644
645
646 -eh number
647
648
649 Set row height (in chars) Default: 1
650
651
652 -auto-select
653
654
655 When one entry is left, automatically select it.
656
657
658 -m num
659
660
661 -m name
662
663
664 -monitor num
665
666
667 -monitor name
668
669
670 Select monitor to display rofi on. It accepts as input: primary (if
671 primary output is set), the xrandr output name, or integer number (in
672 order of detection). Negative numbers are handled differently:
673
674
675 • -1: the currently focused monitor.
676
677 • -2: the currently focused window (that is, rofi will be dis‐
678 played on top of the focused window).
679
680 • -3: Position of mouse (overrides the location setting to get
681 normal context menu behavior.)
682
683 • -4: the monitor with the focused window.
684
685 • -5: the monitor that shows the mouse pointer.Default: -5
686
687
688
689 See rofi -h output for the detected monitors, their position, and size.
690
691
692 -theme filename
693
694
695 Path to the new theme file format. This overrides the old theme set‐
696 tings.
697
698
699 -theme-str string
700
701
702 Allow theme parts to be specified on the command line as an override.
703
704
705 For example:
706
707
708 rofi -theme-str '#window { fullscreen: true; }'
709
710
711
712 This option can be specified multiple times. This is now the method to
713 tweak the theme via the command line.
714
715
716 -dpi number
717
718
719 Override the default DPI setting.
720
721
722 • If set to 0, it tries to auto-detect based on X11 screen size
723 (similar to i3 and GTK).
724
725 • If set to 1, it tries to auto-detect based on the size of the
726 monitor that rofi is displayed on (similar to latest Qt 5).
727
728
729
730 -selected-row selected row
731
732
733 Select a certain row.
734
735
736 Default: 0
737
738
739 PATTERN setting
740 -terminal
741
742
743 Specify which terminal to start.
744
745
746 rofi -terminal xterm
747
748
749
750 Pattern: {terminal}
751
752
753 Default: x-terminal-emulator
754
755
756 -ssh-client client
757
758
759 Override the used ssh client.
760
761
762 Pattern: {ssh-client}
763
764
765 Default: ssh
766
767
768 SSH settings
769 -ssh-command cmd
770
771
772 Set the command to execute when starting an ssh session. The pattern
773 {host} is replaced by the selected ssh entry.
774
775
776 Pattern: {ssh-client}
777
778
779 Default: {terminal} -e {ssh-client} {host}
780
781
782 -parse-hosts
783
784
785 Parse the /etc/hosts file for entries.
786
787
788 Default: disabled
789
790
791 -parse-known-hosts -no-parse-known-hosts
792
793
794 Parse the ~/.ssh/known_hosts file for entries.
795
796
797 Default: enabled
798
799
800 Run settings
801 -run-command cmd
802
803
804 Set command ({cmd}) to execute when running an application. See PAT‐
805 TERN.
806
807
808 Default: {cmd}
809
810
811 -run-shell-command cmd
812
813
814 Set command to execute when running an application in a shell. See
815 PATTERN.
816
817
818 Default: {terminal} -e {cmd}
819
820
821 -run-list-command cmd
822
823
824 If set, use an external tool to generate a list of executable commands.
825 Uses run-command.
826
827
828 Default: {cmd}
829
830
831 Window switcher settings
832 -window-format format
833
834
835 Format what is being displayed for windows.
836
837
838 format: {field[:len]}
839
840
841 field:
842
843
844 • w: desktop name
845
846 • t: title of window
847
848 • n: name
849
850 • r: role
851
852 • c: class
853
854
855
856 len: maximum field length (0 for auto-size). If length is negative, the
857 entry will be unchanged.
858 If length is positive, the entry will be truncated or padded to fill
859 that length.
860
861
862 default: {w} {c} {t}
863
864
865 -window-command cmd
866
867
868 Set command to execute on selected window for an alt action (-kb-ac‐
869 cept-alt). See PATTERN.
870
871
872 Default: "wmctrl -i -R {window}"
873
874
875 -window-thumbnail
876
877
878 Show window thumbnail (if available) as icon in the window switcher.
879
880
881 You can stop rofi from exiting when closing a window (allowing multiple
882 to be closed in a row).
883
884
885 configuration {
886 window {
887 close-on-delete: false;
888 }
889 }
890
891
892
893 You can hide the currently active window with the 'hide-active-window'
894 setting:
895
896
897 configuration {
898 window {
899 hide-active-window: true;
900 }
901 }
902
903
904
905 or pass -window-hide-active-window true on command line.
906
907
908 Combi settings
909 -combi-modes mode1,mode2
910
911
912 The modes to combine in combi mode. For syntax to -combi-modes, see
913 -modes. To get one merge view, of window,run, and ssh:
914
915
916 rofi -show combi -combi-modes "window,run,ssh" -modes combi
917
918
919
920 NOTE: The i3 window manager dislikes commas in the command when speci‐
921 fying an exec command. For that case, # can be used as a separator.
922
923
924 -combi-display-format
925
926
927 The format string for entries in the combi dialog:
928
929
930 • mode: the mode display name
931
932 • text: the entry text
933
934
935
936 Pango markup can be used to formatting the output.
937
938
939 Default: {mode} {text}
940
941
942
943 Note: This setting is ignored if combi-hide-mode-prefix is enabled.
944
945
946 History and Sorting
947 -disable-history -no-disable-history (re-enable history)
948
949
950 Disable history
951
952
953 -sort to enable -no-sort to disable
954
955
956 Enable, disable sorting. This setting can be changed at runtime (see
957 -kb-toggle-sort).
958
959
960 -sorting-method 'method' to specify the sorting method.
961
962
963 There are 2 sorting methods:
964
965
966 • levenshtein (Default)
967
968 • fzf sorting.
969
970
971
972 -max-history-size number
973
974
975 Maximum number of entries to store in history. Defaults to 25. (WARN‐
976 ING: can cause slowdowns when set too high)
977
978
979 Message dialog
980 -e message
981
982
983 Pops up a message dialog (used internally for showing errors) with mes‐
984 sage. Message can be multi-line.
985
986
987 File browser settings
988 File browser behavior can be controlled via the following options:
989
990
991 configuration {
992 filebrowser {
993 /** Directory the file browser starts in. */
994 directory: "/some/directory";
995 /**
996 * Sorting method. Can be set to:
997 * - "name"
998 * - "mtime" (modification time)
999 * - "atime" (access time)
1000 * - "ctime" (change time)
1001 */
1002 sorting-method: "name";
1003 /** Group directories before files. */
1004 directories-first: true;
1005 }
1006 }
1007
1008
1009
1010 Other
1011 -drun-use-desktop-cache
1012
1013
1014 Build and use a cache with the content of desktop files. Usable for
1015 systems with slow hard drives.
1016
1017
1018 -drun-reload-desktop-cache
1019
1020
1021 If drun-use-desktop-cache is enabled, rebuild a cache with the content
1022 of desktop files.
1023
1024
1025 -drun-url-launcher command
1026
1027
1028 Command to open a Desktop Entry that is a Link.
1029
1030
1031 -pid path
1032
1033
1034 Make rofi create a pid file and check this on startup. The pid file
1035 prevents multiple rofi instances from running simultaneously. This is
1036 useful when running rofi from a key-binding daemon.
1037
1038
1039 -replace
1040
1041
1042 If rofi is already running, based on pid file, try to kill that in‐
1043 stance.
1044
1045
1046 -display-{mode} string
1047
1048
1049 Set the name to use for mode. This is used as prompt and in combi-
1050 browser.
1051
1052
1053 It is now preferred to use the configuration file:
1054
1055
1056 configuration {
1057 {mode} {
1058 display-name: *string*;
1059 }
1060 }
1061
1062
1063
1064 -click-to-exit -no-click-to-exit
1065
1066
1067 Click the mouse outside the rofi window to exit.
1068
1069
1070 Default: enabled
1071
1072
1073 -xserver-i300-workaround
1074
1075
1076 Workaround for bug in Xserver. See issue #611 and #1642 on the rofi is‐
1077 sue tracker.
1078
1079
1080 Default: disabled
1081
1082
1084 To launch commands (for example, when using the ssh launcher), the user
1085 can enter the used command-line. The following keys can be used that
1086 will be replaced at runtime:
1087
1088
1089 • {host}: the host to connect to
1090
1091 • {terminal}: the configured terminal (see -terminal)
1092
1093 • {ssh-client}: the configured ssh client (see -ssh-client)
1094
1095 • {cmd}: the command to execute
1096
1097 • {window}: the window ID of the selected window (in window-com‐
1098 mand)
1099
1100
1101
1103 Please see rofi-theme(5) manpage for more information on theming.
1104
1105
1107 Please see the rofi-keys(5) manpage for the keybindings and how to set
1108 them up.
1109
1110
1111 The keybinding can also be used for actions, when the action is exe‐
1112 cuted the mentioned keystroke is inserted:
1113
1114
1115 Timeout
1116 You can configure an action to be taken when rofi has not been inter‐
1117 acted with for a certain amount of seconds. You can specify a keybind‐
1118 ing to trigger after X seconds.
1119
1120
1121 configuration {
1122 timeout {
1123 delay: 15;
1124 action: "kb-cancel";
1125 }
1126 }
1127
1128
1129
1130 Input change
1131 When the input of the textbox changes:
1132
1133
1134 configuration {
1135 inputchange {
1136 action: "kb-row-first";
1137 }
1138 }
1139
1140
1141
1143 window
1144 Show a list of all the windows and allow switching between them.
1145 Pressing the delete-entry binding (shift-delete) will close the window.
1146 Pressing the accept-custom binding (control-enter or shift-enter) will
1147 run a command on the window. (See option window-command );
1148
1149
1150 If there is no match, it will try to launch the input.
1151
1152
1153 windowcd
1154 Shows a list of the windows on the current desktop and allows switching
1155 between them. Pressing the delete-entry binding (shift-delete) will
1156 kill the window. Pressing the accept-custom binding (control-enter or
1157 shift-enter) will run a command on the window. (See option window-com‐
1158 mand );
1159
1160
1161 If there is no match, it will try to launch the input.
1162
1163
1164 run
1165 Shows a list of executables in $PATH and can launch them (optional in a
1166 terminal). Pressing the delete-entry binding (shift-delete) will re‐
1167 move this entry from the run history. Pressing the accept-custom bind‐
1168 ing (control-enter) will run the command as entered in the entry box.
1169 Pressing the accept-alt binding (shift-enter) will run the command in a
1170 terminal.
1171
1172
1173 When pressing the mode-complete binding (Control-l), you can use the
1174 File Browser mode to launch the application with a file as the first
1175 argument.
1176
1177
1178 drun
1179 Same as the run launches, but the list is created from the installed
1180 desktop files. It automatically launches them in a terminal if speci‐
1181 fied in the Desktop File. Pressing the delete-entry binding (shift-
1182 delete) will remove this entry from the run history. Pressing the ac‐
1183 cept-custom binding (control-enter) will run the command as entered in
1184 the entry box. Pressing the accept-alt binding (shift-enter) will run
1185 the command in a terminal.
1186
1187
1188 When pressing the mode-complete binding (Control-l), you can use the
1189 File Browser mode to launch the application passing a file as argument
1190 if specified in the desktop file.
1191
1192
1193 The DRUN mode tries to follow the XDG Desktop Entry Specification
1194 ⟨https://freedesktop.org/wiki/Specifications/desktop-entry-spec/⟩ and
1195 should be compatible with applications using this standard. Some ap‐
1196 plications create invalid desktop files, rofi will discard these en‐
1197 tries. See the debugging section for more info on DRUN mode, this will
1198 print why desktop files are discarded.
1199
1200
1201 There are two advanced options to tweak the behaviour:
1202
1203
1204 configuration {
1205 drun {
1206 /** Parse user desktop files. */
1207 parse-user: true;
1208 /** Parse system desktop files. */
1209 parse-system: false;
1210 }
1211 }
1212
1213
1214
1215 ssh
1216 Shows a list of SSH targets based on your ssh config file, and allows
1217 to quickly ssh into them.
1218
1219
1220 keys
1221 Shows a searchable list of key bindings.
1222
1223
1224 script
1225 Allows custom scripted Modes to be added, see the rofi-script(5) man‐
1226 page for more information.
1227
1228
1229 combi
1230 Combines multiple modes in one list. Specify which modes are included
1231 with the -combi-modes option.
1232
1233
1234 When using the combi mode, a !bang can be used to filter the results by
1235 modes. All modes that match the bang as a prefix are included. For
1236 example, say you have specified -combi-modes run,window,windowcd. If
1237 your query begins with the bang !w, only results from the window and
1238 windowcd modes are shown, even if the rest of the input text would
1239 match results from run.
1240
1241
1242 If no match, the input is handled by the first combined modes.
1243
1244
1246 The text in the window switcher is not nicely aligned.
1247 Try using a mono-space font or tabs + the tab-stops setting..
1248
1249
1250 The window is completely black.
1251 Check quotes used on the command-line: you might have used “ ("smart
1252 quotes") instead of " ("machine quotes").
1253
1254
1255 What does the icon in the top right show?
1256 The indicator shows:
1257
1258
1259 ` ` Case insensitive and no sorting.
1260 `-` Case sensitivity enabled, no sorting.
1261 `+` Case insensitive and Sorting enabled
1262 `±` Sorting and Case sensitivity enabled"
1263
1264
1265
1266 Why do I see different icons for run,drun and window mode
1267 Each of these modes uses different methods of resolving the icon:
1268
1269
1270 • Window: It first uses the icon that the application exposes
1271 via the X11 Server, if none is set it does a lookup of the
1272 window Class name in the icon theme.
1273
1274 • drun: It uses the icon set in the desktop file.
1275
1276 • run: It does a lookup using the executable name.
1277
1278
1279
1281 Some basic usage examples of rofi:
1282
1283
1284 Show the run dialog:
1285
1286
1287 rofi -modes run -show run
1288
1289
1290
1291 Show the run dialog, and allow switching to Desktop File run dialog
1292 (drun):
1293
1294
1295 rofi -modes run,drun -show run
1296
1297
1298
1299 Combine the run and Desktop File run dialog (drun):
1300
1301
1302 rofi -modes combi -show combi -combi-modes run,drun
1303
1304
1305
1306 Combine the run and Desktop File run dialog (drun), and allow switching
1307 to window switcher:
1308
1309
1310 rofi -modes combi,window -show combi -combi-modes run,drun
1311
1312
1313
1314 Pop up a text message claiming that this is the end:
1315
1316
1317 rofi -e "This is the end"
1318
1319
1320
1321 Pop up a text message in red, bold font claiming that this is still the
1322 end:
1323
1324
1325 rofi -e "<span color='red'><b>This is still the end</b></span>" -markup
1326
1327
1328
1329 Show all key bindings:
1330
1331
1332 rofi -show keys
1333
1334
1335
1337 In i3 ⟨http://i3wm.org/⟩ you want to bind rofi to be launched on key
1338 release. Otherwise, it cannot grab the keyboard. See also the i3 man‐
1339 ual ⟨http://i3wm.org/docs/userguide.html⟩:
1340
1341
1342 Some tools (such as import or xdotool) might be unable to run upon a
1343 KeyPress event, because the keyboard/pointer is still grabbed. For
1344 these situations, the --release flag can be used, as it will execute
1345 the command after the keys have been released.
1346
1347
1349 MIT/X11
1350
1351 Permission is hereby granted, free of charge, to any person obtaining
1352 a copy of this software and associated documentation files (the
1353 "Software"), to deal in the Software without restriction, including
1354 without limitation the rights to use, copy, modify, merge, publish,
1355 distribute, sublicense, and/or sell copies of the Software, and to
1356 permit persons to whom the Software is furnished to do so, subject to
1357 the following conditions:
1358
1359 The above copyright notice and this permission notice shall be
1360 included in all copies or substantial portions of the Software.
1361
1362 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
1363 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
1364 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
1365 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
1366 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
1367 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
1368 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1369
1370
1371
1373 rofi website can be found here ⟨https://github.com/davatorium/rofi/⟩
1374
1375
1377 rofi support can be obtained:
1378 * GitHub Discussions ⟨https://github.com/davatorium/rofi/discussions⟩
1379 * Forum (Reddit) ⟨https://reddit.com/r/qtools//⟩
1380 * IRC ⟨irc://irc.libera.chat:6697/#rofi⟩ (#rofi on irc.libera.chat),
1381
1382
1384 For more information see rofi-debugging(5) manpage.
1385
1386
1388 The rofi issue tracker can be found here ⟨https://github.com/davato‐
1389 rium/rofi/issues⟩ Before creating an issue, consider posting a question
1390 on the discussion forum ⟨https://github.com/davatorium/rofi/discus‐
1391 sions⟩ first. When creating an issue, please read this
1392 ⟨https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUT‐
1393 ING.md⟩ first.
1394
1395
1397 rofi-sensible-terminal(1), dmenu(1), rofi-debugging(5), rofi-theme(5),
1398 rofi-script(5), rofi-keys(5),rofi-theme-selector(1),rofi-dmenu(5)
1399
1400
1402 • Qball Cow qball@blame.services ⟨mailto:qball@blame.services⟩
1403
1404 • Rasmus Steinke rasi@xssn.at ⟨mailto:rasi@xssn.at⟩
1405
1406 • Morgane Glidic sardemff7+rofi@sardemff7.net
1407 ⟨mailto:sardemff7+rofi@sardemff7.net⟩
1408
1409
1410
1411 Original code based on work by: Sean Pringle ⟨https://github.com/sean‐
1412 pringle/simpleswitcher⟩ sean.pringle@gmail.com
1413 ⟨mailto:sean.pringle@gmail.com⟩
1414
1415
1416 For a full list of authors, check the AUTHORS file.
1417
1418
1419
1420 rofi ROFI(1)