Saltar al contenido principal

Settings UI, Welcome UI, Adaptive theme, and more

· 5 min de lectura

This post also includes changes of v0.0.19.

Highlight #1: New window API (breaking change)

Configuration properties: window_height, window_width and window_opacity has been moved to a new window/background API:

# Window configuration
# • width - define the intial window width.
# Default: 600
# • height - define the inital window height.
# Default: 400
# • mode - define how the window will be created
# - "Windowed" (default) is based on width and height
# - "Maximized" window is created with maximized
# - "Fullscreen" window is created with fullscreen
width = 600
height = 400
mode = "Windowed"

From now and on you can also set image as background.

# Background configuration
# • opacity - changes the background transparency state
# Default: 1.0
# • mode - defines background mode bewteen "Color" and "Image"
# Default: Color
# • image - Set an image as background
# Default: None
mode = "Image"
opacity = 1.0
path = "/Users/rapha/Desktop/eastward.jpg"
width = 200.0
height = 200.0
x = 0.0

Although you can define opacity though the new configuration API it does not work either for the image neither for the window. This something will be fixed in upcoming releases. An example below using the configuration we just saw.

Example background

note: The image above is from the Eastward game

Highlight #2:

Rio terminal is now also available in .

cargo install rioterm

Highlight #3: Alpine Linux, openSUSE and Nix home manager.

• Rio has landed in Nix home manager: nix-community/home-manager/pull/4118 and huge props to @otaviosalvador for making it possible.

• Rio has landed in Alpine Linux: and huge props to @androw for making it possible.

• Rio has landed in openSUSE: and huge props to @androw for making it possible.

Highlight #4: Welcome screen and default creation of configuration file

Now Rio terminal does create the configuration file per first initialization.

Welcome message

Highlight #5: Settings UI

After v0.0.19, Rio will start to provide a custom internal settings UI, where you can manage your configuration without edit the file.

Settings UI

Note: Not all the configuration options has been ported, so you would still need to use the config file for specific configuration updates.

Highlight #6: Error handling

Configuration errors, command errors, font not found and etecetera are not silent anymore. This version introduces an UI for error handling.

Error handling

Highlight #7: Adaptive theme

Rio support theme based on the system theme (light and dark). This configuration only works for Web, MacOS and Windows.

light = "belafonte-day"
dark = "belafonte-night"

Example of usage with MacOS:

Settings UI

Highlight #8: Blinking cursor

Rio now supports blinking cursor.

# Blinking Cursor
# Default is false
blinking-cursor = true

Highlight #9: Navigation mode called "Plain"

Navigation mode "Plain" is perfect if you use tmux/zellij or anything similar.

Plain navigation mode will simply turn off any platform key binding, will not add any key binding (like creation of tabs, windows, panels and other platform key bindings). Note it also get rid of platform key bingins such as shift+control+c for example, to re-add it you would need to map yourself.

This mode is great if you want configure every single bit of how Rio key bindings will work.


mode = "Plain"

Full changelog of v0.0.19

  • Fix for retrieving shell environment variable when running inside of Flatpak sandbox (Ref:
  • Rio terminal is now also available in .
  • Added "navigation.mode = "Plain"", it basically disables all platform key bindings for tabs, windows and panels creation (Ref
  • Support for blinking cursor (Ref: (this option is not enabled by default).
  • Migrated font-kit to a custom font loader.
  • Support to MacOS tile window positioning feature (left or right).
  • Added support to MacOS display native top bar items.
  • Support to adaptive theme (theme selection based on user system theme variant "dark" or "light").
  • Implemented "ScrollPageUp", "ScrollPageDown", "ScrollHalfPageUp", "ScrollHalfPageDown", "ScrollToTop", "ScrollToBottom", "ScrollLineUp", "ScrollLineDown" (Ref:
  • Support to "" (it overwrittes regular, bold, bold-italic and italic font families).
  • Added a welcome screen UI.
  • Added a settings UI.
  • Exposes "RIO_CONFIG" environment variable that contains the path of the configuration.
  • Rio creates a configuration file with all defaults if does not exist.
  • Added "OpenConfigEditor" key binding for all platforms.
  • Configuration property "editor" was removed.
  • Created Assistant, Rio terminal UI for display error (Ref:
  • Fix 'Backspace' keypress triggers Ctrl+h keybinding in Zellij instead of deleting character. (Ref:
  • Implemented "TERM_PROGRAM" and "TERM_PROGRAM_VERSION" (Ref:
  • Whenever native tabs is on disable macos deadzone logic.