rofi/doc/rofi-keys.5.markdown

# ROFI-KEYS 5 rofi-keys

## NAME

**rofi keys** - Rofi Key and Mouse bindings

## DESCRIPTION

**rofi** supports overriding of any of it key and mouse binding.

## Setting binding

Bindings can be done on the commandline (-{bindingname}):

```bash
rofi -show run -kb-accept-entry 'Control+Shift+space'
```

or via the configuration file:

```css
configuration {
  kb-accept-entry: "Control+Shift+space";
}
```

The key can be set by its name (see above) or its keycode:

```css
configuration {
  kb-accept-entry: "Control+Shift+[65]";
}
```

An easy way to look up keycode is xev(1).

Multiple keys can be specified for an action as a comma separated list:

```css
configuration {
  kb-accept-entry: "Control+Shift+space,Return";
}
```

By Default **rofi** reacts on pressing, to act on the release of all keys
prepend the binding with `!`:

```css
configuration {
  kb-accept-entry: "!Control+Shift+space,Return";
}
```

## Unsetting a binding

To unset a binding, pass an empty string.

```css
configuration {
  kb-clear-line: "";
}
```

## Keyboard Bindings

### **kb-primary-paste**:

Paste primary selection

**Default**: 	Control+V,Shift+Insert

### **kb-secondary-paste**

Paste clipboard

**Default**: 	Control+v,Insert

### **kb-secondary-copy**

Copy current selection to clipboard

**Default**: 	Control+c

### **kb-clear-line**

Clear input line

**Default**: 	Control+w

### **kb-move-front**

Beginning of line

**Default**: 	Control+a

### **kb-move-end**

End of line

**Default**: 	Control+e

### **kb-move-word-back**

Move back one word

**Default**: 	Alt+b,Control+Left

### **kb-move-word-forward**

Move forward one word

**Default**: 	Alt+f,Control+Right

### **kb-move-char-back**

Move back one char

**Default**: 	Left,Control+b

### **kb-move-char-forward**

Move forward one char

**Default**: 	Right,Control+f

### **kb-remove-word-back**

Delete previous word

**Default**: 	Control+Alt+h,Control+BackSpace

### **kb-remove-word-forward**

Delete next word

**Default**: 	Control+Alt+d

### **kb-remove-char-forward**

Delete next char

**Default**: 	Delete,Control+d

### **kb-remove-char-back**

Delete previous char

**Default**: 	BackSpace,Shift+BackSpace,Control+h

### **kb-remove-to-eol**

Delete till the end of line

**Default**: 	Control+k

### **kb-remove-to-sol**

Delete till the start of line

**Default**: 	Control+u

### **kb-accept-entry**

Accept entry

**Default**: 	Control+j,Control+m,Return,KP\_Enter

### **kb-accept-custom**

Use entered text as command (in ssh/run modes)

**Default**: 	Control+Return

### **kb-accept-custom-alt**

Use entered text as command (in ssh/run modes)

**Default**: 	Control+Shift+Return

### **kb-accept-alt**

Use alternate accept command.

**Default**: 	Shift+Return

### **kb-delete-entry**

Delete entry from history

**Default**: 	Shift+Delete

### **kb-mode-next**

Switch to the next mode.

**Default**: 	Shift+Right,Control+Tab

### **kb-mode-previous**

Switch to the previous mode.

**Default**: 	Shift+Left,Control+ISO\_Left\_Tab

### **kb-mode-complete**

Start completion for mode.

**Default**: 	Control+l

### **kb-row-left**

Go to the previous column

**Default**: 	Control+Page\_Up

### **kb-row-right**

Go to the next column

**Default**: 	Control+Page\_Down

### **kb-row-up**

Select previous entry

**Default**: 	Up,Control+p

### **kb-row-down**

Select next entry

**Default**: 	Down,Control+n

### **kb-row-tab**

Go to next row, if one left, accept it, if no left next mode.

**Default**:

### **kb-element-next**

Go to next row.

**Default**: Tab

### **kb-element-prev**

Go to previous row.

**Default**: ISO\_Left\_Tab

### **kb-page-prev**

Go to the previous page

**Default**: 	Page\_Up

### **kb-page-next**

Go to the next page

**Default**: 	Page\_Down

### **kb-row-first**

Go to the first entry

**Default**: 	Home,KP\_Home

