1ROFI(1)                     General Commands Manual                    ROFI(1)
2
3
4

NAME

6       rofi  -  A window switcher, application launcher, ssh dialog, dmenu re‐
7       placement and more
8
9

SYNOPSIS

11       rofi [ -show mode ]|[ -dmenu ]|[ -e msg ] [ CONFIGURATION ]
12
13

DESCRIPTION

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

USAGE

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

CONFIGURATION

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
437normal: match the int string
438
439regex: match a regex input
440
441glob: match a glob pattern
442
443fuzzy: do a fuzzy match
444
445prefix: 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
474name: the application's name
475
476generic: the application's generic name
477
478exec: the application's  executable
479
480categories: the application's categories
481
482comment: the application comment
483
484all: 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
495name: the application's name
496
497generic: the application's generic name
498
499exec: the application's  executable
500
501categories: the application's categories
502
503comment: 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
535title: window's title
536
537class: window's class
538
539role: window's role
540
541name: window's name
542
543desktop: window's current desktop
544
545all: 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
821w: desktop name
822
823t: title of window
824
825n: name
826
827r: role
828
829c: 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
907mode: the mode display name
908
909text: 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

PATTERN

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

THEMING

1080       Please see rofi-theme(5) manpage for more information on theming.
1081
1082

KEY BINDINGS

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

Available Modes

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
1171https://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

FAQ

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

EXAMPLES

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

i3

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

LICENSE

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

WEBSITE

1350       rofi website can be found here ⟨https://github.com/davatorium/rofi/
1351
1352

SUPPORT

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

DEBUGGING

1361       For more information see rofi-debugging(5) manpage.
1362
1363

ISSUE TRACKER

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
1369https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUT
1370       ING.md⟩ first.
1371
1372

SEE ALSO

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

AUTHOR

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)
Impressum