mirror of
https://github.com/davatorium/rofi.git
synced 2024-10-27 05:23:18 -04:00
6caece77d4
* [Textbox] Add history to the entrybox. * [Textbox] Add comments and move into sub functions. * [doc] Add conflicting constraint section to manpage. * [Script] Some small memory leak fixes. * [Entry History] Add documentation. fixes: #785
1667 lines
32 KiB
Groff
1667 lines
32 KiB
Groff
.nh
|
|
.TH ROFI 1 rofi
|
|
.SH NAME
|
|
.PP
|
|
\fBrofi\fP - A window switcher, application launcher, ssh dialog, dmenu replacement and more
|
|
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\fBrofi\fP [ -show \fImode\fP ]|[ -dmenu ]|[ -e \fImsg\fP ] [ CONFIGURATION ]
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
\fBrofi\fP is an X11 pop-up window switcher, run dialog, dmenu replacement, and
|
|
more. It focuses on being fast to use and have minimal distraction. It supports
|
|
keyboard and mouse navigation, type to filter, tokenized search and more.
|
|
|
|
.SH USAGE
|
|
.PP
|
|
\fBrofi\fP\&'s main functionality is to assist in your workflow, allowing you to
|
|
quickly switch between windows, start applications or log into a remote machine
|
|
via \fB\fCssh\fR\&. There are different \fImodes\fP for different types of actions. \fBrofi\fP
|
|
is a standalone application and should not be integrated into scripts. For
|
|
integration into scripts it has a special mode that functions as a (drop-in)
|
|
replacement for \fBdmenu(1)\fP\&. See emulating dmenu below.
|
|
|
|
.SS Running rofi
|
|
.PP
|
|
To launch \fBrofi\fP directly in a certain mode, specify a mode with \fB\fCrofi -show <mode>\fR\&.
|
|
To show the \fB\fCdrun\fR dialog:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show drun
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
A useful setup in minimalistic window managers is to combine \fB\fCdrun\fR, \fB\fCrun\fR
|
|
with \fB\fCwindow\fR mode:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show combi -modes combi -combi-modes "window,drun,run"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
In this setup it first list all open applications, then all installed
|
|
applications. So if you type firefox and hit return, it will switch to the
|
|
running firefox, or launch it when it is not running.
|
|
|
|
.SS Emulating dmenu
|
|
.PP
|
|
\fBrofi\fP can emulate \fBdmenu(1)\fP (a dynamic menu for X11) when launched with
|
|
the \fB\fC-dmenu\fR flag.
|
|
|
|
.PP
|
|
For more information see \fBrofi-dmenu(5)\fP\&.
|
|
|
|
.SS Display Error message
|
|
.PP
|
|
\fBrofi\fP error dialog can also be called from the command line.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -e "my message"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Markup support can be enabled, see CONFIGURATION options.
|
|
|
|
.SH CONFIGURATION
|
|
.PP
|
|
There are currently three methods of setting configuration options (evaluated in order below):
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
System configuration file (for example \fB\fC/etc/rofi.rasi\fR).
|
|
It first checks \fB\fCXDG_CONFIG_DIRS\fR, and then \fB\fCSYSCONFDIR\fR (that is passed at compile time).
|
|
It loads the first config file it finds, it does not merge multiple system configuration files.
|
|
.IP \(bu 2
|
|
Rasi theme file: The new \fItheme\fP format can be used to set configuration values.
|
|
.IP \(bu 2
|
|
Command-line options: Arguments passed to \fBrofi\fP\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
To get a template config file, run: \fB\fCrofi -dump-config > config.rasi\fR
|
|
|
|
.PP
|
|
This will contain (commented) all current configuration options, modified options are uncommented.
|
|
|
|
.PP
|
|
To get a template config file that sets the icon-theme run: \fB\fCrofi -icon-theme hicolor -dump-config\fR\&.
|
|
|
|
.PP
|
|
It is \fBstrongly\fP recommended to use this as a starting point for your configuration.
|
|
|
|
.PP
|
|
An empty configuration section in the config file looks like:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
// set config options here
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Most of the configuration options mentioned below (beside options like \fB\fC-show\fR,
|
|
\fB\fC-dump-config\fR that apply to a single run) can be set here.
|
|
|
|
.PP
|
|
For example to set the dpi value to 72:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
dpi: 72;
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
The configuration system supports the following types:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
string
|
|
.IP \(bu 2
|
|
integer (signed and unsigned)
|
|
.IP \(bu 2
|
|
char
|
|
.IP \(bu 2
|
|
boolean
|
|
.IP \(bu 2
|
|
lists
|
|
|
|
.RE
|
|
|
|
.PP
|
|
For the syntax of these options, see the \fBrofi-theme(5)\fP manpage.
|
|
|
|
.PP
|
|
For use on the command line, Boolean options have a non-default command-line
|
|
syntax. Example to enable option X:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
-X
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
To disable option X:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
-no-X
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Below is a list of the most important options:
|
|
|
|
.SS General
|
|
.PP
|
|
\fB\fC-help\fR
|
|
|
|
.PP
|
|
The help option shows the full list of command-line options and the current set
|
|
values. These include dynamic (run-time generated) options.
|
|
|
|
.PP
|
|
\fB\fC-version\fR
|
|
|
|
.PP
|
|
Show the \fBrofi\fP version and exit.
|
|
|
|
.PP
|
|
\fB\fC-dump-config\fR
|
|
|
|
.PP
|
|
Dump the current active configuration, in rasi format, to stdout and exit.
|
|
Information about the rasi format can be found in the \fBrofi-theme(5)\fP manpage.
|
|
|
|
.PP
|
|
\fB\fC-dump-theme\fR
|
|
|
|
.PP
|
|
Dump the current active theme, in rasi format, to stdout and exit.
|
|
|
|
.PP
|
|
\fB\fC-rasi-validate\fR \fIfilename\fP
|
|
|
|
.PP
|
|
Try to parse the file and return 0 when successful, non-zero when failed.
|
|
|
|
.PP
|
|
\fB\fC-list-keybindings\fR
|
|
|
|
.PP
|
|
List all known keybindings without trying to parse them. This can be used to
|
|
look for duplicate bindings.
|
|
|
|
.PP
|
|
\fB\fC-threads\fR \fInum\fP
|
|
|
|
.PP
|
|
Specify the number of threads \fBrofi\fP should use:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
0: Autodetect the number of supported hardware threads.
|
|
.IP \(bu 2
|
|
1: Disable threading
|
|
.IP \(bu 2
|
|
2..n: Specify the maximum number of threads to use in the thread pool.Default: Autodetect
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-display\fR \fIdisplay\fP
|
|
|
|
.PP
|
|
The X server to contact. Default is \fB\fC$DISPLAY\fR\&.
|
|
|
|
.PP
|
|
\fB\fC-dmenu\fR
|
|
|
|
.PP
|
|
Run \fBrofi\fP in dmenu mode. This allows for interactive scripts.
|
|
In \fB\fCdmenu\fR mode, \fBrofi\fP reads from STDIN, and output to STDOUT.
|
|
A simple example, displaying three pre-defined options:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
echo -e "Option #1\\nOption #2\\nOption #3" | rofi -dmenu
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Or get the options from a script:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
~/my_script.sh | rofi -dmenu
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
See the \fBrofi-dmenu(5)\fP manpage for more information.
|
|
|
|
.PP
|
|
\fB\fC-show\fR \fImode\fP
|
|
|
|
.PP
|
|
Open \fBrofi\fP in a certain mode. Available modes are \fB\fCwindow\fR, \fB\fCrun\fR, \fB\fCdrun\fR,
|
|
\fB\fCssh\fR, \fB\fCcombi\fR\&. The special argument \fB\fCkeys\fR can be used to open a searchable
|
|
list of supported key bindings
|
|
(see the \fBrofi-keys(5)\fP manpage)
|
|
|
|
.PP
|
|
To show the run-dialog:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show run
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
If \fB\fC-show\fR is the last option passed to rofi, the first enabled modes is shown.
|
|
|
|
.PP
|
|
\fB\fC-modes\fR \fImode1,mode2\fP
|
|
|
|
.PP
|
|
Specify an ordered, comma-separated list of modes to enable.
|
|
Enabled modes can be changed at runtime. Default key is \fB\fCCtrl+Tab\fR\&.
|
|
If no modes are specified, all configured modes will be enabled.
|
|
To only show the \fB\fCrun\fR and \fB\fCssh\fR launcher:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes "run,ssh" -show run
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Custom modes can be added using the internal \fB\fCscript\fR mode. Each such mode has
|
|
two parameters:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
<name>:<script>
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Example: Have a mode called 'Workspaces' using the \fB\fCi3_switch_workspaces.sh\fR script:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Notes: The i3 window manager dislikes commas in the command when specifying an
|
|
exec command. For that case, \fB\fC#\fR can be used as a separator.
|
|
|
|
.PP
|
|
\fBTIP\fP: The name is allowed to contain spaces:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes "My File Browser:fb.sh" -show "My File Browser"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-case-sensitive\fR
|
|
|
|
.PP
|
|
Start in case-sensitive mode.
|
|
This option can be changed at run-time using the \fB\fC-kb-toggle-case-sensitivity\fR key binding.
|
|
|
|
.PP
|
|
\fB\fC-cycle\fR
|
|
|
|
.PP
|
|
Cycle through the result list. Default is 'true'.
|
|
|
|
.PP
|
|
\fB\fC-filter\fR \fIfilter\fP
|
|
|
|
.PP
|
|
Filter the list by setting text in input bar to \fIfilter\fP
|
|
|
|
.PP
|
|
\fB\fC-config\fR \fIfilename\fP
|
|
|
|
.PP
|
|
Load an alternative configuration file.
|
|
|
|
.PP
|
|
\fB\fC-cache-dir\fR \fIfilename\fP
|
|
|
|
.PP
|
|
Directory that is used to place temporary files, like history.
|
|
|
|
.PP
|
|
\fB\fC-scroll-method\fR \fImethod\fP
|
|
|
|
.PP
|
|
Select the scrolling method. 0: Per page, 1: continuous.
|
|
|
|
.PP
|
|
\fB\fC-normalize-match\fR
|
|
|
|
.PP
|
|
Normalize the string before matching, so \fB\fCo\fR will match \fB\fCö\fR, and \fB\fCé\fR matches \fB\fCe\fR\&.
|
|
.br
|
|
This is not a perfect implementation, but works. For now, it disables highlighting of the matched part.
|
|
|
|
.PP
|
|
\fB\fC-no-lazy-grab\fR
|
|
|
|
.PP
|
|
Disables lazy grab, this forces the keyboard being grabbed before gui is shown.
|
|
|
|
.PP
|
|
\fB\fC-no-plugins\fR
|
|
|
|
.PP
|
|
Disable plugin loading.
|
|
|
|
.PP
|
|
\fB\fC-plugin-path\fR \fIdirectory\fP
|
|
|
|
.PP
|
|
Specify the directory where \fBrofi\fP should look for plugins.
|
|
|
|
.PP
|
|
\fB\fC-show-icons\fR
|
|
|
|
.PP
|
|
Show application icons in \fB\fCdrun\fR and \fB\fCwindow\fR modes.
|
|
|
|
.PP
|
|
\fB\fC-icon-theme\fR
|
|
|
|
.PP
|
|
Specify icon theme to be used.
|
|
If not specified default theme from DE is used, \fIAdwaita\fP and \fIgnome\fP themes act as
|
|
fallback themes.
|
|
|
|
.PP
|
|
\fB\fC-markup\fR
|
|
|
|
.PP
|
|
Use Pango markup to format output wherever possible.
|
|
|
|
.PP
|
|
\fB\fC-normal-window\fR
|
|
|
|
.PP
|
|
Make \fBrofi\fP react like a normal application window. Useful for scripts like Clerk that are basically an application.
|
|
|
|
.PP
|
|
\fB\fC-[no-]steal-focus\fR
|
|
|
|
.PP
|
|
Make rofi steal focus on launch and restore close to window that held it when launched.
|
|
|
|
.PP
|
|
\fB\fC-refilter-timeout-limit\fR
|
|
|
|
.PP
|
|
The time (in ms) boundary filter may take before switch from instant to delayed filter mode.
|
|
|
|
.PP
|
|
Default: 300
|
|
|
|
.PP
|
|
A fallback icon can be specified for each mode:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
<mode>{
|
|
fallback-icon: "<icon name>";
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Example
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
run,drun {
|
|
fallback-icon: "application-x-addon";
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SS Matching
|
|
.PP
|
|
\fB\fC-matching\fR \fImethod\fP
|
|
|
|
.PP
|
|
Specify the matching algorithm used.
|
|
Currently, the following methods are supported:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBnormal\fP: match the int string
|
|
.IP \(bu 2
|
|
\fBregex\fP: match a regex input
|
|
.IP \(bu 2
|
|
\fBglob\fP: match a glob pattern
|
|
.IP \(bu 2
|
|
\fBfuzzy\fP: do a fuzzy match
|
|
.IP \(bu 2
|
|
\fBprefix\fP: match prefix
|
|
|
|
.RE
|
|
|
|
.PP
|
|
Default: \fInormal\fP
|
|
|
|
.PP
|
|
Note: glob matching might be slow for larger lists
|
|
|
|
.PP
|
|
\fB\fC-tokenize\fR
|
|
|
|
.PP
|
|
Tokenize the input.
|
|
|
|
.PP
|
|
\fB\fC-drun-categories\fR \fIcategory1\fP,\fIcategory2\fP
|
|
|
|
.PP
|
|
Only show desktop files that are present in the listed categories.
|
|
|
|
.PP
|
|
\fB\fC-drun-match-fields\fR \fIfield1\fP,\fIfield2\fP,...
|
|
|
|
.PP
|
|
When using \fB\fCdrun\fR, match only with the specified Desktop entry fields.
|
|
The different fields are:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBname\fP: the application's name
|
|
.IP \(bu 2
|
|
\fBgeneric\fP: the application's generic name
|
|
.IP \(bu 2
|
|
\fBexec\fP: the application's executable
|
|
.IP \(bu 2
|
|
\fBcategories\fP: the application's categories
|
|
.IP \(bu 2
|
|
\fBcomment\fP: the application comment
|
|
.IP \(bu 2
|
|
\fBall\fP: all the aboveDefault: \fIname,generic,exec,categories,keywords\fP
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-drun-display-format\fR
|
|
|
|
.PP
|
|
The format string for the \fB\fCdrun\fR dialog:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBname\fP: the application's name
|
|
.IP \(bu 2
|
|
\fBgeneric\fP: the application's generic name
|
|
.IP \(bu 2
|
|
\fBexec\fP: the application's executable
|
|
.IP \(bu 2
|
|
\fBcategories\fP: the application's categories
|
|
.IP \(bu 2
|
|
\fBcomment\fP: the application comment
|
|
|
|
.RE
|
|
|
|
.PP
|
|
Pango markup can be used to formatting the output.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
Default: {name} [<span weight='light' size='small'><i>({generic})</i></span>]
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Note: Only fields enabled in \fB\fC-drun-match-fields\fR can be used in the format string.
|
|
|
|
.PP
|
|
\fB\fC-[no-]drun-show-actions\fR
|
|
|
|
.PP
|
|
Show actions present in the Desktop files.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
Default: false
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-window-match-fields\fR \fIfield1\fP,\fIfield2\fP,...
|
|
|
|
.PP
|
|
When using window mode, match only with the specified fields.
|
|
The different fields are:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBtitle\fP: window's title
|
|
.IP \(bu 2
|
|
\fBclass\fP: window's class
|
|
.IP \(bu 2
|
|
\fBrole\fP: window's role
|
|
.IP \(bu 2
|
|
\fBname\fP: window's name
|
|
.IP \(bu 2
|
|
\fBdesktop\fP: window's current desktop
|
|
.IP \(bu 2
|
|
\fBall\fP: all the aboveDefault: \fIall\fP
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-matching-negate-char\fR \fIchar\fP
|
|
|
|
.PP
|
|
Set the character used to negate the query (i.e. if it does \fBnot\fP match the next keyword).
|
|
Set to '\\x0' to disable.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
Default: '-'
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SS Layout and Theming
|
|
.PP
|
|
\fBIMPORTANT:\fP
|
|
In newer \fBrofi\fP releases, all the theming options have been moved into the new theme format. They are no longer normal
|
|
\fBrofi\fP options that can be passed directly on the command line (there are too many).
|
|
Small snippets can be passed on the command line: \fB\fCrofi -theme-str 'window {width: 50%;}'\fR to override a single
|
|
setting. They are merged into the current theme.
|
|
They can also be appended at the end of the \fBrofi\fP config file to override parts of the theme.
|
|
|
|
.PP
|
|
Most of the following options are \fBdeprecated\fP and should not be used. Please use the new theme format to customize
|
|
\fBrofi\fP\&. More information about the new format can be found in the \fBrofi-theme(5)\fP manpage.
|
|
|
|
.PP
|
|
\fB\fC-location\fR
|
|
|
|
.PP
|
|
Specify where the window should be located. The numbers map to the following locations on screen:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
1 2 3
|
|
8 0 4
|
|
7 6 5
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Default: \fI0\fP
|
|
|
|
.PP
|
|
\fB\fC-fixed-num-lines\fR
|
|
|
|
.PP
|
|
Keep a fixed number of visible lines.
|
|
|
|
.PP
|
|
\fB\fC-sidebar-mode\fR
|
|
|
|
.PP
|
|
Open in sidebar-mode. In this mode, a list of all enabled modes is shown at the bottom.
|
|
(See \fB\fC-modes\fR option)
|
|
To show sidebar, use:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show run -sidebar-mode
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-hover-select\fR
|
|
|
|
.PP
|
|
Automatically select the entry the mouse is hovering over. This option is best combined with custom mouse bindings.
|
|
To utilize hover-select and accept an entry in a single click, use:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show run -hover-select -me-select-entry '' -me-accept-entry MousePrimary
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-eh\fR \fInumber\fP
|
|
|
|
.PP
|
|
Set row height (in chars)
|
|
Default: \fI1\fP
|
|
|
|
.PP
|
|
\fB\fC-auto-select\fR
|
|
|
|
.PP
|
|
When one entry is left, automatically select it.
|
|
|
|
.PP
|
|
\fB\fC-m\fR \fInum\fP
|
|
|
|
.PP
|
|
\fB\fC-m\fR \fIname\fP
|
|
|
|
.PP
|
|
\fB\fC-monitor\fR \fInum\fP
|
|
|
|
.PP
|
|
\fB\fC-monitor\fR \fIname\fP
|
|
|
|
.PP
|
|
Select monitor to display \fBrofi\fP on.
|
|
It accepts as input: \fIprimary\fP (if primary output is set), the \fIxrandr\fP output name, or integer number (in order of
|
|
detection). Negative numbers are handled differently:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fB-1\fP: the currently focused monitor.
|
|
.IP \(bu 2
|
|
\fB-2\fP: the currently focused window (that is, \fBrofi\fP will be displayed on top of the focused window).
|
|
.IP \(bu 2
|
|
\fB-3\fP: Position of mouse (overrides the location setting to get normal context menu
|
|
behavior.)
|
|
.IP \(bu 2
|
|
\fB-4\fP: the monitor with the focused window.
|
|
.IP \(bu 2
|
|
\fB-5\fP: the monitor that shows the mouse pointer.Default: \fI-5\fP
|
|
|
|
.RE
|
|
|
|
.PP
|
|
See \fB\fCrofi -h\fR output for the detected monitors, their position, and size.
|
|
|
|
.PP
|
|
\fB\fC-theme\fR \fIfilename\fP
|
|
|
|
.PP
|
|
Path to the new theme file format. This overrides the old theme settings.
|
|
|
|
.PP
|
|
\fB\fC-theme-str\fR \fIstring\fP
|
|
|
|
.PP
|
|
Allow theme parts to be specified on the command line as an override.
|
|
|
|
.PP
|
|
For example:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -theme-str '#window { fullscreen: true; }'
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
This option can be specified multiple times.
|
|
This is now the method to tweak the theme via the command line.
|
|
|
|
.PP
|
|
\fB\fC-dpi\fR \fInumber\fP
|
|
|
|
.PP
|
|
Override the default DPI setting.
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
If set to \fB\fC0\fR, it tries to auto-detect based on X11 screen size (similar to i3 and GTK).
|
|
.IP \(bu 2
|
|
If set to \fB\fC1\fR, it tries to auto-detect based on the size of the monitor that \fBrofi\fP is displayed on (similar to latest Qt 5).
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-selected-row\fR \fIselected row\fP
|
|
|
|
.PP
|
|
Select a certain row.
|
|
|
|
.PP
|
|
Default: \fI0\fP
|
|
|
|
.SS PATTERN setting
|
|
.PP
|
|
\fB\fC-terminal\fR
|
|
|
|
.PP
|
|
Specify which terminal to start.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -terminal xterm
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Pattern: \fI{terminal}\fP
|
|
|
|
.PP
|
|
Default: \fIx-terminal-emulator\fP
|
|
|
|
.PP
|
|
\fB\fC-ssh-client\fR \fIclient\fP
|
|
|
|
.PP
|
|
Override the used \fB\fCssh\fR client.
|
|
|
|
.PP
|
|
Pattern: \fI{ssh-client}\fP
|
|
|
|
.PP
|
|
Default: \fIssh\fP
|
|
|
|
.SS SSH settings
|
|
.PP
|
|
\fB\fC-ssh-command\fR \fIcmd\fP
|
|
|
|
.PP
|
|
Set the command to execute when starting an ssh session.
|
|
The pattern \fI{host}\fP is replaced by the selected ssh entry.
|
|
|
|
.PP
|
|
Pattern: \fI{ssh-client}\fP
|
|
|
|
.PP
|
|
Default: \fI{terminal} -e {ssh-client} {host}\fP
|
|
|
|
.PP
|
|
\fB\fC-parse-hosts\fR
|
|
|
|
.PP
|
|
Parse the \fB\fC/etc/hosts\fR file for entries.
|
|
|
|
.PP
|
|
Default: \fIdisabled\fP
|
|
|
|
.PP
|
|
\fB\fC-parse-known-hosts\fR
|
|
\fB\fC-no-parse-known-hosts\fR
|
|
|
|
.PP
|
|
Parse the \fB\fC~/.ssh/known_hosts\fR file for entries.
|
|
|
|
.PP
|
|
Default: \fIenabled\fP
|
|
|
|
.SS Run settings
|
|
.PP
|
|
\fB\fC-run-command\fR \fIcmd\fP
|
|
|
|
.PP
|
|
Set command (\fI{cmd}\fP) to execute when running an application.
|
|
See \fIPATTERN\fP\&.
|
|
|
|
.PP
|
|
Default: \fI{cmd}\fP
|
|
|
|
.PP
|
|
Example to run applications in a dedicated cgroup with systemd. Requires a shell to escape and interpolate the unit name correctly.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
"bash -c 'systemd-run --user --unit=app-rofi-\\$(systemd-escape {cmd})-\\$RANDOM {cmd}'"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-run-shell-command\fR \fIcmd\fP
|
|
|
|
.PP
|
|
Set command to execute when running an application in a shell.
|
|
See \fIPATTERN\fP\&.
|
|
|
|
.PP
|
|
Default: \fI{terminal} -e {cmd}\fP
|
|
|
|
.PP
|
|
\fB\fC-run-list-command\fR \fIcmd\fP
|
|
|
|
.PP
|
|
If set, use an external tool to generate a list of executable commands. Uses \fB\fCrun-command\fR\&.
|
|
|
|
.PP
|
|
Default: \fI{cmd}\fP
|
|
|
|
.SS Window switcher settings
|
|
.PP
|
|
\fB\fC-window-format\fR \fIformat\fP
|
|
|
|
.PP
|
|
Format what is being displayed for windows.
|
|
|
|
.PP
|
|
\fIformat\fP: {field[:len]}
|
|
|
|
.PP
|
|
\fIfield\fP:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBw\fP: desktop name
|
|
.IP \(bu 2
|
|
\fBt\fP: title of window
|
|
.IP \(bu 2
|
|
\fBn\fP: name
|
|
.IP \(bu 2
|
|
\fBr\fP: role
|
|
.IP \(bu 2
|
|
\fBc\fP: class
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fIlen\fP: maximum field length (0 for auto-size). If length is negative, the entry will be unchanged.
|
|
If length is positive, the entry will be truncated or padded to fill that length.
|
|
|
|
.PP
|
|
default: {w} {c} {t}
|
|
|
|
.PP
|
|
\fB\fC-window-command\fR \fIcmd\fP
|
|
|
|
.PP
|
|
Set command to execute on selected window for an alt action (\fB\fC-kb-accept-alt\fR).
|
|
See \fIPATTERN\fP\&.
|
|
|
|
.PP
|
|
Default: \fI"wmctrl -i -R {window}"\fP
|
|
|
|
.PP
|
|
\fB\fC-window-thumbnail\fR
|
|
|
|
.PP
|
|
Show window thumbnail (if available) as icon in the window switcher.
|
|
|
|
.PP
|
|
You can stop rofi from exiting when closing a window (allowing multiple to be closed in a row).
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
window {
|
|
close-on-delete: false;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
You can hide the currently active window with the 'hide-active-window' setting:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
window {
|
|
hide-active-window: true;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
or pass \fB\fC-window-hide-active-window true\fR on command line.
|
|
|
|
.PP
|
|
You can prefer the icon theme above the window set icon with the 'prefer-icon-theme' setting:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
window {
|
|
prefer-icon-theme: true;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
or pass \fB\fC-window-prefer-icon-theme true\fR on command line.
|
|
|
|
.SS Combi settings
|
|
.PP
|
|
\fB\fC-combi-modes\fR \fImode1\fP,\fImode2\fP
|
|
|
|
.PP
|
|
The modes to combine in combi mode.
|
|
For syntax to \fB\fC-combi-modes\fR, see \fB\fC-modes\fR\&.
|
|
To get one merge view, of \fB\fCwindow\fR,\fB\fCrun\fR, and \fB\fCssh\fR:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show combi -combi-modes "window,run,ssh" -modes combi
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fBNOTE\fP: The i3 window manager dislikes commas in the command when specifying an exec command.
|
|
For that case, \fB\fC#\fR can be used as a separator.
|
|
|
|
.PP
|
|
\fB\fC-combi-display-format\fR
|
|
|
|
.PP
|
|
The format string for entries in the \fB\fCcombi\fR dialog:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fBmode\fP: the mode display name
|
|
.IP \(bu 2
|
|
\fBtext\fP: the entry text
|
|
|
|
.RE
|
|
|
|
.PP
|
|
Pango markup can be used to formatting the output.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
Default: {mode} {text}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Note: This setting is ignored if \fB\fCcombi-hide-mode-prefix\fR is enabled.
|
|
|
|
.SS History and Sorting
|
|
.PP
|
|
\fB\fC-disable-history\fR
|
|
\fB\fC-no-disable-history\fR (re-enable history)
|
|
|
|
.PP
|
|
Disable history
|
|
|
|
.PP
|
|
\fB\fC-sort\fR to enable
|
|
\fB\fC-no-sort\fR to disable
|
|
|
|
.PP
|
|
Enable, disable sorting.
|
|
This setting can be changed at runtime (see \fB\fC-kb-toggle-sort\fR).
|
|
|
|
.PP
|
|
\fB\fC-sorting-method\fR 'method' to specify the sorting method.
|
|
|
|
.PP
|
|
There are 2 sorting methods:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
levenshtein (Default)
|
|
.IP \(bu 2
|
|
fzf sorting.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-max-history-size\fR \fInumber\fP
|
|
|
|
.PP
|
|
Maximum number of entries to store in history. Defaults to 25. (WARNING: can cause slowdowns when set too high)
|
|
|
|
.SS Message dialog
|
|
.PP
|
|
\fB\fC-e\fR \fImessage\fP
|
|
|
|
.PP
|
|
Pops up a message dialog (used internally for showing errors) with \fImessage\fP\&.
|
|
Message can be multi-line.
|
|
|
|
.SS File browser settings
|
|
.PP
|
|
File browser behavior can be controlled via the following options:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
filebrowser {
|
|
/** Directory the file browser starts in. */
|
|
directory: "/some/directory";
|
|
/**
|
|
* Sorting method. Can be set to:
|
|
* - "name"
|
|
* - "mtime" (modification time)
|
|
* - "atime" (access time)
|
|
* - "ctime" (change time)
|
|
*/
|
|
sorting-method: "name";
|
|
/** Group directories before files. */
|
|
directories-first: true;
|
|
/** Show hidden files. */
|
|
show-hidden: false;
|
|
/** return 1 on cancel. */
|
|
cancel-returns-1: true;
|
|
/** command */
|
|
command: "xdg-open";
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
These options can also be passed on the commandline, for example:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -filebrowser-cancel-returns-1 true -show filebrowser
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
The \fB\fCshow-hidden\fR can also be triggered with the \fB\fCkb-delete-entry\fR keybinding.
|
|
|
|
.SS Entry history
|
|
.PP
|
|
The number of previous inputs for the entry box can be modified by setting
|
|
max-history on the entry box.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
entry {
|
|
max-history: 30;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
By default the file is stored in the systems cache directory, in a file called
|
|
\fB\fCrofi-entry-history.txt\fR\&.
|
|
|
|
.SS Other
|
|
.PP
|
|
\fB\fC-drun-use-desktop-cache\fR
|
|
|
|
.PP
|
|
Build and use a cache with the content of desktop files. Usable for systems with slow hard drives.
|
|
|
|
.PP
|
|
\fB\fC-drun-reload-desktop-cache\fR
|
|
|
|
.PP
|
|
If \fB\fCdrun-use-desktop-cache\fR is enabled, rebuild a cache with the content of desktop files.
|
|
|
|
.PP
|
|
\fB\fC-drun-url-launcher\fR \fIcommand\fP
|
|
|
|
.PP
|
|
Command to open a Desktop Entry that is a Link.
|
|
|
|
.PP
|
|
\fB\fC-pid\fR \fIpath\fP
|
|
|
|
.PP
|
|
Make \fBrofi\fP create a pid file and check this on startup. The pid file prevents multiple \fBrofi\fP instances from running simultaneously. This is useful when running \fBrofi\fP from a key-binding daemon.
|
|
|
|
.PP
|
|
\fB\fC-replace\fR
|
|
|
|
.PP
|
|
If rofi is already running, based on pid file, try to kill that instance.
|
|
|
|
.PP
|
|
\fB\fC-display-{mode}\fR \fIstring\fP
|
|
|
|
.PP
|
|
Set the name to use for mode. This is used as prompt and in combi-browser.
|
|
|
|
.PP
|
|
It is now preferred to use the configuration file:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
{mode} {
|
|
display-name: *string*;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fB\fC-click-to-exit\fR
|
|
\fB\fC-no-click-to-exit\fR
|
|
|
|
.PP
|
|
Click the mouse outside the \fBrofi\fP window to exit.
|
|
|
|
.PP
|
|
Default: \fIenabled\fP
|
|
|
|
.PP
|
|
\fB\fC-xserver-i300-workaround\fR
|
|
|
|
.PP
|
|
Workaround for bug in Xserver. See issue #611 and #1642 on the rofi issue tracker.
|
|
|
|
.PP
|
|
Default: \fIdisabled\fP
|
|
|
|
.SH PATTERN
|
|
.PP
|
|
To launch commands (for example, when using the ssh launcher), the user can enter the used command-line. The following keys can be used that will be replaced at runtime:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
\fB\fC{host}\fR: the host to connect to
|
|
.IP \(bu 2
|
|
\fB\fC{terminal}\fR: the configured terminal (see -terminal)
|
|
.IP \(bu 2
|
|
\fB\fC{ssh-client}\fR: the configured ssh client (see -ssh-client)
|
|
.IP \(bu 2
|
|
\fB\fC{cmd}\fR: the command to execute
|
|
.IP \(bu 2
|
|
\fB\fC{window}\fR: the window ID of the selected window (in \fB\fCwindow-command\fR)
|
|
|
|
.RE
|
|
|
|
.SH THEMING
|
|
.PP
|
|
Please see \fBrofi-theme(5)\fP manpage for more information on theming.
|
|
|
|
.SH KEY BINDINGS
|
|
.PP
|
|
Please see the \fBrofi-keys(5)\fP manpage for the keybindings and how to set them up.
|
|
|
|
.PP
|
|
The keybinding can also be used for actions, when the action is executed the
|
|
mentioned keystroke is inserted:
|
|
|
|
.SS Timeout
|
|
.PP
|
|
You can configure an action to be taken when rofi has not been interacted
|
|
with for a certain amount of seconds. You can specify a keybinding to trigger
|
|
after X seconds.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
timeout {
|
|
delay: 15;
|
|
action: "kb-cancel";
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SS Input change
|
|
.PP
|
|
When the input of the textbox changes:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
inputchange {
|
|
action: "kb-row-first";
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH Available Modes
|
|
.SS window
|
|
.PP
|
|
Show a list of all the windows and allow switching between them.
|
|
Pressing the \fB\fCdelete-entry\fR binding (\fB\fCshift-delete\fR) will close the window.
|
|
Pressing the \fB\fCaccept-custom\fR binding (\fB\fCcontrol-enter\fR or \fB\fCshift-enter\fR) will run a command on the window.
|
|
(See option \fB\fCwindow-command\fR );
|
|
|
|
.PP
|
|
If there is no match, it will try to launch the input.
|
|
|
|
.SS windowcd
|
|
.PP
|
|
Shows a list of the windows on the current desktop and allows switching between them.
|
|
Pressing the \fB\fCdelete-entry\fR binding (\fB\fCshift-delete\fR) will kill the window.
|
|
Pressing the \fB\fCaccept-custom\fR binding (\fB\fCcontrol-enter\fR or \fB\fCshift-enter\fR) will run a command on the window.
|
|
(See option \fB\fCwindow-command\fR );
|
|
|
|
.PP
|
|
If there is no match, it will try to launch the input.
|
|
|
|
.SS run
|
|
.PP
|
|
Shows a list of executables in \fB\fC$PATH\fR and can launch them (optional in a terminal).
|
|
Pressing the \fB\fCdelete-entry\fR binding (\fB\fCshift-delete\fR) will remove this entry from the run history.
|
|
Pressing the \fB\fCaccept-custom\fR binding (\fB\fCcontrol-enter\fR) will run the command as entered in the entry box.
|
|
Pressing the \fB\fCaccept-alt\fR binding (\fB\fCshift-enter\fR) will run the command in a terminal.
|
|
|
|
.PP
|
|
When pressing the \fB\fCmode-complete\fR binding (\fB\fCControl-l\fR), you can use the File Browser mode to launch the application
|
|
with a file as the first argument.
|
|
|
|
.SS drun
|
|
.PP
|
|
Same as the \fBrun\fP launches, but the list is created from the installed desktop files. It automatically launches them
|
|
in a terminal if specified in the Desktop File.
|
|
Pressing the \fB\fCdelete-entry\fR binding (\fB\fCshift-delete\fR) will remove this entry from the run history.
|
|
Pressing the \fB\fCaccept-custom\fR binding (\fB\fCcontrol-enter\fR) will run the command as entered in the entry box.
|
|
Pressing the \fB\fCaccept-alt\fR binding (\fB\fCshift-enter\fR) will run the command in a terminal.
|
|
|
|
.PP
|
|
When pressing the \fB\fCmode-complete\fR binding (\fB\fCControl-l\fR), you can use the File Browser mode to launch the application
|
|
passing a file as argument if specified in the desktop file.
|
|
|
|
.PP
|
|
The DRUN mode tries to follow the XDG Desktop Entry
|
|
Specification
|
|
\[la]https://freedesktop.org/wiki/Specifications/desktop-entry-spec/\[ra] and should be compatible with
|
|
applications using this standard. Some applications create invalid desktop files, \fBrofi\fP will discard these entries.
|
|
See the debugging section for more info on DRUN mode, this will print why desktop files are
|
|
discarded.
|
|
|
|
.PP
|
|
There are two advanced options to tweak the behaviour:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
configuration {
|
|
drun {
|
|
/** Parse user desktop files. */
|
|
parse-user: true;
|
|
/** Parse system desktop files. */
|
|
parse-system: false;
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SS ssh
|
|
.PP
|
|
Shows a list of SSH targets based on your \fB\fCssh\fR config file, and allows to quickly \fB\fCssh\fR into them.
|
|
|
|
.SS keys
|
|
.PP
|
|
Shows a searchable list of key bindings.
|
|
|
|
.SS script
|
|
.PP
|
|
Allows custom scripted Modes to be added, see the \fBrofi-script(5)\fP manpage for more information.
|
|
|
|
.SS combi
|
|
.PP
|
|
Combines multiple modes in one list. Specify which modes are included with the \fB\fC-combi-modes\fR option.
|
|
|
|
.PP
|
|
When using the combi mode, a \fI!bang\fP can be used to filter the results by modes.
|
|
All modes that match the bang as a prefix are included.
|
|
For example, say you have specified \fB\fC-combi-modes run,window,windowcd\fR\&. If your
|
|
query begins with the bang \fB\fC!w\fR, only results from the \fB\fCwindow\fR and \fB\fCwindowcd\fR
|
|
modes are shown, even if the rest of the input text would match results from \fB\fCrun\fR\&.
|
|
|
|
.PP
|
|
If no match, the input is handled by the first combined modes.
|
|
|
|
.SH FAQ
|
|
.SS The text in the window switcher is not nicely aligned.
|
|
.PP
|
|
Try using a mono-space font or tabs + the tab-stops setting..
|
|
|
|
.SS The window is completely black.
|
|
.PP
|
|
Check quotes used on the command-line: you might have used \fB\fC“\fR ("smart quotes") instead of \fB\fC"\fR ("machine quotes").
|
|
|
|
.SS What does the icon in the top right show?
|
|
.PP
|
|
The indicator shows:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
` ` Case insensitive and no sorting.
|
|
`-` Case sensitivity enabled, no sorting.
|
|
`+` Case insensitive and Sorting enabled
|
|
`±` Sorting and Case sensitivity enabled"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SS Why do I see different icons for run,drun and window mode
|
|
.PP
|
|
Each of these modes uses different methods of resolving the icon:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
Window: It first uses the icon that the application exposes via the X11
|
|
Server, if none is set it does a lookup of the window Class name in the icon theme.
|
|
.IP \(bu 2
|
|
drun: It uses the icon set in the desktop file.
|
|
.IP \(bu 2
|
|
run: It does a lookup using the executable name.
|
|
|
|
.RE
|
|
|
|
.SH EXAMPLES
|
|
.PP
|
|
Some basic usage examples of \fBrofi\fP:
|
|
|
|
.PP
|
|
Show the run dialog:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes run -show run
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Show the run dialog, and allow switching to Desktop File run dialog (\fB\fCdrun\fR):
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes run,drun -show run
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Combine the run and Desktop File run dialog (\fB\fCdrun\fR):
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes combi -show combi -combi-modes run,drun
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Combine the run and Desktop File run dialog (\fB\fCdrun\fR), and allow switching to window switcher:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -modes combi,window -show combi -combi-modes run,drun
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Pop up a text message claiming that this is the end:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -e "This is the end"
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Pop up a text message in red, bold font claiming that this is still the end:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -e "<span color='red'><b>This is still the end</b></span>" -markup
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
Show all key bindings:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
rofi -show keys
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH i3
|
|
.PP
|
|
In i3
|
|
\[la]http://i3wm.org/\[ra] you want to bind \fBrofi\fP to be launched on key release. Otherwise, it cannot grab the keyboard.
|
|
See also the i3 manual
|
|
\[la]http://i3wm.org/docs/userguide.html\[ra]:
|
|
|
|
.PP
|
|
Some tools (such as \fB\fCimport\fR or \fB\fCxdotool\fR) might be unable to run upon a KeyPress event, because the keyboard/pointer is
|
|
still grabbed. For these situations, the \fB\fC--release\fR flag can be used, as it will execute the command after the keys have
|
|
been released.
|
|
|
|
.SH LICENSE
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
MIT/X11
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining
|
|
a copy of this software and associated documentation files (the
|
|
"Software"), to deal in the Software without restriction, including
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
|
permit persons to whom the Software is furnished to do so, subject to
|
|
the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be
|
|
included in all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH WEBSITE
|
|
.PP
|
|
\fBrofi\fP website can be found here
|
|
\[la]https://github.com/davatorium/rofi/\[ra]
|
|
|
|
.SH SUPPORT
|
|
.PP
|
|
\fBrofi\fP support can be obtained:
|
|
|
|
.RS
|
|
.IP \(bu 2
|
|
GitHub Discussions
|
|
\[la]https://github.com/davatorium/rofi/discussions\[ra]
|
|
.IP \(bu 2
|
|
IRC
|
|
\[la]irc://irc.libera.chat:6697/#rofi\[ra] (#rofi on irc.libera.chat),
|
|
|
|
.RE
|
|
|
|
.SH DEBUGGING
|
|
.PP
|
|
For more information see \fBrofi-debugging(5)\fP manpage.
|
|
|
|
.SH ISSUE TRACKER
|
|
.PP
|
|
The \fBrofi\fP issue tracker can be found here
|
|
\[la]https://github.com/davatorium/rofi/issues\[ra]
|
|
Before creating an issue, consider posting a question on the discussion forum
|
|
\[la]https://github.com/davatorium/rofi/discussions\[ra] first.
|
|
When creating an issue, please read this
|
|
\[la]https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUTING.md\[ra]
|
|
first.
|
|
|
|
.SH SEE ALSO
|
|
.PP
|
|
\fBrofi-sensible-terminal(1)\fP, \fBdmenu(1)\fP, \fBrofi-debugging(5)\fP, \fBrofi-theme(5)\fP, \fBrofi-script(5)\fP, \fBrofi-keys(5)\fP,\fBrofi-theme-selector(1)\fP,\fBrofi-dmenu(5)\fP
|
|
|
|
.SH AUTHOR
|
|
.RS
|
|
.IP \(bu 2
|
|
Qball Cow qball@blame.services
|
|
\[la]mailto:qball@blame.services\[ra]
|
|
.IP \(bu 2
|
|
Rasmus Steinke rasi@xssn.at
|
|
\[la]mailto:rasi@xssn.at\[ra]
|
|
.IP \(bu 2
|
|
Morgane Glidic sardemff7+rofi@sardemff7.net
|
|
\[la]mailto:sardemff7+rofi@sardemff7.net\[ra]
|
|
|
|
.RE
|
|
|
|
.PP
|
|
Original code based on work by: Sean Pringle
|
|
\[la]https://github.com/seanpringle/simpleswitcher\[ra] sean.pringle@gmail.com
|
|
\[la]mailto:sean.pringle@gmail.com\[ra]
|
|
|
|
.PP
|
|
For a full list of authors, check the \fB\fCAUTHORS\fR file.
|