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", "thick"

Border shape for the panes.

`titles`

Type: boolean
Default: true

Show titles at the top. With borders = "split", each pane shows its title (“Parent”, “Files”, “Preview”). With borders = "unified", the outer border shows the current path.

`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: follows [theme] name (e.g. "gruvbox-dark" uses bat’s gruvbox-dark), otherwise "TwoDark"

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.

`archive`

Type: table
Default: none, archives preview as files

Shows the contents of archives as a tree. Map extensions to a command that prints the paths of an archive, one per line. Keys can span several extensions, like "tar.gz". The longest matching extension wins. File variables work as in editor commands.

On Windows, the built-in tar reads tar, zip and 7z archives:

[display.preview_options.archive]
zip = ["tar", "-tf", "{path}"]
"7z" = ["tar", "-tf", "{path}"]
"tar.gz" = ["tar", "-tf", "{path}"]

On Linux, GNU tar reads tar archives, unzip -Z1 lists zip archives and bsdtar reads all of them:

[display.preview_options.archive]
zip = ["unzip", "-Z1", "{path}"]
"tar.gz" = ["tar", "-tf", "{path}"]
"tar.xz" = ["tar", "-tf", "{path}"]

runa reads only the lines the preview shows and stops the command after that, or after 2 seconds. If the command fails, the file previews as usual. Empty folders inside an archive are not shown.

To color the tree lines or mark archive contents, see [theme.archive].