1ROFI(1) General Commands Manual ROFI(1)
2
6 rofi - A window switcher, application launcher, ssh dialog, dmenu re‐
7 placement and more
8
11 rofi [ -show mode ]|[ -dmenu ]|[ -e msg ] [ CONFIGURATION ]
12
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
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 modi 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 Running rofi
32 To launch rofi directly in a certain mode, specify a mode with rofi
33 -show <mode>. To show the run dialog:
34 rofi -show run
37 Emulating dmenu
41 rofi can emulate dmenu(1) (a dynamic menu for X11) when launched with
42 the -dmenu flag.
43 For more information see rofi-dmenu(5).
46 Display Error message
49 rofi error dialog can also be called from the command line.
50 rofi -e "my message"
53 Markup support can be enabled, see CONFIGURATION options.
57
60 There are currently three methods of setting configuration options
61 (evaluated in order below):
62 • System configuration file (for example /etc/rofi.rasi). It
65 first checks XDG_CONFIG_DIRS, and then SYSCONFDIR (that is
66 passed at compile time). It loads the first config file it
67 finds, it does not merge multiple system configuration files.
68 • Rasi theme file: The new theme format can be used to set con‐
70 figuration values.
71 • Command-line options: Arguments passed to rofi.
73 To get a template config file, run: rofi -dump-config > config.rasi
77 This will contain (commented) all current configuration options, modi‐
80 fied options are uncommented.
81 The configuration system supports the following types:
84 • string
87 • integer (signed and unsigned)
89 • char
91 • boolean
93 • lists
95 For the syntax of these options, see the rofi-theme(5) manpage.
99 For use on the command line, Boolean options have a non-default com‐
102 mand-line syntax. Example to enable option X:
103 -X
106 To disable option X:
110 -no-X
113 Below is a list of the most important options:
117 General
120 -help
121 The help option shows the full list of command-line options and the
124 current set values. These include dynamic (run-time generated) op‐
125 tions.
126 -version
129 Show the rofi version and exit.
132 -dump-config
135 Dump the current active configuration, in rasi format, to stdout and
138 exit. Information about the rasi format can be found in the
139 rofi-theme(5) manpage.
140 -dump-theme
143 Dump the current active theme, in rasi format, to stdout and exit.
146 -rasi-validate filename
149 Try to parse the file and return 0 when successful, non-zero when
152 failed.
153 -threads num
156 Specify the number of threads rofi should use:
159 • 0: Autodetect the number of supported hardware threads.
162 • 1: Disable threading
164 •
166 2..n: Specify the maximum number of threads to use in the thread
169 pool.
170 Default: Autodetect
172 -display display
176 The X server to contact. Default is $DISPLAY.
179 -dmenu
182 Run rofi in dmenu mode. This allows for interactive scripts. In dmenu
185 mode, rofi reads from STDIN, and output to STDOUT. A simple example,
186 displaying three pre-defined options:
187 echo -e "Option #1\nOption #2\nOption #3" | rofi -dmenu
190 Or get the options from a script:
194 /my_script.sh | rofi -dmenu
197 -show mode
201 Open rofi in a certain mode. Available modes are window, run, drun,
204 ssh, combi. The special argument keys can be used to open a searchable
205 list of supported key bindings (see KEY BINDINGS)
206 To show the run-dialog:
209 rofi -show run
212 If -show is the last option passed to rofi, the first enabled modi is
216 shown.
217 -modi mode1,mode2
220 Specify an ordered, comma-separated list of modes to enable. Enabled
223 modes can be changed at runtime. Default key is Ctrl+Tab. If no modes
224 are specified, all configured modes will be enabled. To only show the
225 run and ssh launcher:
226 rofi -modi "run,ssh" -show run
229 Custom modes can be added using the internal script mode. Each such
233 mode has two parameters:
234 <name>:<script>
237 Example: Have a mode called 'Workspaces' using the
241 i3_switch_workspaces.sh script:
242 rofi -modi "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
245 Notes: The i3 window manager dislikes commas in the command when speci‐
249 fying an exec command. For that case, # can be used as a separator.
250 TIP: The name is allowed to contain spaces:
253 rofi -modi "My File Browser:fb.sh" -show "My File Browser"
256 -case-sensitive
260 Start in case-sensitive mode. This option can be changed at run-time
263 using the -kb-toggle-case-sensitivity key binding.
264 -cycle
267 Cycle through the result list. Default is 'true'.
270 -filter filter
273 Filter the list by setting text in input bar to filter
276 -config filename
279 Load an alternative configuration file.
282 -cache-dir filename
285 Directory that is used to place temporary files, like history.
288 -scroll-method method
291 Select the scrolling method. 0: Per page, 1: continuous.
294 -normalize-match
297 Normalize the string before matching, so o will match ö, and é matches
300 e.
301 This is not a perfect implementation, but works. For now, it disables
302 highlighting of the matched part.
303 -no-lazy-grab
306 Disables lazy grab, this forces the keyboard being grabbed before gui
309 is shown.
310 -no-plugins
313 Disable plugin loading.
316 -plugin-path directory
319 Specify the directory where rofi should look for plugins.
322 -show-icons
325 Show application icons in drun and window modes.
328 -icon-theme
331 Specify icon theme to be used. If not specified default theme from DE
334 is used, Adwaita and gnome themes act as fallback themes.
335 -application-fallback-icon
338 Specify an icon to be used when the application icon in run/drun are
341 not yet loaded or is not available.
342 -markup
345 Use Pango markup to format output wherever possible.
348 -normal-window
351 Make rofi react like a normal application window. Useful for scripts
354 like Clerk that are basically an application.
355 -[no-]steal-focus
358 Make rofi steal focus on launch and restore close to window that held
361 it when launched.
362 Matching
365 -matching method
366 Specify the matching algorithm used. Currently, the following methods
369 are supported:
370 • normal: match the int string
373 • regex: match a regex input
375 • glob: match a glob pattern
377 • fuzzy: do a fuzzy match
379 • prefix: match prefix
381 Default: normal
385 Note: glob matching might be slow for larger lists
388 -tokenize
391 Tokenize the input.
394 -drun-categories category1,category2
397 Only show desktop files that are present in the listed categories.
400 -drun-match-fields field1,field2,...
403 When using drun, match only with the specified Desktop entry fields.
406 The different fields are:
407 • name: the application's name
410 • generic: the application's generic name
412 • exec: the application's executable
414 • categories: the application's categories
416 • comment: the application comment
418 •
420 all: all the above
423 Default: name,generic,exec,categories,keywords
425 -drun-display-format
429 The format string for the drun dialog:
432 • name: the application's name
435 • generic: the application's generic name
437 • exec: the application's executable
439 • categories: the application's categories
441 • comment: the application comment
443 Pango markup can be used to formatting the output.
447 Default: {name} [<span weight='light' size='small'><i>({generic})</i></span>]
450 Note: Only fields enabled in -drun-match-fields can be used in the for‐
454 mat string.
455 -[no-]drun-show-actions
458 Show actions present in the Desktop files.
461 Default: false
464 -window-match-fields field1,field2,...
468 When using window mode, match only with the specified fields. The dif‐
471 ferent fields are:
472 • title: window's title
475 • class: window's class
477 • role: window's role
479 • name: window's name
481 • desktop: window's current desktop
483 •
485 all: all the above
488 Default: all
490 -matching-negate-char char
494 Set the character used to negate the query (i.e. if it does not match
497 the next keyword). Set to '\x0' to disable.
498 Default: '-'
501 Layout and Theming
505 IMPORTANT:
506 In newer rofi releases, all the theming options have been moved into
507 the new theme format. They are no longer normal
508 rofi options that can be passed directly on the command line (there
509 are too many).
510 Small snippets can be passed on the command line: rofi -theme-str
511 'window {width: 50%;}' to override a single
512 setting. They are merged into the current theme.
513 They can also be appended at the end of the rofi config file to over‐
514 ride parts of the theme.
515 Most of the following options are deprecated and should not be used.
518 Please use the new theme format to customize rofi. More information
519 about the new format can be found in the rofi-theme(5) manpage.
520 -location
523 Specify where the window should be located. The numbers map to the fol‐
526 lowing locations on screen:
527 1 2 3
530 8 0 4
531 7 6 5
532 Default: 0
536 -fixed-num-lines
539 Keep a fixed number of visible lines.
542 -sidebar-mode
545 Open in sidebar-mode. In this mode, a list of all enabled modes is
548 shown at the bottom. (See -modi option) To show sidebar, use:
549 rofi -show run -sidebar-mode
552 -hover-select
556 Automatically select the entry the mouse is hovering over. This option
559 is best combined with custom mouse bindings. To utilize hover-select
560 and accept an entry in a single click, use:
561 rofi -show run -hover-select -me-select-entry '' -me-accept-entry MousePrimary
564 -eh number
568 Set row height (in chars) Default: 1
571 -auto-select
574 When one entry is left, automatically select it.
577 -m num
580 -m name
583 -monitor num
586 -monitor name
589 Select monitor to display rofi on. It accepts as input: primary (if
592 primary output is set), the xrandr output name, or integer number (in
593 order of detection). Negative numbers are handled differently:
594 • -1: the currently focused monitor.
597 • -2: the currently focused window (that is, rofi will be dis‐
599 played on top of the focused window).
600 • -3: Position of mouse (overrides the location setting to get
602 normal context menu behavior.)
603 • -4: the monitor with the focused window.
605 •
607 -5: the monitor that shows the mouse pointer.
610 Default: -5
612 See rofi -h output for the detected monitors, their position, and size.
616 -theme filename
619 Path to the new theme file format. This overrides the old theme set‐
622 tings.
623 -theme-str string
626 Allow theme parts to be specified on the command line as an override.
629 For example:
632 rofi -theme-str '#window { fullscreen: true; }'
635 This option can be specified multiple times. This is now the method to
639 tweak the theme via the command line.
640 -dpi number
643 Override the default DPI setting.
646 • If set to 0, it tries to auto-detect based on X11 screen size
649 (similar to i3 and GTK).
650 • If set to 1, it tries to auto-detect based on the size of the
652 monitor that rofi is displayed on (similar to latest Qt 5).
653 -selected-row selected row
657 Select a certain row.
660 Default: 0
663 PATTERN setting
666 -terminal
667 Specify which terminal to start.
670 rofi -terminal xterm
673 Pattern: {terminal}
677 Default: x-terminal-emulator
680 -ssh-client client
683 Override the used ssh client.
686 Pattern: {ssh-client}
689 Default: ssh
692 SSH settings
695 -ssh-command cmd
696 Set the command to execute when starting an ssh session. The pattern
699 {host} is replaced by the selected ssh entry.
700 Pattern: {ssh-client}
703 Default: {terminal} -e {ssh-client} {host}
706 -parse-hosts
709 Parse the /etc/hosts file for entries.
712 Default: disabled
715 -parse-known-hosts -no-parse-known-hosts
718 Parse the /.ssh/known_hosts file for entries.
721 Default: enabled
724 Run settings
727 -run-command cmd
728 Set command ({cmd}) to execute when running an application. See PAT‐
731 TERN.
732 Default: {cmd}
735 -run-shell-command cmd
738 Set command to execute when running an application in a shell. See
741 PATTERN.
742 Default: {terminal} -e {cmd}
745 -run-list-command cmd
748 If set, use an external tool to generate a list of executable commands.
751 Uses run-command.
752 Default: {cmd}
755 Window switcher settings
758 -window-format format
759 Format what is being displayed for windows.
762 format: {field[:len]}
765 field:
768 • w: desktop name
771 • t: title of window
773 • n: name
775 • r: role
777 • c: class
779 len: maximum field length (0 for auto-size). If length and window width
783 are negative, field length is width - len.
784 If length is positive, the entry will be truncated or padded to fill
785 that length.
786 default: {w} {c} {t}
789 -window-command cmd
792 Set command to execute on selected window for an alt action (-kb-ac‐
795 cept-alt). See PATTERN.
796 Default: "wmctrl -i -R {window}"
799 -window-thumbnail
802 Show window thumbnail (if available) as icon in the window switcher.
805 You can stop rofi from exiting when closing a window (allowing multiple
808 to be closed in a row).
809 configuration {
812 window {
813 close-on-delete: false;
814 }
815 }
816 Combi settings
820 -combi-modi mode1,mode2
821 The modi to combine in combi mode. For syntax to -combi-modi, see
824 -modi. To get one merge view, of window,run, and ssh:
825 rofi -show combi -combi-modi "window,run,ssh" -modi combi
828 NOTE: The i3 window manager dislikes commas in the command when speci‐
832 fying an exec command. For that case, # can be used as a separator.
833 -combi-display-format
836 The format string for entries in the combi dialog:
839 • mode: the mode display name
842 • text: the entry text
844 Pango markup can be used to formatting the output.
848 Default: {mode} {text}
851 Note: This setting is ignored if combi-hide-mode-prefix is eanbled.
855 History and Sorting
858 -disable-history -no-disable-history (re-enable history)
859 Disable history
862 -sort to enable -no-sort to disable
865 Enable, disable sorting. This setting can be changed at runtime (see
868 -kb-toggle-sort).
869 -sorting-method 'method' to specify the sorting method.
872 There are 2 sorting methods:
875 • levenshtein (Default)
878 • fzf sorting.
880 -max-history-size number
884 Maximum number of entries to store in history. Defaults to 25. (WARN‐
887 ING: can cause slowdowns when set too high)
888 Message dialog
891 -e message
892 Pops up a message dialog (used internally for showing errors) with mes‐
895 sage. Message can be multi-line.
896 File browser settings
899 File browser behavior can be controlled via the following options:
900 configuration {
903 filebrowser {
904 /** Directory the file browser starts in. */
905 directory: "/some/directory";
906 /**
907 * Sorting method. Can be set to:
908 * - "name"
909 * - "mtime" (modification time)
910 * - "atime" (access time)
911 * - "ctime" (change time)
912 */
913 sorting-method: "name";
914 /** Group directories before files. */
915 directories-first: true;
916 }
917 }
918 Other
922 -drun-use-desktop-cache
923 Build and use a cache with the content of desktop files. Usable for
926 systems with slow hard drives.
927 -drun-reload-desktop-cache
930 If drun-use-desktop-cache is enabled, rebuild a cache with the content
933 of desktop files.
934 -drun-url-launcher command
937 Command to open a Desktop Entry that is a Link.
940 -pid path
943 Make rofi create a pid file and check this on startup. The pid file
946 prevents multiple rofi instances from running simultaneously. This is
947 useful when running rofi from a key-binding daemon.
948 -replace
951 If rofi is already running, based on pid file, try to kill that in‐
954 stance.
955 -display-{mode} string
958 Set the name to use for mode. This is used as prompt and in
961 combi-browser.
962 It is now preferred to use the configuration file:
965 configuration {
968 {mode} {
969 display-name: *string*;
970 }
971 }
972 -click-to-exit -no-click-to-exit
976 Click the mouse outside the rofi window to exit.
979 Default: enabled
982
985 To launch commands (for example, when using the ssh launcher), the user
986 can enter the used command-line. The following keys can be used that
987 will be replaced at runtime:
988 • {host}: the host to connect to
991 • {terminal}: the configured terminal (see -terminal)
993 • {ssh-client}: the configured ssh client (see -ssh-client)
995 • {cmd}: the command to execute
997 • {window}: the window ID of the selected window (in window-com‐
999 mand)
1000
1004 Please see rofi-theme(5) manpage for more information on theming.
1005
1008 rofi has the following key bindings:
1009 • Control-v, Insert: Paste from clipboard
1012 • Control-Shift-v, Shift-Insert: Paste primary selection
1014 • Control-u: Clear the line
1016 • Control-a: Beginning of line
1018 • Control-e: End of line
1020 • Control-f, Right: Forward one character
1022 • Alt-f, Control-Right: Forward one word
1024 • Control-b, Left: Back one character
1026 • Alt-b, Control-Left: Back one word
1028 • Control-d, Delete: Delete character
1030 • Control-Alt-d: Delete word
1032 • Control-h, Backspace, Shift-Backspace: Backspace (delete pre‐
1034 vious character)
1035 • Control-Alt-h: Delete previous word
1037 • Control-j,Control-m,Enter: Accept entry
1039 • Control-n,Down: Select next entry
1041 • Control-p,Up: Select previous entry
1043 • Page Up: Go to previous page
1045 • Page Down: Go to next page
1047 • Control-Page Up: Go to previous column
1049 • Control-Page Down: Go to next column
1051 • Control-Enter: Use entered text as a command (in ssh/run modi)
1053 • Shift-Enter: Launch the application in a terminal (in run
1055 mode)
1056 • Control-Shift-Enter: As Control-Enter and run the command in
1058 terminal (in run mode)
1059 • Shift-Enter: Return the selected entry and move to the next
1061 item while keeping rofi open. (in dmenu)
1062 • Shift-Right: Switch to the next mode. The list can be custom‐
1064 ized with the -modi argument.
1065 • Shift-Left: Switch to the previous mode. The list can be cus‐
1067 tomized with the -modi argument.
1068 • Control-Tab: Switch to the next mode. The list can be custom‐
1070 ized with the -modi argument.
1071 • Control-Shift-Tab: Switch to the previous mode. The list can
1073 be customized with the -modi argument.
1074 • Control-space: Set selected item as input text.
1076 • Shift-Del: Delete entry from history.
1078 • grave: Toggle case sensitivity.
1080 • Alt-grave: Toggle sorting.
1082 • Alt-Shift-S: Take a screenshot and store it in the Pictures
1084 directory.
1085 • Control-l: File complete for run dialog.
1087 This list might not be complete, to get a full list of all key bindings
1091 supported in your rofi, see rofi -h. The options starting with -kb are
1092 keybindings.
1093 Key bindings can be modified using the configuration systems. Multiple
1096 keys can be bound to one action by comma separating them. For example
1097 -kb-primary-paste "Conctrol+v,Insert"
1098 To get a searchable list of key bindings, run rofi -show keys.
1101 A key binding starting with ! will act when all keys have been re‐
1104 leased.
1105 You can bind certain events to key-actions:
1108 Timeout
1111 You can configure an action to be taken when rofi has not been inter‐
1112 acted with for a certain amount of seconds. You can specify a keybind‐
1113 ing to trigger after X seconds.
1114 configuration {
1117 timeout {
1118 delay: 15;
1119 action: "kb-cancel";
1120 }
1121 }
1122 Input change
1126 When the input of the textbox changes:
1127 configuration {
1130 inputchange {
1131 action: "kb-row-first";
1132 }
1133 }
1134 For a full list of bindings, see the rofi-keys(5) manpage.
1138
1141 window
1142 Show a list of all the windows and allow switching between them.
1143 Pressing the delete-entry binding (shift-delete) will close the window.
1144 Pressing the accept-custom binding (control-enter or shift-enter) will
1145 run a command on the window. (See option window-command );
1146 If there is no match, it will try to launch the input.
1149 windowcd
1152 Shows a list of the windows on the current desktop and allows switching
1153 between them. Pressing the delete-entry binding (shift-delete) will
1154 kill the window. Pressing the accept-custom binding (control-enter or
1155 shift-enter) will run a command on the window. (See option window-com‐
1156 mand );
1157 If there is no match, it will try to launch the input.
1160 run
1163 Shows a list of executables in $PATH and can launch them (optional in a
1164 terminal). Pressing the delete-entry binding (shift-delete) will re‐
1165 move this entry from the run history. Pressing the accept-custom bind‐
1166 ing (control-enter) will run the command as entered in the entry box.
1167 Pressing the accept-alt binding (shift-enter) will run the command in a
1168 terminal.
1169 When pressing the mode-complete binding (Control-l), you can use the
1172 File Browser mode to launch the application with a file as the first
1173 argument.
1174 drun
1177 Same as the run launches, but the list is created from the installed
1178 desktop files. It automatically launches them in a terminal if speci‐
1179 fied in the Desktop File. Pressing the delete-entry binding
1180 (shift-delete) will remove this entry from the run history. Pressing
1181 the accept-custom binding (control-enter) will run the command as en‐
1182 tered in the entry box. Pressing the accept-alt binding (shift-enter)
1183 will run the command in a terminal.
1184 When pressing the mode-complete binding (Control-l), you can use the
1187 File Browser mode to launch the application passing a file as argument
1188 if specified in the desktop file.
1189 The DRUN mode tries to follow the XDG Desktop Entry Specification
1192 ⟨https://freedesktop.org/wiki/Specifications/desktop-entry-spec/⟩ and
1193 should be compatible with applications using this standard. Some ap‐
1194 plications create invalid desktop files, rofi will discard these en‐
1195 tries. See the debugging section for more info on DRUN mode, this will
1196 print why desktop files are discarded.
1197 There are two advanced options to tweak the behaviour:
1200 configuration {
1203 drun {
1204 /** Parse user desktop files. */
1205 parse-user: true;
1206 /** Parse system desktop files. */
1207 parse-system: false;
1208 }
1209 }
1210 ssh
1214 Shows a list of SSH targets based on your ssh config file, and allows
1215 to quickly ssh into them.
1216 keys
1219 Shows a searchable list of key bindings.
1220 script
1223 Allows custom scripted Modi to be added, see the rofi-script(5) manpage
1224 for more information.
1225 combi
1228 Combines multiple modi in one list. Specify which modi are included
1229 with the -combi-modi option.
1230 When using the combi mode, a !bang can be used to filter the results by
1233 modi. All modi that match the bang as a prefix are included. For ex‐
1234 ample, say you have specified -combi-modi run,window,windowcd. If your
1235 query begins with the bang !w, only results from the window and win‐
1236 dowcd modi are shown, even if the rest of the input text would match
1237 results from run.
1238 If no match, the input is handled by the first combined modi.
1241
1244 The text in the window switcher is not nicely aligned.
1245 Try using a mono-space font.
1246 The window is completely black.
1249 Check quotes used on the command-line: you might have used “ ("smart
1250 quotes") instead of " ("machine quotes").
1251 What does the icon in the top right show?
1254 The indicator shows:
1255 ` ` Case insensitive and no sorting.
1258 `-` Case sensitivity enabled, no sorting.
1259 `+` Case insensitive and Sorting enabled
1260 `±` Sorting and Case sensitivity enabled"
1261 Why do I see different icons for run,drun and window mode
1265 Each of these modes uses different methods of resolving the icon:
1266 • Window: It first uses the icon that the application exposes
1269 via the X11 Server, if none is set it does a lookup of the
1270 window Class name in the icon theme.
1271 • drun: It uses the icon set in the desktop file.
1273 • run: It does a lookup using the executable name.
1275
1279 Some basic usage examples of rofi:
1280 Show the run dialog:
1283 rofi -modi run -show run
1286 Show the run dialog, and allow switching to Desktop File run dialog
1290 (drun):
1291 rofi -modi run,drun -show run
1294 Combine the run and Desktop File run dialog (drun):
1298 rofi -modi combi -show combi -combi-modi run,drun
1301 Combine the run and Desktop File run dialog (drun), and allow switching
1305 to window switcher:
1306 rofi -modi combi,window -show combi -combi-modi run,drun
1309 Pop up a text message claiming that this is the end:
1313 rofi -e "This is the end"
1316 Pop up a text message in red, bold font claiming that this is still the
1320 end:
1321 rofi -e "<span color='red'><b>This is still the end</b></span>" -markup
1324 Show all key bindings:
1328 rofi -show keys
1331 Use qalc to get a simple calculator in rofi:
1335 rofi -show calc -modi "calc:qalc +u8 -nocurrencies"
1338
1342 In i3 ⟨http://i3wm.org/⟩ you want to bind rofi to be launched on key
1343 release. Otherwise, it cannot grab the keyboard. See also the i3 man‐
1344 ual ⟨http://i3wm.org/docs/userguide.html⟩:
1345 Some tools (such as import or xdotool) might be unable to run upon a
1348 KeyPress event, because the keyboard/pointer is still grabbed. For
1349 these situations, the --release flag can be used, as it will execute
1350 the command after the keys have been released.
1351
1354 MIT/X11
1355 Permission is hereby granted, free of charge, to any person obtaining
1357 a copy of this software and associated documentation files (the
1358 "Software"), to deal in the Software without restriction, including
1359 without limitation the rights to use, copy, modify, merge, publish,
1360 distribute, sublicense, and/or sell copies of the Software, and to
1361 permit persons to whom the Software is furnished to do so, subject to
1362 the following conditions:
1363 The above copyright notice and this permission notice shall be
1365 included in all copies or substantial portions of the Software.
1366 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
1368 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
1369 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
1370 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
1371 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
1372 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
1373 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1374
1378 rofi website can be found here ⟨https://davedavenport.github.io/rofi/⟩
1379
1382 rofi support can be obtained:
1383 * GitHub Discussions ⟨https://github.com/davatorium/rofi/discussions⟩
1384 * Forum (Reddit) ⟨https://reddit.com/r/qtools//⟩
1385 * IRC ⟨irc://irc.libera.chat:6697/#rofi⟩ (#rofi on irc.libera.chat),
1386
1389 To debug, it is smart to first try disabling your custom configuration:
1390 -no-config
1391 Disable parsing of configuration. This runs rofi in stock mode.
1394 If you run custom C plugins, you can disable them using:
1397 -no-plugins
1400 Disables the loading of plugins.
1403 To further debug the plugin, you can get a trace with (lots of) debug
1406 information. This debug output can be enabled for multiple parts in
1407 rofi using the glib debug framework. Debug domains can be enabled by
1408 setting the G_MESSAGES_DEBUG environment variable. At the time of cre‐
1409 ation of this page, the following debug domains exist:
1410 • all: Show debug information from all domains.
1413 • X11Helper: The X11 Helper functions.
1415 • View: The main window view functions.
1417 • Widgets.Box: The Box widget.
1419 • Dialogs.DMenu: The dmenu mode.
1421 • Dialogs.Run: The run mode.
1423 • Dialogs.DRun: The desktop file run mode.
1425 • Dialogs.Window: The window mode.
1427 • Dialogs.Script: The script mode.
1429 • Dialogs.Combi: The script mode.
1431 • Dialogs.Ssh: The ssh mode.
1433 • Rofi: The main application.
1435 • Timings: Get timing output.
1437 • Theme: Theme engine debug output. (warning lots of output).
1439 • Widgets.Icon: The Icon widget.
1441 • Widgets.Box: The box widget.
1443 • Widgets.Container: The container widget.
1445 • Widgets.Window: The window widget.
1447 • Helpers.IconFetcher: Information about icon lookup.
1449 The output of this can provide useful information when writing an is‐
1453 sue.
1454 More information (possibly outdated) see this ⟨https://github.com/Dave‐
1457 Davenport/rofi/wiki/Debugging%20Rofi⟩ wiki entry.
1458
1461 The rofi issue tracker can be found here ⟨https://github.com/DaveDaven‐
1462 port/rofi/issues⟩
1463 When creating an issue, please read this ⟨https://github.com/DaveDaven‐
1466 port/rofi/blob/master/.github/CONTRIBUTING.md⟩ first.
1467
1470 rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-script(5),
1471 rofi-keys(5),rofi-theme-selector(1)
1472
1475 • Qball Cow ⟨qball@blame.services⟩
1476 • Rasmus Steinke ⟨rasi@xssn.at⟩
1478 • Quentin Glidic ⟨sardemff7+rofi@sardemff7.net⟩
1480 Original code based on work by: Sean Pringle ⟨https://github.com/sean‐
1484 pringle/simpleswitcher⟩ ⟨sean.pringle@gmail.com⟩
1485 For a full list of authors, check the AUTHORS file.
1488 rofi ROFI(1)