Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Runa Configuration Guide

runa is configured via a TOML file. By default, it looks for your config in the following order:

  1. Environment Variable: RUNA_CONFIG - If set, runa uses this path as the config file

    export RUNA_CONFIG=/path/to/runa.toml
    
  2. XDG Config Directory (Linux, macOS, and supported environments):

    $XDG_CONFIG_HOME/runa/runa.toml
    
  3. Default Path:

    • ~/.config/runa/runa.toml (Linux/macOS)
    • C:\Users\<UserName>\.config\runa\runa.toml (Windows)

runa is under active development and configuration options may change over time.

Installation

Cargo

You can install runa from crates.io

cargo install runa-tui

Arch Linux (AUR)

You can install runa from the AUR using an AUR helper like paru or yay:

yay -S runa

# or for binaries through the AUR
yay -S runa-bin

Homebrew

You can install runa via homebrew.

brew tap alexm-dev/tap
brew install runa

Scoop (Windows)

You can install runa via scoop.

scoop add bucket https://github.com/alexm-dev/scoop-bucket
scoop install runa

Pre-compiled Binaries

If you’d like to download Pre-compiled binaries instead of installing runa as a crate in cargo or via the AUR, you can grab the latest binaries for Linux, Windows and macOS from the Release page.

After downloading, add the rn (Linux/macOS) or rn.exe (Windows) binary to your system PATH to use runa from your terminal.

Build from source

Clone the repo and build with Cargo:

git clone https://github.com/alexm-dev/runa.git
cd runa
cargo build --release
cargo install --path .

Quick Start

If you don’t have a config file yet, generate one:

  • rn --init - Generates a minimal configuration
  • rn --init-full - Generates a full configuration with all options and inline documentation

Other useful commands:

  • rn --help - Shows the CLI help menu
  • rn --version - Displays the current installed version
  • rn --config-help - Displays documentation for configuration sections (e.g., rn --config-help general)

Optional Tool Integration

Some features require external tools to be installed:

  • bat - Fast, syntax-highlighted file previews (optional, highly recommended)
  • fd - Blazing fast recursive file/folder search (optional, highly recommended)

Both tools are completely optional. runa falls back to built-in methods if they’re not installed.

Install with your package manager:

sudo pacman -S bat fd           # Arch
sudo apt install bat fd-find    # Debian/Ubuntu
sudo dnf install bat fd-find    # Fedora/RHEL
brew install bat fd             # macOS

Configuration Sections

Each section below links to detailed documentation for all available options:

General Settings

File visibility, sorting, search behavior, and startup tabs.

Options: dirs_first, show_hidden, show_symlink, show_system, case_insensitive, always_show, max_find_results, move_to_trash, [general.startup]

Display Settings

Pane layout, borders, previews, file information, and UI styling.

Sections: [display], [display.layout], [display.preview_options], [display.info], [display.status]

Theme Configuration

Colors, icon coloring, styling, and widget customization.

Sections: [theme], color overrides for all UI elements, [theme.widget], [theme.status_line], [theme.info]

Editor Configuration

Editor program selection and per-extension/per-filename overrides.

Section: [editor]

Key Bindings

Keyboard shortcuts for all actions and navigation.

Section: [keys]

Complete Reference

For the complete list of all options with defaults and inline documentation, see:

  • runa_full.toml in assets/config
  • Run rn --init-full to generate a full config file with all options

Examples

Minimal Configuration

[general]
dirs_first = true
show_hidden = true

[display]
borders = "unified"

[editor]
default = "nvim"

Custom Theme with Layout

[display]
borders = "split"

[display.layout]
main = 40

[theme]
name = "gruvbox-dark"
selection.fg = "#EBA"
entry.fg = "#333333"
directory.fg = "magenta"

[theme.accent]
fg = "#00ff00"

[theme.widget]
position = [25, 60]
size = { w = 36, h = 20 }

Full Custom Setup

