4.6 KiB
ROFI 1 rofi
NAME
rofi - A window switcher, run dialog and dmenu replacement
SYNOPSIS
rofi [ -width pct_scr ] [ -lines lines ] [ -columns columns ] [ -font xftfont ] [ -fg color ]
[ -bg color ] [ -hlfg color ] [ -hlbg color ] [ -key combo ] [ -dkey comdo ] [ -rkey comdo ]
[ -terminal terminal ] [ -loc position ] [ -hmode ] [ -fixed-num-lines ] [ -padding padding ]
[ -opacity opacity% ] [ -display display ] [ -bc color ] [ -bw width ] [ -dmenu [ -p prompt ] ]
[ -ssh-set-title true|false ] [ -now ] [ -rnow ] [ -snow ] [ -version ] [ -help] [ -dump-xresources ]
DESCRIPTION
rofi is an X11 popup window switcher. A list is displayed center-screen showing open window titles, WM_CLASS, and desktop number.
The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels.
License
MIT/X11
USAGE
rofi can be used in two ways, single-shot; executes once and directly exits when done or as
daemon listening to specific key-combinations.
The default key combinations are:
-
F12Show all windows on all desktops.
-
mod1-F2Show run-dialog.
-
mod1-F3Show run-dialog.
OPTIONS
-key
Change the key combination to display all windows (default: F12).
rofi -key F12
rofi -key control+shift+s
rofi -key mod1+Tab
-rkey
Change the key combination to display the run dialog (default: mod1-F2).
rofi -rkey F11
rofi -rkey control+shift+d
rofi -rkey mod1+grave (grave=backtick)
-skey
Change the key combination to display the ssh dialog (default: Alt-F3).
rofi -skey F10
rofi -skey control+shift+s
rofi -skey mod1+grave (grave=backtick)
-now
Run rofi in all-windows mode once then exit. Does not bind any keys.
-rnow
Run rofi in run-dialog mode once then exit. Does not bind any keys.
-snow
Run rofi in ssh mode once then exit. Does not bind any keys.
-bg
Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222).
rofi -fg "#222222"
-bc
Set the border color (X11 named color or hex #rrggbb) for the menu (default: #000000).
rofi -bc black
-bw
Set the border width in pixels (default: 1).
rofi -bw 1
-fg
Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc).
rofi -fg "#cccccc"
-font
Xft font name for use by the menu (default: mono-14).
rofi -font monospace-14:medium
-hlbg
Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the
menu (default: #005577).
rofi -fg "#005577"
-hlfg
Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the
menu (default: #ffffff).
rofi -fg "#ffffff"
-opacity
Set the window opacity (0-100).
rofi -opacity "75"
-lines
Maximum number of lines the menu may show before scrolling (default: 25).
rofi -lines 25
-columns
The number of columns the menu may show before scrolling (default: 25).
rofi -columns 2
-width
Set the width of the menu as a percentage of the screen width (default: 60).
rofi -width 60
-terminal
Specify what terminal to start (default x-terminal-emulator)
rofi -terminal xterm
-loc
Specify where the window should be located. The numbers map to the following location on the
monitor:
1 2 3
8 0 4
7 6 5
-hmode
Switch to horizontal mode (ala dmenu). The number of elements is the number of lines times the
number of columns.
-fixed-num-lines
Keep a fixed number of visible lines (See the -lines option.)
-padding
Define the inner margin of the window. Default is 5 pixels.
To make rofi look like dmenu:
rofi -hmode -padding 0
-dmenu
Run rofi in dmenu mode. Allowing it to be used for user interaction in scripts.
-dump-xresources
Dump the current active configuration in xresources format to the command-line.
-ssh-set-title true|false
SSH dialogs tries to set 'ssh hostname' of the spawned terminal. Not all terminals support this. Default value is true.
Switch between modi
Type '?' enter to switch between window list, run and ssh mode.
WEBSITE
rofi website can be found at here
AUTHOR
Qball Cow qball@gmpclient.org
Original code based on work by: Sean Pringle sean.pringle@gmail.com