RIO(5)                        File Formats Manual                       RIO(5)

<?><?><?> (NAME)
       Rio - <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> TOML.

<?><?><?> (SYNTAX)
       <?><?><?><?> <?><?><?><?><?><?><?><?> Rio <?><?> <?><?><?><?> TOML
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       https://toml.io/en/v1.0.0 <?><?><?><?><?><?>.

<?><?><?><?> (LOCATION)
       Rio <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>:

       1.  $RIO_CONFIG_HOME/config.toml
       2.  $XDG_CONFIG_HOME/rio/config.toml
       3.  $HOME/.config/rio/config.toml

       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>:

       1.  %USERPROFILE%\AppData\Local\rio\config.toml

<?><?><?><?><?> (GENERAL)
       theme = "<string>"

           <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?>.

           <?><?><?><?><?><?><?>: None

       confirm-before-quit = true | false

           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?>.

           <?><?><?><?><?><?><?>: true

       draw-bold-text-with-light-colors = true | false

           <?><?><?><?><?><?> <?><?> <?><?><?> true <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?> (bold) <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       env-vars = ["<string>",]

           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

           <?><?><?><?>:
               env-vars = ["TERM=xterm-256color", "COLORTERM=truecolor"]

<?><?><?><?><?> (WINDOW)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [window] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       width = <integer>

           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 600

       height = <integer>

           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 400

       mode = "Windowed" | "Maximized" | "Fullscreen"

           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "Windowed"

       opacity = <float>

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> 0.0 <?><?> 1.0.

           <?><?><?><?><?><?><?>: 1.0

       blur = true | false

           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?> <?><?><?> (<?><?><?>) <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       decorations = "Enabled" | "Disabled" | "Transparent" | "Buttonless"

           <?><?><?><?><?><?><?> <?><?><?><?><?>.

           Enabled
               <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
           Disabled
               <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.
           Transparent (<?><?><?><?> <?><?> macOS)
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
           Buttonless (<?><?><?><?> <?><?> macOS)
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: "Enabled"

       background-image = { path = "<string>", opacity = <float> }

           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
           (texture) <?><?><?><?><?><?><?> GPU <?><?><?><?><?><?><?><?>
           <?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           path
               <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?><?>.
           opacity
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?> 0.0 <?><?> 1.0.
               <?><?><?><?><?><?><?>: 1.0.

<?><?><?><?><?><?><?> (FONTS)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [fonts] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       size = <float>

           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 18.0

       family = "<string>"

           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "cascadiacode"

       features = ["<string>",]

           <?><?><?><?><?><?><?><?><?> <?><?><?><?> OpenType <?><?><?>
           <?><?><?><?><?><?><?><?><?>.

           <?><?><?><?>:
               features = ["ss02", "ss03", "liga"]

       use-drawable-chars = true | false

           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> (box drawing).

           <?><?><?><?><?><?><?>: true

       disable-warnings-not-found = true | false

           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       additional-dirs = ["<string>",]

           <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       regular = { family = "<string>", style = "<string>", width =
       "<string>", weight = <integer> }

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> (Regular).

           <?><?><?><?><?><?><?>: { family = "cascadiacode", style = "Normal",
           width = "Normal", weight = 400 }

       bold = { family = "<string>", style = "<string>", width = "<string>",
       weight = <integer> }

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> (Bold).

           <?><?><?><?><?><?><?>: { family = "cascadiacode", style = "Normal",
           width = "Normal", weight = 800 }

       italic = { family = "<string>", style = "<string>", width = "<string>",
       weight = <integer> }

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           (Italic).

           <?><?><?><?><?><?><?>: { family = "cascadiacode", style = "Italic",
           width = "Normal", weight = 400 }

       bold-italic = { family = "<string>", style = "<string>", width =
       "<string>", weight = <integer> }

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> (Bold Italic).

           <?><?><?><?><?><?><?>: { family = "cascadiacode", style = "Italic",
           width = "Normal", weight = 800 }

       extras = [{ family = "<string>" },]

           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?>.

       emoji = { family = "<string>" }

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: <?><?><?><?> <?><?><?><?><?> Twemoji

       hinting = true | false

           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (hinting)
           <?><?><?><?>.

           <?><?><?><?><?><?><?>: true

       symbol-map = [{ chars = "<string>", family = "<string>" },]

           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?> (COLORS)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [colors] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> # <?><?><?><?> <?><?><?><?><?><?><?>: #RRGGBB
       <?><?> #RRGGBBAA.

       background = "<string>"

           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       foreground = "<string>"

           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           (<?><?><?>).

       cursor = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?>.

       vi-cursor = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> Vi.

       black, red, green, yellow, blue, magenta, cyan, white = "<string>"

           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> ANSI.

       light-black, light-red, light-green, light-yellow, light-blue,
       light-magenta, light-cyan, light-white = "<string>"

           <?><?><?><?><?><?><?> <?><?><?><?> ANSI.

       dim-black, dim-red, dim-green, dim-yellow, dim-blue, dim-magenta,
       dim-cyan, dim-white = "<string>"

           <?><?><?><?><?><?><?> <?><?><?><?><?><?> ANSI.

       tabs = "<string>"

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       tabs-active = "<string>"

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       split = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       search-match-background = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>.

       search-match-foreground = "<string>"

           <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?>.

       search-focused-match-background = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?>.

       search-focused-match-foreground = "<string>"

           <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>.

       selection-background = "<string>"

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?>.

       selection-foreground = "<string>"

           <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CURSOR)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [cursor] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       shape = "block" | "underline" | "beam"

           <?><?><?> <?><?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "block"

       blinking = true | false

           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       blinking-interval = <integer>

           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>: 350-1200.

           <?><?><?><?><?><?><?>: 800