[general]
dirs_first = true
show_hidden = true
startup.tabs = ["cwd", "~/Downloads"]

[display]
borders = "unified"
titles = true
icons = true
preview_underline = false

[display.layout]
preview = 70

[display.preview_options]
method = "bat"
style = "numbers"

[display.info]
format = "{perms} | {size} | {mtime}"
date_format = "%d %b %y %H:%M"

[theme]
accent = "#8ac"
path.bg = "#333333"
status_line.bg = "#333333"
status_line.fg = "#8ac"

[editor]
default = "nvim"

[keys]
scroll_up = ["pgup"]
scroll_down = ["pgdn"]

General Settings

Configuration options that control runa’s general behavior and file visibility.

Overview

The [general] section contains settings for file display, sorting, search behavior, and startup configuration.

Any unused or default options can be removed from runa.toml. Omitted options will use internal defaults.

Options

dirs_first

  • Type: boolean
  • Default: true

Sort directories before files in the main pane. When enabled, directories always appear first, helping you navigate faster without hunting through mixed listings. Sorting methods (natural, name, size, etc.) still apply within directories and files groups separately.

show_hidden

  • Type: boolean
  • Default: true

Show hidden files and directories. On Linux/macOS, displays files starting with . (e.g., .config, .ssh). On Windows, see show_system for system file visibility.

Related: Use always_show to force specific directories visible even when show_hidden = false.

  • Type: boolean
  • Default: true

Show symbolic links and their target paths in the main pane.

show_system

  • Type: boolean
  • Default: false

Show hidden system files. Mostly relevant on Windows. When disabled, system files remain hidden even if show_hidden = true.

case_insensitive

  • Type: boolean
  • Default: true

Ignore case sensitivity when searching and sorting. When enabled, README, readme, and ReadMe are treated as equivalent during sort operations and searches.

always_show

  • Type: array of strings
  • Default: []

List of directory names that should always be visible, even when show_hidden = false. Useful for forcing commonly-used hidden directories to always appear.

Example:

[general]
always_show = [".config", ".ssh", "Downloads"]

max_find_results

  • Type: integer
  • Default: 20000
  • Constraints: Minimum 15, Maximum 1,000,000 (values above are clamped)

Configure the maximum number of find/search results to display. Higher values increase memory usage but show more results. Very large values (100k+) may cause UI lag when scrolling results.

move_to_trash

  • Type: boolean
  • Default: true

When enabled, deleted files are moved to the recycle bin instead of being permanently deleted. This setting controls the default delete action; the alternate_delete keybind alternates between the two behaviors on a per-delete basis.

Startup Configuration

[general.startup]

Configure which tabs open when runa starts.

tabs

  • Type: array of strings
  • Default: [] (unconfigured)

List of paths that open as tabs on startup. Supports up to 9 tabs. Tab placement is determined by the order in the list.

Special values:

  • "cwd" or "." — Opens at the current working directory

Example:

[general.startup]
tabs = ["cwd", "~/Downloads", "~/Projects"]

Notes:

  • On Windows, use single quotes for paths to avoid backslash escaping: 'C:\Users\...'
  • With double quotes, escape backslashes: "C:\\Users\\..."
  • Omitting this section starts runa normally at the current directory
  • You can also start multiple tabs from the CLI: rn ~/path1 ~/path2 ~/path3

Display Settings

Configuration options for UI layout, panes, borders, previews, and file information display.

Overview

The [display] section controls how runa’s interface is laid out and rendered, including pane visibility, borders, preview options, and file information display.

Main Options

selection_marker

  • Type: boolean
  • Default: false

Show the selection icon next to the file/directory name.

dir_marker

  • Type: boolean
  • Default: true

Show the default / symbol next to directory names.

borders

  • Type: string
  • Default: "unified"
  • Options: "none", "unified", "split"

Border style for the panes.

border_shape

  • Type: string
  • Default: "square"
  • Options: "square", "rounded", "double"

