.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RIO" "5" "2026-05-13"
.PP
.SH NAME
.PP
Rio - TOML configuration file format.\&
.PP
.SH SYNTAX
.PP
Rio'\&s configuration file uses the TOML format.\& The format'\&s specification
can be found at \fIhttps://toml.\&io/en/v1.\&0.\&0\fR.\&
.PP
.SH LOCATION
.PP
Rio doesn'\&t create the config file for you, but it looks for one in the
following locations on UNIX systems:
.PP
.PD 0
.IP 1. 4
\fI$RIO_CONFIG_HOME/config.\&toml\fR
.IP 2. 4
\fI$XDG_CONFIG_HOME/rio/config.\&toml\fR
.IP 3. 4
\fI$HOME/.\&config/rio/config.\&toml\fR
.PD
.PP
On Windows, the config file will be looked for in:
.PP
.PD 0
.IP 1. 4
\fI%USERPROFILE%\eAppData\eLocal\erio\econfig.\&toml\fR
.PD
.PP
.SH GENERAL
.PP
\fBtheme\fR = \fI"<string>"\fR
.PP
.RS 4
Theme name to use.\& When set, colors defined in the configuration file will be ignored.\&
.PP
Default: \fINone\fR
.PP
.RE
\fBconfirm-before-quit\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Require confirmation before quitting.\&
.PP
Default: \fItrue\fR
.PP
.RE
\fBdraw-bold-text-with-light-colors\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
When \fItrue\fR, bold text is drawn using the bright color variants.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBenv-vars\fR = [\fI"<string>"\fR,]
.PP
.RS 4
Environment variables to set for spawned processes.\&
.PP
Example:
.RS 4
env-vars = [\fI"TERM=xterm-256color"\fR, \fI"COLORTERM=truecolor"\fR]
.PP
.RE
.RE
.SH WINDOW
.PP
This section documents the \fB[window]\fR table of the configuration file.\&
.PP
\fBwidth\fR = \fI<integer>\fR
.PP
.RS 4
Window width in pixels.\&
.PP
Default: \fI600\fR
.PP
.RE
\fBheight\fR = \fI<integer>\fR
.PP
.RS 4
Window height in pixels.\&
.PP
Default: \fI400\fR
.PP
.RE
\fBmode\fR = \fI"Windowed"\fR | \fI"Maximized"\fR | \fI"Fullscreen"\fR
.PP
.RS 4
Window startup mode.\&
.PP
Default: \fI"Windowed"\fR
.PP
.RE
\fBopacity\fR = \fI<float>\fR
.PP
.RS 4
Background opacity as a floating point number from \fI0.\&0\fR to \fI1.\&0\fR.\&
.PP
Default: \fI1.\&0\fR
.PP
.RE
\fBblur\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Request compositor to blur content behind transparent windows.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBdecorations\fR = \fI"Enabled"\fR | \fI"Disabled"\fR | \fI"Transparent"\fR | \fI"Buttonless"\fR
.PP
.RS 4
Window decorations.\&
.PP
\fBEnabled\fR
.RS 4
Normal window decorations.\&
.RE
\fBDisabled\fR
.RS 4
No window decorations.\&
.RE
\fBTransparent\fR \fI(macOS only)\fR
.RS 4
Transparent title bar.\&
.RE
\fBButtonless\fR \fI(macOS only)\fR
.RS 4
Title bar without buttons.\&
.PP
.RE
Default: \fI"Enabled"\fR
.PP
.RE
\fBbackground-image\fR = { path = \fI"<string>"\fR, opacity = \fI<float>\fR }
.PP
.RS 4
Window background image.\& The image is uploaded once into a dedicated GPU
texture and stretched to cover the full window.\&
.PP
\fBpath\fR
.RS 4
Path to the background image file.\&
.RE
\fBopacity\fR
.RS 4
Image opacity from \fI0.\&0\fR to \fI1.\&0\fR.\& Default \fI1.\&0\fR.\&
.PP
.RE
.RE
.SH FONTS
.PP
This section documents the \fB[fonts]\fR table of the configuration file.\&
.PP
\fBsize\fR = \fI<float>\fR
.PP
.RS 4
Font size in points.\&
.PP
Default: \fI18.\&0\fR
.PP
.RE
\fBfamily\fR = \fI"<string>"\fR
.PP
.RS 4
Font family name.\& When set, overrides all font variant families.\&
.PP
Default: \fI"cascadiacode"\fR
.PP
.RE
\fBfeatures\fR = [\fI"<string>"\fR,]
.PP
.RS 4
OpenType font features to enable.\&
.PP
Example:
.RS 4
features = [\fI"ss02"\fR, \fI"ss03"\fR, \fI"liga"\fR]
.PP
.RE
.RE
\fBuse-drawable-chars\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Use built-in drawable characters for box drawing.\&
.PP
Default: \fItrue\fR
.PP
.RE
\fBdisable-warnings-not-found\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Disable warnings when fonts are not found.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBadditional-dirs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
Additional directories to search for fonts.\&
.PP
.RE
\fBregular\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
Regular font configuration.\&
.PP
Default: { family = \fI"cascadiacode"\fR, style = \fI"Normal"\fR, width = \fI"Normal"\fR, weight = \fI400\fR }
.PP
.RE
\fBbold\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
Bold font configuration.\&
.PP
Default: { family = \fI"cascadiacode"\fR, style = \fI"Normal"\fR, width = \fI"Normal"\fR, weight = \fI800\fR }
.PP
.RE
\fBitalic\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
Italic font configuration.\&
.PP
Default: { family = \fI"cascadiacode"\fR, style = \fI"Italic"\fR, width = \fI"Normal"\fR, weight = \fI400\fR }
.PP
.RE
\fBbold-italic\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
Bold italic font configuration.\&
.PP
Default: { family = \fI"cascadiacode"\fR, style = \fI"Italic"\fR, width = \fI"Normal"\fR, weight = \fI800\fR }
.PP
.RE
\fBextras\fR = [{ family = \fI"<string>"\fR },]
.PP
.RS 4
Additional fonts to load.\&
.PP
.RE
\fBemoji\fR = { family = \fI"<string>"\fR }
.PP
.RS 4
Emoji font configuration.\&
.PP
Default: Built-in Twemoji font
.PP
.RE
\fBhinting\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Enable font hinting.\&
.PP
Default: \fItrue\fR
.PP
.RE
\fBsymbol-map\fR = [{ chars = \fI"<string>"\fR, family = \fI"<string>"\fR },]
.PP
.RS 4
Map specific character ranges to fonts.\&
.PP
.RE
.SH COLORS
.PP
This section documents the \fB[colors]\fR table of the configuration file.\&
.PP
Colors are specified using their hexadecimal values with a \fI#\fR prefix: \fI#RRGGBB\fR or \fI#RRGGBBAA\fR.\&
.PP
\fBbackground\fR = \fI"<string>"\fR
.PP
.RS 4
Default background color.\&
.PP
.RE
\fBforeground\fR = \fI"<string>"\fR
.PP
.RS 4
Default foreground color.\&
.PP
.RE
\fBcursor\fR = \fI"<string>"\fR
.PP
.RS 4
Cursor color.\&
.PP
.RE
\fBvi-cursor\fR = \fI"<string>"\fR
.PP
.RS 4
Vi mode cursor color.\&
.PP
.RE
\fBblack\fR, \fBred\fR, \fBgreen\fR, \fByellow\fR, \fBblue\fR, \fBmagenta\fR, \fBcyan\fR, \fBwhite\fR = \fI"<string>"\fR
.PP
.RS 4
Standard ANSI colors.\&
.PP
.RE
\fBlight-black\fR, \fBlight-red\fR, \fBlight-green\fR, \fBlight-yellow\fR, \fBlight-blue\fR, \fBlight-magenta\fR, \fBlight-cyan\fR, \fBlight-white\fR = \fI"<string>"\fR
.PP
.RS 4
Bright ANSI colors.\&
.PP
.RE
\fBdim-black\fR, \fBdim-red\fR, \fBdim-green\fR, \fBdim-yellow\fR, \fBdim-blue\fR, \fBdim-magenta\fR, \fBdim-cyan\fR, \fBdim-white\fR = \fI"<string>"\fR
.PP
.RS 4
Dim ANSI colors.\&
.PP
.RE
\fBtabs\fR = \fI"<string>"\fR
.PP
.RS 4
Tab bar background color.\&
.PP
.RE
\fBtabs-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
Tab bar text color.\&
.PP
.RE
\fBtabs-active\fR = \fI"<string>"\fR
.PP
.RS 4
Active tab background color.\&
.PP
.RE
\fBtabs-active-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
Active tab text color.\&
.PP
.RE
\fBtabs-active-highlight\fR = \fI"<string>"\fR
.PP
.RS 4
Active tab highlight color.\&
.PP
.RE
\fBbar\fR = \fI"<string>"\fR
.PP
.RS 4
Navigation bar background color.\&
.PP
.RE
\fBsplit\fR = \fI"<string>"\fR
.PP
.RS 4
Split separator color.\&
.PP
.RE
\fBsearch-match-background\fR = \fI"<string>"\fR
.PP
.RS 4
Search match background color.\&
.PP
.RE
\fBsearch-match-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
Search match text color.\&
.PP
.RE
\fBsearch-focused-match-background\fR = \fI"<string>"\fR
.PP
.RS 4
Focused search match background color.\&
.PP
.RE
\fBsearch-focused-match-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
Focused search match text color.\&
.PP
.RE
\fBselection-background\fR = \fI"<string>"\fR
.PP
.RS 4
Selection background color.\&
.PP
.RE
\fBselection-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
Selection text color.\&
.PP
.RE
.SH CURSOR
.PP
This section documents the \fB[cursor]\fR table of the configuration file.\&
.PP
\fBshape\fR = \fI"block"\fR | \fI"underline"\fR | \fI"beam"\fR
.PP
.RS 4
Cursor shape.\&
.PP
Default: \fI"block"\fR
.PP
.RE
\fBblinking\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Enable cursor blinking.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBblinking-interval\fR = \fI<integer>\fR
.PP
.RS 4
Cursor blinking interval in milliseconds.\& Range: 350-1200.\&
.PP
Default: \fI800\fR
.PP
.RE
.SH SCROLL
.PP
This section documents the \fB[scroll]\fR table of the configuration file.\&
.PP
\fBmultiplier\fR = \fI<float>\fR
.PP
.RS 4
Scroll speed multiplier.\&
.PP
Default: \fI3.\&0\fR
.PP
.RE
\fBdivider\fR = \fI<float>\fR
.PP
.RS 4
Scroll divider for fine-tuning.\&
.PP
Default: \fI1.\&0\fR
.PP
.RE
.SH NAVIGATION
.PP
This section documents the \fB[navigation]\fR table of the configuration file.\&
.PP
\fBmode\fR = \fI"NativeTab"\fR | \fI"Tab"\fR | \fI"Plain"\fR
.PP
Navigation display mode.\&
.PP
Default: \fI"Tab"\fR
.PP
\fBclickable\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Enable clickable navigation elements.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBuse-current-path\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Show current working directory in navigation.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBcolor-automation\fR = [{ program = \fI"<string>"\fR, path = \fI"<string>"\fR, color = \fI"<string>"\fR },]
.PP
.RS 4
Automatic color assignment based on program or path.\&
.PP
.RE
.SH SHELL
.PP
This section documents the \fB[shell]\fR table of the configuration file.\&
.PP
\fBprogram\fR = \fI"<string>"\fR
.PP
.RS 4
Shell program to execute.\&
.PP
Default: System default shell
.PP
.RE
\fBargs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
Arguments to pass to the shell.\&
.PP
.RE
.SH EDITOR
.PP
This section documents the \fB[editor]\fR table of the configuration file.\&
.PP
\fBprogram\fR = \fI"<string>"\fR
.PP
.RS 4
Editor program for opening configuration files.\&
.PP
Default: \fI"vi"\fR
.PP
.RE
\fBargs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
Arguments to pass to the editor.\&
.PP
.RE
.SH BINDINGS
.PP
This section documents the \fB[bindings]\fR table of the configuration file.\&
.PP
\fBkeys\fR = [{ key = \fI"<string>"\fR, with = \fI"<string>"\fR, action = \fI"<string>"\fR },]
.PP
.RS 4
Key bindings configuration.\&
.PP
\fBkey\fR
.RS 4
Key name (e.\&g.\&, \fI"q"\fR, \fI"Enter"\fR, \fI"F1"\fR).\&
.PP
.RE
\fBwith\fR
.RS 4
Modifier keys: \fI"super"\fR, \fI"alt"\fR, \fI"ctrl"\fR, \fI"shift"\fR.\&
Multiple modifiers can be combined with \fI|\fR.\&
.PP
.RE
\fBaction\fR
.RS 4
Action to perform.\& Available actions include:
\fI"Quit"\fR, \fI"CreateWindow"\fR, \fI"CloseWindow"\fR, \fI"Copy"\fR, \fI"Paste"\fR,
\fI"ScrollUp"\fR, \fI"ScrollDown"\fR, \fI"ToggleViMode"\fR, \fI"OpenConfigEditor"\fR,
and many others.\&
.PP
.RE
.RE
.SH RENDERER
.PP
This section documents the \fB[renderer]\fR table of the configuration file.\&
.PP
\fBperformance\fR = \fI"High"\fR | \fI"Low"\fR
.PP
.RS 4
Rendering performance mode.\&
.PP
Default: \fI"High"\fR
.PP
.RE
\fBbackend\fR = \fI"Automatic"\fR | \fI"GL"\fR | \fI"Vulkan"\fR | \fI"DX12"\fR | \fI"Metal"\fR
.PP
.RS 4
Graphics backend to use.\&
.PP
Default: \fI"Automatic"\fR
.PP
.RE
\fBdisable-renderer-when-unfocused\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Disable rendering when window is unfocused to save power.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBlevel\fR = \fI<integer>\fR
.PP
.RS 4
Rendering level (0-3).\&
.PP
Default: \fI3\fR
.PP
.RE
.SH DEVELOPER
.PP
This section documents the \fB[developer]\fR table of the configuration file.\&
.PP
\fBlog-level\fR = \fI"OFF"\fR | \fI"ERROR"\fR | \fI"WARN"\fR | \fI"INFO"\fR | \fI"DEBUG"\fR | \fI"TRACE"\fR
.PP
.RS 4
Log level for debugging.\&
.PP
Default: \fI"OFF"\fR
.PP
.RE
\fBenable-log-file\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Write logs to file.\&
.PP
Default: \fIfalse\fR
.PP
.RE
\fBenable-fps-counter\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
Display FPS counter.\&
.PP
Default: \fIfalse\fR
.PP
.RE
.SH SEE ALSO
.PP
\fBrio\fR(1)
.PP
.SH BUGS
.PP
Found a bug?\& Please report it at \fIhttps://github.\&com/raphamorim/rio/issues\fR.\&
.PP
.SH MAINTAINERS
.PP
.PD 0
.IP \(bu 4
Raphael Amorim <rapha850@gmail.\&com>