Example using Lucario color scheme.

• About Rio
• Configuration file
  • Performance
  • Height
  • Width
  • Style
  • Advanced
  • Colors
• Status
• Acknowledgments

Website: https://raphamorim.io/rio

If you are using or want to help in any way please consider to donate via Github Sponsors.

Rio would not be possible without few acknowledgements and specially Alacritty, since a lot of Rio functionalities (e.g: ANSI parser, events, grid system) was originally built from Alacritty code.

A terminal application that's built with Rust, WebGPU, Tokio runtime. It targets to have the best frame per second experience as long you want, but is also configurable to use as minimal from GPU.

Below some of Rio's features:

• Cross-platform.
• Configurable (Render level, colors, icons, fonts).
• Offloads rendering to the GPU for lower system load.
• Uses threaded rendering for absolutely minimal latency.
• Tabs support.

Rio uses WGPU, which is an implementation of WebGPU for use outside of a browser and as backend for firefox's WebGPU implementation. WebGPU allows for more efficient usage of modern GPU's than WebGL. More info

It also relies on Rust memory behavior, since Rust is a memory-safe language that employs a compiler to track the ownership of values that can be used once and a borrow checker that manages how data is used without relying on traditional garbage collection techniques. More info

The configuration should be the following paths otherwise Rio will use the default configuration.

• macOS path: ~/.rio/config.toml

Default configuration of config.toml:

# Rio default configuration file
performance = "High"
height = 438
width = 662

[style]
font = "Firamono"
font-size = 16
theme = "Basic"

[advanced]
tab-character-active = '●'
tab-character-inactive = '■'
disable-renderer-when-unfocused = false

[developer]
enable-fps-counter = false
enable-logs = false

[colors]
background       = '#151515'
black            = '#FFFFFF'
blue             = '#006EE6'
cursor           = '#8E12CC'
cyan             = '#FFFFFF'
foreground       = '#FFFFFF'
green            = '#FFFFFF'
magenta          = '#FFFFFF'
red              = '#FFFFFF'
tabs             = '#FFFFFF'
tabs-active      = '#F8A145'
white            = '#FFFFFF'
yellow           = '#FFFFFF'
dim-black        = '#FFFFFF'
dim-blue         = '#FFFFFF'
dim-cyan         = '#FFFFFF'
dim-foreground   = '#FFFFFF'
dim-green        = '#FFFFFF'
dim-magenta      = '#FFFFFF'
dim-red          = '#FFFFFF'
dim-white        = '#FFFFFF'
dim-yellow       = '#FFFFFF'
light-black      = '#FFFFFF'
light-blue       = '#FFFFFF'
light-cyan       = '#FFFFFF'
light-foreground = '#FFFFFF'
light-green      = '#FFFFFF'
light-magenta    = '#FFFFFF'
light-red        = '#FFFFFF'
light-white      = '#FFFFFF'
light-yellow     = '#FFFFFF'

Set terminal WGPU rendering perfomance.

• High: Adapter that has the highest performance. This is often a discrete GPU.
• Low: Adapter that uses the least possible power. This is often an integrated GPU.

See more in https://docs.rs/wgpu/latest/wgpu/enum.PowerPreference.html

# <performance> Set WGPU rendering perfomance
# default: High
# options: High, Low
# High: Adapter that has the highest performance. This is often a discrete GPU.
# Low: Adapter that uses the least possible power. This is often an integrated GPU.
performance = "High"

Set terminal window height.

# <height> Set default height
# default: 438
height = 400

Set terminal window width.

# <width> Set default width
# default: 662
width = 800

Define the column width of your console window. This mode is system dependant, and returns an error if you specify a column width that is not supported by your operating system.

# <width> Set default width
# default: 80 (macOs)
columns = 80

Define the row height of your console window. This mode is system dependant, and returns an error if you specify a row height that is not supported by your operating system.

# <width> Set default width
# default: 25 (macOs)
rows = 25

This property will change later to an actual font path. Currently Rio has 2 fonts builtin: Firamono, Novamono.

[style]
font = "Firamono"

Sets font size.

[style]
font-size = 16.0

This property sets a char for an active tab.

[style]
tab-character-active = '●'

This property sets a char for an inactive tab.

[style]
tab-character-inactive = '■'

This property disable renderer processes until focus on Rio term again.

[style]
disable-renderer-when-unfocused = false

This property enables frame per second counter.

[style]
enable-fps-counter = false

This property enables Rio logging.

[style]
enable-logs = false

Default color palette demo:

Usage example running the following bash script:

for x in {0..8}; do
    for i in {30..37}; do
        for a in {40..47}; do
            echo -ne "\e[$x;$i;$a""m\\\e[$x;$i;$a""m\e[0;37;40m "
        done
        echo
    done
done
echo ""

Or one-liner:

for x in {0..8}; do for i in {30..37}; do for a in {40..47}; do echo -ne "\e[$x;$i;$a""m\\\e[$x;$i;$a""m\e[0;37;40m "; done; echo; done; done; echo ""

Basic features are under development for MacOs right now.

• Text glyph render is from https://github.com/hecrj/wgpu_glyph
• https://github.com/wez/wezterm
• https://www.gaijin.at/en/infos/ascii-ansi-character-table#asciicontrol