Key Bindings

Keyboard shortcuts and keybind configuration.

Overview

All actions in runa are configurable via the [keys] section. All values are lists supporting multiple shortcuts per action.

Modifier Syntax

For keys involving Ctrl, Alt/Meta or Shift, use the following syntax:

Modifier	Bracketed	Standard	Result
Control	`<c-key>`	`ctrl+key`	Ctrl+Key
Alt/Meta	`<a-key>` or `<m-key>`	`alt+key` or `meta+key`	Alt+Key
Shift	`<s-key>`	`shift+key`	Shift+Key

File Operations

`open_file`

Default: ["enter"]

Open the selected file or enter directory.

`delete`

Default: ["d"]

Delete file (behavior controlled by [general] move_to_trash).

`alternate_delete`

Default: ["<m-d>"]

Alternates between move_to_trash and permanently delete.

`copy`

Default: ["y"]

Copy file to clipboard.

`paste`

Default: ["p"]

Paste file from clipboard.

`rename`

Default: ["r"]

Rename file.

`create`

Default: ["n"]

Create new file.

`create_directory`

Default: ["N"]

Create new directory.

`move_file`

Default: ["m"]

Move file.

`go_up`

Default: ["k", "up"]

Move selection up.

`go_down`

Default: ["j", "down"]

Move selection down.

`go_parent`

Default: ["h", "left", "back"]

Go to parent directory.

`go_into_dir`

Default: ["l", "right"]

Enter directory.

`go_to_bottom`

Default: ["G"]

Jump to last entry.

Go-To Actions (Prefix-based)

These actions are triggered by pressing the prefix_go_to key, then another key.

Example: Press “g” then “p” for go_to_path

`prefix_go_to`

Default: ["g"]

Prefix key for go-to actions.

`go_to_top`

Default: ["g"]

Jump to first entry.

`go_to_home`

Default: ["h"]

Go to home directory.

`go_to_path`

Default: ["p"]

Go to specific path (opens input dialog).

View and Display

`filter`

Default: ["f"]

Filter entries by pattern.

`find`

Default: ["s"]

Search/find files (requires fd for best performance).

`show_info`

Default: ["i"]

Show detailed file information widget.

Selection and Markers

`toggle_marker`

Default: ["space"]

Toggle marker on current entry (multi-select).

`select_all`

Default: ["<c-a>"]

Select all entries in current directory.

`clear_markers`

Default: ["<c-c>"]

Clear all markers.

Filtering and Cleanup

`clear_filter`

Default: ["<c-f>"]

Clear active filter.

`clear_clipboard`

Default: ["<f2>"]

Clear clipboard.

`clear_all`

Default: ["<c-l>"]

Clear all (filter, clipboard, markers).

Sorting

Sorting actions are triggered by pressing the sort key, then another key.

Example: Press “o” then “e” for sort_by_extension

`sort`

Default: ["o"]

Prefix key to trigger sorting.

`sort_by_name`

Default: ["n"]

Sort by filename.

`sort_by_natural`

Default: ["N"]

Sort by natural order.

`sort_by_extension`

Default: ["e"]

Sort by file extension.

`sort_by_size`

Default: ["s"]

Sort by file size.

`sort_by_modified`

Default: ["m"]

Sort by modified date.

`sort_by_created`

Default: ["c"]

Sort by created date.

`sort_by_accessed`

Default: ["a"]

Sort by accessed date.

Tab Management

`tab_new`

Default: ["<c-t>"]

Create new tab.

`tab_close`

Default: ["<c-w>"]

Close current tab.

`tab_next`

Default: ["<c-n>"]

Switch to next tab.

`tab_prev`

Default: ["<c-p>"]

Switch to previous tab.

`scroll_up`

Default: ["<c-d>"]

Scroll up in widgets.

`scroll_down`

Default: ["<c-u>"]

Scroll down in widgets.

General

`quit`

Default: ["q", "esc"]

Quit runa.

`keybind_help`

Default: ["?"]

Show keybinding help dialog.

Configuration Notes

Multiple keybinds per action are supported
You can use " " for space key
Single keybind instead of array is also possible:
```
sort = "o"
find = "s"
```
You may remove any binding to let it fall back to the default
go_to_* actions are triggered by pressing the “g” prefix, then another key
sort_by_* actions are triggered by pressing the “o” (sort) prefix, then the sort key