Border shape for the panes.

titles

  • Type: boolean
  • Default: true

Show pane titles at the top (e.g., “Main”, “Preview”).

icons

  • Type: boolean
  • Default: false

Show Nerd Font icons. Requires a Nerd Font to be installed and used.

separators

  • Type: boolean
  • Default: true

Draw vertical lines between panes.

parent

  • Type: boolean
  • Default: true

Show the parent directory pane (left).

preview

  • Type: boolean
  • Default: true

Show the file preview pane (right).

preview_underline

  • Type: boolean
  • Default: true

Enable underline in the preview pane.

preview_underline_color

  • Type: boolean
  • Default: false

Use independent color for the preview underline.

entry_padding

  • Type: integer
  • Default: 1
  • Range: 0–4

Padding from entry to pane edge.

scroll_padding

  • Type: integer
  • Default: 5

Scroll padding of the main pane.

toggle_marker_jump

  • Type: boolean
  • Default: false

Toggle if the marker selection should jump to the first entry whenever selection is at the bottom.

instant_preview

  • Type: boolean
  • Default: true

Toggle previews to instantly render on every selection change. False results in pending preview when holding down a navigation key.

sort_date_format

  • Type: string
  • Default: "%b %e %H:%M"

Configuration of the sorting date format when sorting by a date (Modified, Created, Accessed). Uses the standard strftime-style format codes.

Common specifiers:

  • %Y - 4 digit year (2026)
  • %y - 2 digit year (26)
  • %m - Month number (01-12)
  • %b - Month name (Jan, Feb, etc.)
  • %d - Day of the month
  • %H - Hour
  • %M - Minute
  • %S - Second
  • %p - AM/PM

Examples:

  • "%Y-%m-%d" → 2026-04-04
  • "%d.%m.%Y %H:%M" → 04.04.2026 14:30
  • "%b %d, %Y" → Apr 04, 2026

This will show up in the sorting column next to entries.

Preview Options

[display.preview_options]

Options for the preview method used by the preview pane.

method

  • Type: string
  • Default: "internal"
  • Options: "internal", "bat"

Options: “internal” and “bat”. For “bat” you will need to have bat installed otherwise it will fallback to internal.

style (when method = “bat”)

  • Type: string
  • Default: "plain"
  • Options: "plain", "numbers", "full"

Change the style of the bat preview method.

theme (when method = “bat”)

  • Type: string
  • Default: "default"

Options to set the bat theme of the bat preview method. All available bat themes are supported. See bat --list-themes

wrap (when method = “bat”)

  • Type: boolean
  • Default: false

Toggle wrapping the bat output to the pane width.

  • If false, long lines stay on one line and go off-screen
  • If true, all the lines are wrapped to the pane width

tab_width (when method = “bat”)

  • Type: integer
  • Default: 4

Configure the tab indentation of bat. This does not overwrite every file preview indentation.

Layout Configuration

[display.layout]

Display ratios for panes (will be scaled to 100%).

parent

  • Type: integer
  • Default: 20

Parent pane width ratio.

main

  • Type: integer
  • Default: 40

Main pane width ratio.

preview

  • Type: integer
  • Default: 40

Preview pane width ratio.

File Information Display

[display.info]

Display the file info attributes.

name

  • Type: boolean
  • Default: true

Show file/directory name.

file_type

  • Type: boolean
  • Default: true

Show file type.

size

  • Type: boolean
  • Default: true

Show file size.

modified

  • Type: boolean
  • Default: true

Show modified date.

created

  • Type: boolean
  • Default: true

Show created date.

accessed

  • Type: boolean
  • Default: false

Show accessed date.

perms

  • Type: boolean
  • Default: true

Show file permissions.

owner

  • Type: boolean
  • Default: true

Toggle the Owner and Group file information for Unix. If disabled, then its also off for the status bar.

group

  • Type: boolean
  • Default: true