<?><?><?><?><?><?> (SCROLL)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [scroll] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       multiplier = <float>

           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 3.0

       divider = <float>

           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: 1.0

<?><?><?><?><?><?> (NAVIGATION)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [navigation] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       mode = "NativeTab" | "Tab" | "Plain"

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>: "Tab"

       clickable = true | false

           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       use-current-path = true | false

           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       color-automation = [{ program = "<string>", path = "<string>", color =
       "<string>" },]

           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?>.

<?><?><?><?><?> (SHELL)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [shell] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       program = "<string>"

           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?>

       args = ["<string>",]

           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (EDITOR)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [editor] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       program = "<string>"

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "vi"

       args = ["<string>",]

           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> <?><?><?><?><?><?> (BINDINGS)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [bindings] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       keys = [{ key = "<string>", with = "<string>", action = "<string>" },]

           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

           key
               <?><?><?> <?><?><?><?> (<?><?><?><?><?> "q"<?> "Enter"<?>
               "F1").

           with
               <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
               (modifier): "super"<?> "alt"<?> "ctrl"<?> "shift".
               <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
               <?><?> <?><?><?><?><?><?><?> <?><?> | <?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?>.

           action
               <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?>: "Quit"<?> "CreateWindow"<?>
               "CloseWindow"<?> "Copy"<?> "Paste"<?> "ScrollUp"<?>
               "ScrollDown"<?> "ToggleViMode"<?> "OpenConfigEditor"<?> <?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> (RENDERER)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [renderer] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       performance = "High" | "Low"

           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "High"

       backend = "Automatic" | "GL" | "Vulkan" | "DX12" | "Metal"

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "Automatic"

       disable-renderer-when-unfocused = true | false

           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       level = <integer>

           <?><?><?> <?><?><?><?><?><?><?> (0-3).

           <?><?><?><?><?><?><?>: 3

<?><?><?><?><?><?><?><?><?><?><?> (DEVELOPER)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       [developer] <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       log-level = "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "TRACE"

           <?><?><?> <?><?><?> <?><?><?><?><?> (log) <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: "OFF"

       enable-log-file = true | false

           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: false

       enable-fps-counter = true | false

           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> (FPS).

           <?><?><?><?><?><?><?>: false

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       rio(1)

<?><?><?><?><?> <?><?><?><?><?><?> (BUGS)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> https://github.com/raphamorim/rio/issues <?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?><?> (MAINTAINERS)
       o   Raphael Amorim <rapha850@gmail.com>

                                  2026-08-31                            RIO(5)