RIO(1)                      General Commands Manual                     RIO(1)

NAME
       Rio - A cross-platform, GPU-accelerated terminal emulator.

SYNOPSIS
       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:

       o   GPU-accelerated rendering with WebGPU
       o   Sixel graphics protocol
       o   iTerm2 image protocol
       o   Kitty keyboard protocol
       o   Hyperlinks (OSC 8)
       o   Vi mode for navigation
       o   Split panels
       o   Custom shaders (RetroArch compatible)
       o   Adaptive themes
       o   Font ligatures
       o   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.

SEE ALSO
       rio(5)

BUGS
       Found a bug? Please report it at
       https://github.com/raphamorim/rio/issues.

MAINTAINERS
       o   Raphael Amorim <rapha850@gmail.com>

                                  2026-05-13                            RIO(1)