### **kb-row-last**

Go to the last entry

**Default**: 	End,KP\_End

### **kb-row-select**

Set selected item as input text

**Default**: 	Control+space

### **kb-screenshot**

Take a screenshot of the rofi window

**Default**: 	Alt+S

### **kb-ellipsize**

Toggle between ellipsize modes for displayed data

**Default**: 	Alt+period

### **kb-toggle-case-sensitivity**

Toggle case sensitivity

**Default**: 	grave,dead\_grave

### **kb-toggle-sort**

Toggle sort

**Default**: 	Alt+grave

### **kb-cancel**

Quit rofi

**Default**: 	Escape,Control+g,Control+bracketleft

### **kb-custom-1**

Custom keybinding 1

**Default**: 	Alt+1

### **kb-custom-2**

Custom keybinding 2

**Default**: 	Alt+2

### **kb-custom-3**

Custom keybinding 3

**Default**: 	Alt+3

### **kb-custom-4**

Custom keybinding 4

**Default**: 	Alt+4

### **kb-custom-5**

Custom Keybinding 5

**Default**: 	Alt+5

### **kb-custom-6**

Custom keybinding 6

**Default**: 	Alt+6

### **kb-custom-7**

Custom Keybinding 7

**Default**: 	Alt+7

### **kb-custom-8**

Custom keybinding 8

**Default**: 	Alt+8

### **kb-custom-9**

Custom keybinding 9

**Default**: 	Alt+9

### **kb-custom-10**

Custom keybinding 10

**Default**: 	Alt+0

### **kb-custom-11**

Custom keybinding 11

**Default**: 	Alt+exclam

### **kb-custom-12**

Custom keybinding 12

**Default**: 	Alt+at

### **kb-custom-13**

Custom keybinding 13

**Default**: 	Alt+numbersign

### **kb-custom-14**

Custom keybinding 14

**Default**: 	Alt+dollar

### **kb-custom-15**

Custom keybinding 15

**Default**: 	Alt+percent

### **kb-custom-16**

Custom keybinding 16

**Default**: 	Alt+dead\_circumflex

### **kb-custom-17**

Custom keybinding 17

**Default**: 	Alt+ampersand

### **kb-custom-18**

Custom keybinding 18

**Default**: 	Alt+asterisk

### **kb-custom-19**

Custom Keybinding 19

**Default**: 	Alt+parenleft

### **kb-select-1**

Select row 1

**Default**: 	Super+1

### **kb-select-2**

Select row 2

**Default**: 	Super+2

### **kb-select-3**

Select row 3

**Default**: 	Super+3

### **kb-select-4**

Select row 4

**Default**: 	Super+4

### **kb-select-5**

Select row 5

**Default**: 	Super+5

### **kb-select-6**

Select row 6

**Default**: 	Super+6

### **kb-select-7**

Select row 7

**Default**: 	Super+7

### **kb-select-8**

Select row 8

**Default**: 	Super+8

### **kb-select-9**

Select row 9

**Default**: 	Super+9

### **kb-select-10**

Select row 10

**Default**: 	Super+0

### **kb-entry-history-up**

Go up in the entry history.

**Default**:    Control+Up

### **kb-entry-history-down**

Go down in the entry history.

**Default**:    Control+Down

## Mouse Bindings

### **ml-row-left**

Go to the previous column

**Default**: 	ScrollLeft

### **ml-row-right**

Go to the next column

**Default**: 	ScrollRight

### **ml-row-up**

Select previous entry

**Default**: 	ScrollUp

### **ml-row-down**

Select next entry

**Default**: 	ScrollDown

### **me-select-entry**

Select hovered row

**Default**: 	MousePrimary

### **me-accept-entry**

Accept hovered row

**Default**: 	MouseDPrimary

### **me-accept-custom**

Accept hovered row with custom action

**Default**: 	Control+MouseDPrimary

## SEE ALSO

rofi(1), rofi-sensible-terminal(1), rofi-theme(5), rofi-script(5)

## AUTHOR

Qball Cow <qball@gmpclient.org>

Rasmus Steinke <rasi@xssn.at>

Morgane Glidic <sardemff7+rofi@sardemff7.net>

Original code based on work by: Sean Pringle <sean.pringle@gmail.com>

For a full list of authors, check the AUTHORS file.