Академический Документы
Профессиональный Документы
Культура Документы
NAME
rofi - A window switcher, application launcher, ssh dia‐
log and dmenu replacement
SYNOPSIS
rofi [ -show mode ]|[ -dmenu ]|[ -e msg ] [ CONFIGURATION
]
DESCRIPTION
rofi 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.
USAGE
rofi'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 ssh. There
are different modi for different types of actions.
Running rofi
To launch rofi directly in a certain mode, specify a mode
with rofi -show <mode>. To show the run dialog:
Emulating dmenu
rofi can emulate dmenu(1) (a dynamic menu for X) when
launched with the -dmenu flag.
CONFIGURATION
There are currently three methods of setting configura‐
tion options (evaluated in order below):
rofi.lines: 10
rofi -lines 10
rofi -dump-xresources
· string
· char
· Boolean
-X
To disable option X:
-no-X
Below is a list of the most important options:
General
-help
-dump-xresources
-threads num
· 1: Disable threading
-dmenu
-show mode
-modi mode1,mode1
<name>:<script>
-case-sensitive
-cycle
-filter filter
-config filename
-scroll-method method
-no-show-match
-no-lazy-grab
-no-plugins
-plugin-path directory
-show-icons
Show application icons in drun and window modes.
-drun-icon-theme
Matching
-matching method
Default: normal
-tokenize
-drun-match-fields field1,field2,...
Default: name,generic,exec,categories
-window-match-fields field1,field2,...
Default: all
Layout
Most of the following options are deprecated and should
not be used. Please use the new theme format to customize
rofi. More information about the new format can be found
in the rofi-theme(5) manpage.
-lines
rofi -lines 25
Default: 15
-columns
rofi -columns 2
Default: 1
-width [value]
rofi -width 60
Default: 50
-location
1 2 3
8 0 4
7 6 5
Default: 0
-fixed-num-lines
-padding
Default: 5
-fullscreen
-sidebar-mode
-auto-select
-m num
-m name
-monitor num
-monitor name
Default: -5
See rofi -h output for the detected monitors, their posi‐
tion, and size.
-theme filename
Path to the new theme file format. This overrides the old
theme settings.
-theme-str string
For example:
-dpi number
PATTERN setting
-terminal
-ssh-client client
SSH settings
-ssh-command cmd
-parse-hosts
Default: disabled
-parse-known-hosts -no-parse-known-hosts
Parse the ~/.ssh/known_hosts file for entries.
Default: enabled
Run settings
-run-command cmd
Default: {cmd}
-run-shell-command cmd
-run-list-command cmd
Default: {cmd}
format: {field[:len]}
field:
· w: desktop name
· t: title of window
· n: name
· r: role
· c: class
-window-command cmd
Disable history
Dmenu specific
-sep separator
-p prompt
Default: dmenu
Default: 0
rofi -lines 25
Default: 15
-i
-a X
-u X
-only-match
-no-custom
-format format
· 'd' index (1 - N)
Default: 's'
-select string
-mesg string
-normal-window
-dump
-input file
-password
-markup-rows
-multi-select
-sync
Force rofi mode to first read all data from stdin before
showing the selection window. This is original dmenu
behavior.
-async-pre-read number
default: 25
Message dialog
-e message
-fake-transparency
-fake-background
-display-{mode} string
Set the name to use for mode. This is used as prompt and
in combi-browser.
-click-to-exit -no-click-to-exit
Default: enabled
Debug
-no-config
-no-plugins
G_MESSAGES_DEBUG=all
G_MESSAGES_DEBUG=Dialogs.DRun
PATTERN
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 run‐
time:
· {host}: the host to connect to
DMENU REPLACEMENT
If argv[0] (calling command) is dmenu, rofi will start in
dmenu mode. This way it can be used as a drop-in replace‐
ment for dmenu. Just copy or symlink rofi to dmenu in
$PATH.
ln -s /usr/bin/rofi /usr/bin/dmenu
THEMING
The theme format below describes the old (pre version
1.4) theme format. Please see rofi-theme(5) manpage for
an updated manual.
COLORS
RGB colors can be specified by either their X11 name or
hexadecimal notation. For example:
white
Or:
#FFFFFF
Or:
#FF444444
The first two fields specify the alpha level. This deter‐
mines the amount of transparency (00 everything, FF noth‐
ing). The other fields represent the actual color, in
hex.
KEY BINDINGS
rofi has the following key bindings:
A key binding starting with ! will act when all keys have
been released.
Available Modi
Window
Show a list of all the windows and allow switching
between them. Pressing the delete-entry binding
(shift-delete) will close the window. Pressing the
accept-custom binding (control-enter or shift-enter) will
run a command on the window. (See option window-command
);
WindowCD
Shows a list of the windows on the current desktop and
allows switching between them. Pressing the delete-entry
binding (shift-delete) will kill the window. Pressing the
accept-custom binding (control-enter or shift-enter) will
run a command on the window. (See option window-command
);
Run
Shows a list of executables in $PATH and can launch them
(optional in a terminal). Pressing the delete-entry bind‐
ing (shift-delete) will remove this entry from the run
history. Pressing the accept-custom binding (con‐
trol-enter or shift-enter) will run the command in a ter‐
minal.
DRun
Same as the run 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 delete-entry binding (shift-delete) will
remove this entry from the run history. Pressing the
accept-custom binding (control-enter or shift-enter) with
custom input (no entry matching) will run the command in
a terminal.
SSH
Shows a list of SSH targets based on your ssh config
file, and allows to quickly ssh into them.
Keys
Shows a searchable list of key bindings.
Script
Allows custom scripted Modi to be added.
FAQ
The text in the window switcher is not nicely lined out.
Try using a mono-space font.
EXAMPLES
Some basic usage examples of rofi:
Combine the run and Desktop File run dialog (drun), and
allow switching to window switcher:
i3
In i3 http://i3wm.org/ you want to bind rofi to be
launched on key release. Otherwise, it cannot grab the
keyboard. See also the i3 manual
http://i3wm.org/docs/userguide.html:
LICENSE
MIT/X11
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.
WEBSITE
rofi website can be found here https://davedaven‐
port.github.io/rofi/
SUPPORT
rofi support can be obtained here irc://irc.freen‐
ode.net/#rofi (#rofi on irc.freenode.net), or via the
forum https://reddit.com/r/qtools//
DEBUGGING
Please see this https://github.com/DaveDaven‐
port/rofi/wiki/Debugging%20Rofi wiki entry.
ISSUE TRACKER
rofi issue tracker can be found here
https://github.com/DaveDavenport/rofi/issues
SEE ALSO
rofi-sensible-terminal(1), dmenu(1), rofi-theme(5),
rofi-theme-selector(1)
AUTHOR
Qball Cow qball@gmpclient.org