Show file group information (Unix only).

position

  • Type: string
  • Default: "bottom_left"

Position of the File Info widget.

status_bar

  • Type: boolean
  • Default: true

Enable file information on the status bar on the bottom left.

format

  • Type: string
  • Default: "{perms} | {size}"

Configure the format string of the file information on the status bar if enabled.

Available keys: perms, size, mtime/modified, btime/created, atime/accessed, type, and on unix additionally: owner, group.

date_format

  • Type: string
  • Default: "%Y-%m-%d %H:%M"

Configure the date format for file timestamps (Modified, Created, Accessed). Uses the standard strftime-style format codes.

Common specifiers:

  • %Y - 4 digit year (2026)
  • %y - 2 digit year (26)
  • %m - Month number (01-12)
  • %b - Month name (Jan, Feb, etc.)
  • %d - Day of the month
  • %H - Hour
  • %M - Minute
  • %S - Second
  • %p - AM/PM

Examples:

  • "%Y-%m-%d" → 2026-04-04
  • "%d.%m.%Y %H:%M" → 04.04.2026 14:30
  • "%b %d, %Y" → Apr 04, 2026

Status Line Configuration

[display.status]

Display the status line options on the status line (Header or Footer).

Available options: "footer", "header", or "none" to disable

entry_count

  • Type: string
  • Default: "footer"

Position to display entry count.

filter

  • Type: string
  • Default: "header"

Position to display active filter status.

markers

  • Type: string
  • Default: "footer"

Position to display marker count.

clipboard

  • Type: string
  • Default: "footer"

Position to display clipboard status.

tasks

  • Type: string
  • Default: "footer"

Position to display background tasks status.

tabs

  • Type: string
  • Default: "header"

Position to display tab information.

Theme Configuration

Color schemes, icon coloring, styling, and widget customization.

Overview

The [theme] section controls all color settings in runa, including preset themes, color overrides, and widget styling.

Color Format

Theme color values can be:

  • Terminal color names: "Red", "Blue", "Cyan", "LightGreen", etc.
  • Hex codes: "#RRGGBB" (e.g., "#FF5733")
  • Special value: "default" (uses terminal default)

Color Field Syntax

Color fields support two formats:

1. Flat shorthand (sets the foreground):

accent = "blue"

2. Explicit form (foreground and background):

accent.fg = "blue"
accent.bg = "default"

Both are equivalent: accent = "blue" == accent.fg = "blue"

Rules:

  • If only a single value is provided, it maps to .fg
  • .bg defaults to "default" unless explicitly set
  • .fg will always take precedence over the shorthand

Main Theme Options

name

  • Type: string
  • Default: "default"

The name of the preset themes included in runa. Choose a preset, or leave as “default” or omit.

Available options (case-sensitive strings):

  • "gruvbox-dark"
  • "gruvbox-dark-hard"
  • "gruvbox-light"
  • "catppuccin-mocha"
  • "catppuccin-frappe"
  • "catppuccin-macchiato"
  • "catppuccin-latte"
  • "nightfox"
  • "carbonfox"
  • "tokyonight"
  • "tokyonight-storm"
  • "tokyonight-day"
  • "everforest"
  • "rose-pine" (or "rose_pine")
  • "nord"
  • "two-dark"
  • "one-dark"
  • "solarized-dark"
  • "solarized-light"
  • "dracula"
  • "monokai"

selection_icon

  • Type: string
  • Default: ""

The symbol for the current selection. Use "" or " " to disable or set [display] selection_marker = false.

exe_color

  • Type: string
  • Default: "LightGreen"

Set the colors of binaries/executables.

Color Overrides

You can set each color field directly in [theme] instead of creating each [theme] subsection for overriding and or creating custom themes.

Example:

[theme]
selection.fg = "#EEBBAA"
directory.fg = "#7BA"
widget.border.fg = "#555555"
symlink.directory = "#8aA"

Pane Color Sections

