rio1
A cross-platform, gpu-accelerated terminal emulator.
Usage
Rio is a modern terminal emulator built with Rust and WebGPU that provides high performance rendering with support for modern terminal features including sixel graphics, hyperlinks, and custom shaders.
Flags
-h, --help
Prints help information.
-V, --version
Prints version information.
Options
-
-e, --command <COMMAND>... -
Command and args to execute (must be last argument).
-
-w, --working-dir <WORKING_DIR> -
Start the shell in the specified working directory.
-
--write-config [<PATH>] -
Writes the config to a given path or the default location.
Rio doesn't create the config file for you, but it looks for one in the following locations on UNIX systems:
- 1.
-
$RIO_CONFIG_HOME/config.toml
- 2.
-
$XDG_CONFIG_HOME/rio/config.toml
- 3.
-
$HOME/.config/rio/config.toml
On Windows, the config file will be looked for in:
- 1.
-
%USERPROFILE%\AppData\Local\rio\config.toml
-
--enable-log-file -
Writes the logs to a file inside the config directory.
-
--title-placeholder <TITLE> -
Start window with specified title.
Configuration
Rio uses TOML format for configuration. The configuration file is automatically reloaded when changed. See rio(5) for detailed configuration documentation.
Features
Rio supports many modern terminal features:
•
|
GPU-accelerated rendering with WebGPU |
|---|---|
•
|
Sixel graphics protocol |
•
|
iTerm2 image protocol |
•
|
Kitty keyboard protocol |
•
|
Hyperlinks (OSC 8) |
•
|
Vi mode for navigation |
•
|
Split panels |
•
|
Custom shaders (RetroArch compatible) |
•
|
Adaptive themes |
•
|
Font ligatures |
•
|
Wide color gamut support |
Environment
RIO_CONFIG_HOME
Custom path for Rio configuration directory. When set, Rio will look for configuration files in this directory instead of the default locations.
Maintainers
- •
-
Raphael Amorim <[email protected]>
Releases
14 releases since Debian 2.2 (Potato); the text changed 2 times.
--command since Arch Linux 2026-11-01;
--enable-log-file since Arch Linux 2026-11-01;
--title-placeholder since Arch Linux 2026-11-01;
--working-dir since Arch Linux 2026-11-01;
--write-config since Arch Linux 2026-11-01;
-e since Arch Linux 2026-11-01;
-w since Arch Linux 2026-11-01.
-d until Debian 13 (Trixie);
-di until Debian 13 (Trixie);
-dr until Debian 13 (Trixie);
-dt until Debian 13 (Trixie);
-f until Debian 13 (Trixie);
-g until Debian 13 (Trixie);
-in until Debian 13 (Trixie);
-iy until Debian 13 (Trixie);
-o until Debian 13 (Trixie);
-p until Debian 13 (Trixie);
-u until Debian 13 (Trixie);
-v until Debian 13 (Trixie);
-x until Debian 13 (Trixie);
-z until Debian 13 (Trixie);
-za until Debian 13 (Trixie).