rofi/doc/rofi-manpage.markdown

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 ] [ -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:

• F12

  Show all windows on all desktops.

• mod1-F2

  Show run-dialog.

• mod1-F3

  Show 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

Dump the current active configuration to the command-line.

-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