[theme.selection]

Selection bar colors. This is the global selection coloring section and can be overwritten for each pane.

  • fg - Foreground color
  • bg - Background color

[theme.accent]

Borders and titles colors.

  • fg - Foreground color
  • bg - Background color

[theme.entry]

Normal entry colors.

  • fg - Foreground color
  • bg - Background color

[theme.directory]

Directory entry colors.

  • fg - Foreground color
  • bg - Background color

[theme.separator]

Vertical separators color.

  • fg - Foreground color
  • bg - Background color

[theme.parent]

Parent pane text colors.

  • fg - Foreground color
  • bg - Background color
  • selection_mode - Sets the selection coloring mode. If "off", then selection.fg and .bg are ignored. If "on", then selection.bg and .bg are set to "default" or to a specific override.
  • selection.fg - Overrides the central [theme.selection] for just the parent pane
  • selection.bg - Overrides the central [theme.selection] for just the parent pane

[theme.preview]

Preview pane text colors.

  • fg - Foreground color
  • bg - Background color
  • selection_mode - Sets the selection coloring mode. If "off", then selection.fg and .bg are ignored. If "on", then selection.bg and .bg are set to "default" or to a specific override.
  • selection.fg - Overrides the central [theme.selection] for just the preview pane
  • selection.bg - Overrides the central [theme.selection] for just the preview pane

Symlink color configuration.

  • directory - Set the symlink colors for symlinks who are linked to directories
  • file - Set color for symlinks who are linked to files
  • target - Set the target path color of the symlink

Entry and Icon Coloring

[theme.icon_color]

Map icon colors to specific file extensions.

Example:

[theme.icon_color]
"rs" = "#dea584"

[theme.filename]

Map entry colors to specific filenames (exact match).

Example:

[theme.filename]
"README.md" = { fg = "yellow", bg = "default" }

[theme.ext]

Map entry color for specific file extensions.

Example:

[theme.ext]
"rs" = { fg = "default", bg = "default" }

Additional UI Elements

[theme.marker]

Multi-select marker colors and settings.

  • icon - Marker icon symbol (set to " " to disable)
  • fg - Foreground color
  • bg - Background color
  • clipboard.fg - Change the color of the clipboard when you copy an entry via multi-select or via normal yank/copy
  • clipboard.bg - Background color for clipboard indicator

[theme.underline]

Underline colors (if enabled in [display.preview_underline]).

  • fg - Foreground color
  • bg - Background color

[theme.path]

Path bar at the top colors.

  • fg - Foreground color
  • bg - Background color

Widget Configuration

[theme.widget]

Full widget/dialog theming: position, size, and colors. Leave blank or omit to use regular defaults.

position

  • Type: string or array
  • Default: "center"

Widget position. Choose one of:

  • Preset string: "center", "top_left", "bottom_right", etc. Also possible to write "topleft", "bottomright", etc.
  • List: [x, y] - percent of screen, e.g., [38, 32]
  • Table/object: { x = 25, y = 60 } - percent of screen

size

  • Type: string or array or table
  • Default: "small"

Widget size. Choose one of:

  • Preset string: "small", "medium", "large"
  • List: [width, height] - cells (columns x rows), e.g., [60, 12]
  • Table/object: { w = 60, h = 12 } - cells

Note: size arrays/tables are now always cell-based (not percent-based!)

confirm_size

  • Type: string or array or table
  • Default: inherits size

Confirmation dialog size (for confirmations like deleting files). Same format options as size.

move_size

  • Type: array or table
  • Default: [70, 14]

Move file widget size. Same format options as size.

find_visible_results

  • Type: integer
  • Default: 5

Option to specify the maximal drawn results of the find widget. Not to be confused with max_find_results which calculates the overall maximal results fd will generate.

find_width

  • Type: integer
  • Default: 40

Option to configure the find widget width.

