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