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       -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
444normal: match the int string
445
446regex: match a regex input
447
448glob: match a glob pattern
449
450fuzzy: do a fuzzy match
451
452prefix: 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
481name: the application's name
482
483generic: the application's generic name
484
485exec: the application's  executable
486
487categories: the application's categories
488
489comment: the application comment
490
491all:  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
502name: the application's name
503
504generic: the application's generic name
505
506exec: the application's  executable
507
508categories: the application's categories
509
510comment: 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
542title: window's title
543
544class: window's class
545
546role: window's role
547
548name: window's name
549
550desktop: window's current desktop
551
552all: all the above
553
554
555
556       For Wayland, the list of accepted fields is different:
557
558
559title: window's title
560
561app-id: Wayland Application ID or XWayland window's class
562
563class: same as app-id
564
565all: 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
844w: desktop name
845
846t: title of window
847
848n: name
849
850r: role
851
852c: 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
930mode: the mode display name
931
932text: 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

PATTERN

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

THEMING

1103       Please see rofi-theme(5) manpage for more information on theming.
1104
1105

KEY BINDINGS

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

Available Modes

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

FAQ

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

EXAMPLES

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

i3

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

LICENSE

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

WEBSITE

1373       rofi website can be found here ⟨https://github.com/davatorium/rofi/
1374
1375

SUPPORT

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

DEBUGGING

1384       For more information see rofi-debugging(5) manpage.
1385
1386

ISSUE TRACKER

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
1392https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUT
1393       ING.md⟩ first.
1394
1395

SEE ALSO

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

AUTHOR

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