navigation

• hide-if-single - Hide navigation UI if there is only one tab. It does not work for NativeTab.
• clickable - Enable click on tabs to switch.
• use-current-path - Use same path whenever a new tab is created (Note: requires use-fork to be set to false).
• color-automation - Set a specific color for the tab whenever a specific program is running, or in a specific directory.
• use-split - Enable split panels feature.

[navigation]
mode = "Bookmark"
clickable = false
hide-if-single = true
use-current-path = false
color-automation = []
use-split = true

Mode

Rio has multiple styles of showing navigation/tabs.

Bookmark

Note: The example below is using the Dracula color scheme instead of Rio default colors.

Bookmark is the default navigation mode.

Usage:

[navigation]
mode = "Bookmark"

NativeTab (MacOS only)

Usage:

[navigation]
mode = "NativeTab"

BottomTab

Note: BottomTab does not support click mode yet.

Usage:

[colors]
tabs = "#000000"

[navigation]
mode = "BottomTab"

TopTab

Note: TopTab does not support click mode yet.

Usage:

[colors]
tabs = "#000000"

[navigation]
mode = "TopTab"

Plain

Plain navigation mode will simply turn off any tab key binding.

This mode is perfect if you use Rio terminal with tmux or zellij.

Usage:

[navigation]
mode = "Plain"

Split

Enable split feature. It is enabled by default.

[navigation]
use-split = true

Hide if is only one tab

The property hide-if-single hides navigation UI if there is only one tab. It does not work for NativeTab.

Default is true.

[navigation]
hide-if-single = true

Color automation for navigation

Rio supports specifying the color of tabs using the program and path options.

Note: path is only available for MacOS, BSD and Linux.

[navigation]
color-automation = [
  # Set tab to red (#FF0000) when NeoVim is open.
  { program = "nvim", color = "#FF0000" },
  # Set tab to green  (#00FF00) when in the projects folder
  { path = "/home/YOUR_USERNAME/projects", color = "#00FF00" },
    # Set tab to blue (#0000FF) when in the Rio folder AND vim is open
  { program = "vim", path = "/home/YOUR_USERNAME/projects/rio", color = "#0000FF" },
]

Program

The example below sets #FFFF00 as color background whenever nvim is running.

The configuration would be like:

[navigation]
color-automation = [
  { program = "nvim", color = "#FFFF00" }
]

Path

The example below sets #FFFF00 as color background when in the /home/geg/.config/rio path.

Note: path is only available for MacOS, BSD and Linux.

The configuration would be like:

[navigation]
color-automation = [
  { path = "/home/geg/.config/rio", color = "#FFFF00" }
]

Program and path

It is possible to use both path and program at the same time.

The example below sets #FFFF00 as color background when in the /home path and nvim is open.

Note: path is only available for MacOS, BSD and Linux.

The configuration would be like:

[navigation]
color-automation = [
  { program = "nvim", path = "/home", color = "#FFFF00" }
]