Keybindings

There are certain actions that you can change the Keybindings for. The configuration for each action is the same.

Keybinding Configuration

Multiple Bindings per Action

You can also define multiple bindings for one action by putting them into an array (action = [bidning1, binding2, etc.]).

A bindig can be either a keycode or a keycode combined with one or more modifiers for that key. All of the following are a valid way of configuring a binding (where action is one of the configurable actions)

action = "esc"

A keycode without any modifiers

action = { code = "l", modifiers = "CONTROL | SHIFT" } # or with just a single modifier
action = { code = "l", modifiers = "CONTROL" }

A keycode with modifiers

These can be mixed together when defining multiple bindings for one action

action = [
    { code = "l", modifiers = "CONTROL" },
    "esc",
]

Keycodes

A keycode can be a simple character or a non-character key These are the supported non-character keys (lower-/uppercase doesn't matter);

Key	Config Name
Backspace	backspace
Enter	enter
Left	left
Right	right
Up	up
Down	down
Home	home
End	end
Page Up	pageup
Page Down	pagedown
Tab	tab
Back Tab	backtab
Del	delete
Ins	insert
Esc	esc
F1-F12	f1-f12

Modifiers

The following modifiers are available. You can also combine them using | as a separator. Please note that these modifiers are case-sensitive

Key	Config Name
Shift	SHIFT
Ctrl	CONTROL
Alt	ALT

Default Keybindings

Below are the default keybindings for all of the configurable actions

Global Keybindings

Action	Description	Default Binding
scroll_down	Scroll down	J
scroll_up	Scroll down	K
scroll_to_top	Scroll to the top	g / Home
scroll_to_bottom	Scroll to the bottom	G / End
pop_popup	Remove the displayed popup	Esc
half_down	Scroll half a page down	Ctrl+D / Page Down
half-up	Scroll half a page up	Ctrl+U / Page Up
unselect_scroll	Unselect the current selection	H
submit	Submit the selected form or open the selection	Enter
quit	Quit the program	Q
enter_search_bar	Focus the searchbar	I
exit_search_bar	Defocus the searchbar (return to the previous focus)	Esc
switch_context_search	Switch to the search pane	S
switch_context_page	Switch to the page pane	P
toggle_search_language_selection	Toggle the search language selection popup	F2
toggle_logger	Toggle the logger view	L

The default configuration file for the global keybindings

[bindings.global]
scroll_down = "j"
scroll_up = "k"

scroll_to_top = [ "g", "home" ]
scroll_to_bottom = [
    { code = "G", modifiers = "SHIFT" }, 
    "end",
]

pop_popup = "esc"

half_down = [
    { code = "d", modifiers = "CONTROL" },
    "pagedown",
]
half_up = [
    { code = "u", modifiers = "CONTROL" },
    "pageup",
]

unselect_scroll = "h"

submit = "enter"
quit = "q"

enter_search_bar = "i"
exit_search_bar = "esc"

switch_context_search = "s"
switch_context_page = "p"

toggle_search_language_selection = "f2"
toggle_logger = "l"

Search Keybindings

Action	Description	Default Binding
continue_search	Continue the search	C

The default configuration for the search keybindings

[bindings.search]
continue_search = "c"

Page Keybindings

Action	Description	Default Binding
pop_page	Remove the current page from the stack	Esc
jump_to_header	Jump to the selected header in the toc (only if toc is focussed)	Enter
select_first_link	Select the first link in the page	Shift+Left
select_last_link	Select the last link in the page	Shift+Right
select_prev_link	Select the previous link in the page	Left
select_next_link	Select the next link in the page	Right
open_link	Open the currently selected link	Enter
toggle_page_language_selection	Toggle the popup for changing the page language	F3
toggle_zen_mode	Toggle the zen-mode for the page	F4
toggle_toc	Switch the focus to the toc (or page)	Tab / Back Tab

The default configuration for the page keybindings

[bindings.page]
pop_page = "esc"
jump_to_header = "enter"

select_first_link = { code = "left", modifiers = "SHIFT" }
select_last_link = { code = "right", modifiers = "SHIFT" }

select_prev_link = "left"
select_next_link = "right"

open_link = "enter"

toggle_page_language_selection = "f3"
toggle_zen_mode = "f4"
toggle_toc = [ "tab", "backtab" ]