Widget Text Colors

  • color.fg - Styles the overall widget text (foreground)
  • color.bg - Styles the overall widget text (background)
  • border.fg - Widget border foreground color
  • border.bg - Widget border background color
  • title.fg - Widget title foreground color
  • title.bg - Widget title background color

Widget Labels and Values

  • label.fg - Change the label color of a widget. Styles the “key” text (e.g. Name:, Size:, Perms:, etc.). Applies to widgets: File Info, Keybind Help.
  • label.bg - Label background color
  • value.fg - Change the value color of a widget. Styles the content of the widget data (e.g. main.rs, 4 KB, etc.). Applies to widgets: File Info, Keybind Help.
  • value.bg - Value background color

Go-to Help Widget

  • goto_help.size - Set the size of the go to help widget when pressing “g”
  • goto_help.position - Set the position of the go to help widget

[theme.status_line]

Configuration for the status line colors.

  • fg - Foreground color
  • bg - Background color

Note: For marker and copy status, the configuration from [theme.marker] sets each status line section.

[theme.tab]

Tab line customization.

  • marker - Marker icon for active tab
  • separator - Separator between tabs
  • active.fg - Active tab foreground color
  • active.bg - Active tab background color
  • inactive.fg - Inactive tab foreground color
  • inactive.bg - Inactive tab background color

line_format

  • Type: string
  • Default: "[{idx}]"

Customization of the tab line. Possible placeholders: {idx}, {name}, {marker}, {separator}

Note: {name} shows the current directory of the tab

Example: line_format = "[{idx}{name}{marker}]"

[theme.info]

Customization for the status line File information colors.

Permissions

  • perms.fg - Permissions text foreground color
  • perms.bg - Permissions text background color

File Size

  • size.fg - Size text foreground color
  • size.bg - Size text background color

Date/Time Fields

  • date.fg - Global color for all date/time fields (acts as default) - foreground
  • date.bg - Global color for all date/time fields (acts as default) - background

Specific overrides (take precedence over date if defined):

  • modified.fg / modified.bg - Modified timestamp colors
  • created.fg / created.bg - Created timestamp colors
  • accessed.fg / accessed.bg - Accessed timestamp colors

File Type

  • file_type.fg - File type foreground color
  • file_type.bg - File type background color

Owner and Group (Unix/Linux only)

  • owner.fg - Owner name foreground color
  • owner.bg - Owner name background color
  • group.fg - Group name foreground color
  • group.bg - Group name background color

Editor Configuration

Editor program selection and file association settings.

Overview

The [editor] section controls which editor opens files and allows per-extension and per-filename overrides.

Main Options

default

  • Type: string
  • Default: "nvim"

Command to open files (e.g., “nvim”, “code”, “vim”, etc.). This is the default editor used when no extension or filename override matches.

File-Specific Overrides

ext

  • Type: table or inline table

Map file extensions to editors/program commands. Use single command or array of command + arguments.

Inline format:

ext = { rs = "nvim", md = "code", txt = ["code", "-d"] }

Section format:

[editor.ext]
rs = ["vim"]
md = ["code"]

filename

  • Type: table or inline table

Map specific filenames to editors/program commands. Use single command or array of command + arguments.

Inline format:

filename = { "Cargo.toml" = "nvim" }

Section format:

[editor.filename]
"Cargo.toml" = ["vim"]

Editor Resolution

runa resolves the editor to use in the following order:

  1. Check if there’s a filename override for the exact filename
  2. Check if there’s an extension override for the file extension
  3. Use the default editor

The resolved editor can be a single command string or an array of command + arguments. If you set a custom filename to a certain program/cmd, the actual file path will be handled in the actual file path directory and never in the starting directory of runa.

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:

ModifierBracketedStandardResult
Control<c-key>ctrl+keyCtrl+Key
Alt/Meta<a-key> or <m-key>alt+key or meta+keyAlt+Key
Shift<s-key>shift+keyShift+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.

Widget Interaction

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