Keyboard

Customize keyboard shortcuts by adding a [keyboard] section to your config.toml.

toml

[keyboard]
move_up = ["alt+up", "alt+k"]
move_down = ["alt+down", "alt+j"]
move_left = ["alt+left", "alt+h"]
move_right = ["alt+right", "alt+l"]
quit_application = "alt+q"
command_bar = "noop"

You can disable a keybind by setting it to "noop" or "none". Each shortcut accepts either a single keybind string or an array of keybind strings.

Modifiers

Specify what modifier keys must be pressed to invoke the action with these special strings:

shift: The Shift key
ctrl: The Control key
alt, option, opt: The Alt key, or Option (macOS)
command, cmd: The Command/⌘ key (macOS) or Control on Linux/Windows
logo, super, windows: The Windows key (Windows), Command key (macOS), Super key (Linux)

Modifiers can be combined with a +, for example:

toml

mark_as_read = "shift+command+u"

Actions

Below is a list of all actions which can be mapped.

Key	Description	Default MacOS	Default Other
`move_up`	Moves pane focus up	`⌘` + `⌥` + `↑`	`ctrl` + `alt` + `↑`
`move_down`	Moves pane focus down	`⌘` + `⌥` + `↓`	`ctrl` + `alt` + `↓`
`move_left`	Moves pane focus left	`⌘` + `⌥` + `←`	`ctrl` + `alt` + `←`
`move_right`	Moves pane focus right	`⌘` + `⌥` + `→`	`ctrl` + `alt` + `→`
`new_horizontal_buffer`	New horizontal buffer	None	None
`new_vertical_buffer`	New vertical buffer	None	None
`close_buffer`	Close focused buffer	`⌘` + `w`	`ctrl` + `w`
`maximize_buffer`	Maximize focused buffer	`⌘` + `shift` + `↑`	`ctrl` + `shift` + `↑`
`restore_buffer`	Restore focused buffer	`⌘` + `shift` + `↓`	`ctrl` + `shift` + `↓`
`cycle_next_buffer`	Cycle to next buffer	`ctrl` + `tab`	`ctrl` + `tab`
`cycle_previous_buffer`	Cycle to previous buffer	`ctrl` + `shift` + `tab`	`ctrl` + `shift` + `tab`
`cycle_next_unread_buffer`	Cycle to next buffer	`ctrl` + `	`ctrl` + `
`cycle_previous_unread_buffer`	Cycle to previous buffer	`ctrl` + `shift` + `	`ctrl` + `shift` + `
`scroll_up_page`	Scroll buffer up a page	`Fn` + `↑`	`pageup`
`scroll_down_page`	Scroll buffer down a page	`Fn` + `↓`	`pagedown`
`scroll_to_top`	Scroll to top of buffer	`⌘` + `↑`	`ctrl` + `↑`
`scroll_to_bottom`	Scroll to bottom of buffer	`⌘` + `↓`	`ctrl` + `↓`
`leave_buffer`	Leave channel or close query	`⌘` + `shift` + `w`	`ctrl` + `shift` + `w`
`mark_as_read`	Mark focused buffer as read	`⌘` + `shift` + `m`	`ctrl` + `shift` + `m`
`config_editor_save`	Save config in Config Editor	`⌘` + `s`	`ctrl` + `s`
`toggle_nick_list`	Toggle nick list	`⌘` + `⌥` + `m`	`ctrl` + `alt` + `m`
`toggle_topic`	Toggle topic	`⌘` + `⌥` + `t`	`ctrl` + `alt` + `t`
`toggle_sidebar`	Toggle sidebar	`⌘` + `⌥` + `b`	`ctrl` + `alt` + `b`
`toggle_fullscreen`	Toggle fullscreen	`⌘` + `ctrl` + `f`	`F11`
`command_bar`	Toggle command bar	`⌘` + `k`	`ctrl` + `k`
`reload_configuration`	Reload configuration file	`⌘` + `r`	`ctrl` + `r`
`file_transfers`	Toggle File Transfers Buffer	`⌘` + `j`	`ctrl` + `j`
`logs`	Toggle Logs Buffer	`⌘` + `l`	`ctrl` + `l`
`theme_editor`	Toggle Theme Editor Window	`⌘` + `t`	`ctrl` + `t`
`highlights`	Toggle Highlights Window	`⌘` + `i`	`ctrl` + `i`
`quit_application`	Quit Halloy	None	None
`open_config_editor`	Toggle Config Editor Buffer	`⌘` + `,`	`ctrl` + `,`
`open_config_file`	Open settings file in system editor	None	None
`show_muted_buffers`	Show muted buffers	None	None
`hide_muted_buffers`	Hide muted buffers	None	None
`focus_up`	Move focus up	`ctrl` + `↑`	`alt` + `↑`
`focus_down`	Move focus down	`ctrl` + `↓`	`alt` + `↓`
`focus_left`	Move focus left	`ctrl` + `←`	`alt` + `←`
`focus_right`	Move focus right	`ctrl` + `→`	`alt` + `→`
`focus_activate`	Activate selected element	`enter`, `space`	`space`, `enter`
`focus_activate_alt`	Alternative action for selected element	`shift` + `enter`, `shift` + `space`	`shift` + `enter`, `shift` + `space`
`focus_reply`	Reply to focused message	`r`	`r`
`focus_react`	Add reaction to focused message	`=`	`=`
`focus_redact`	Redact focused message	`backspace`	`backspace`

Keyboard ​

Modifiers ​

Actions ​

Keyboard

Modifiers

Actions