Ir para o conteúdo

Terminfo

To make sure Rio works correctly, the Rio terminfo must be used. The rio terminfo will be picked up automatically if it is installed.

Installation Status​

Check if the terminfo is already installed:

infocmp rio

If this command returns without errors, the terminfo is installed and Rio will work correctly.

Installation Methods​

Package-specific Information​

Debian/Ubuntu (.deb packages)​

Important: Rio's .deb packages do not include terminfo files to avoid conflicts with system packages.

  • Debian 13+ / Ubuntu 24.04+: Terminfo is provided by the system's ncurses-term package (6.5+)
  • Ubuntu 22.04 and older: Manual installation required (see below)

RPM packages (Fedora, RHEL, openSUSE)​

Rio's RPM packages include the terminfo files. No additional installation needed.

System Package Manager​

Debian 13+ / Ubuntu 24.04+​

These distributions include Rio's terminfo in the ncurses-term package:

# Ensure ncurses-term is installed
sudo apt update
sudo apt install ncurses-term

Arch Linux​

Arch Linux provides a separate package:

sudo pacman -S rio-terminfo

Manual Installation​

For distributions that don't include Rio's terminfo, or when using older package versions:

Quick Install​

# Download and install terminfo
curl -o rio.terminfo https://raw.githubusercontent.com/raphamorim/rio/main/misc/rio.terminfo
sudo tic -xe xterm-rio,rio rio.terminfo
rm rio.terminfo

From Repository​

If you've cloned the Rio repository:

cd /path/to/rio
sudo tic -xe xterm-rio,rio misc/rio.terminfo

Terminfo Entries​

The Rio terminfo provides two entries:

  • xterm-rio: A compatibility entry for applications that look for "xterm-" prefixed terminals (used by default since v0.2.28)
  • rio: The original terminfo entry (used by default until v0.2.27)

Both entries provide the same terminal capabilities.

Troubleshooting​

Package Installation Issues​

"File already exists" error on Debian/Ubuntu​

If you see:

trying to overwrite '/usr/share/terminfo/r/rio', which is also in package ncurses-term

This means your system already provides Rio's terminfo via ncurses-term. The Rio .deb package correctly doesn't include the terminfo to avoid this conflict.

Ubuntu 22.04 specific​

Ubuntu 22.04 ships with ncurses-term 6.3, which doesn't include Rio's terminfo. After installing Rio's .deb package, manually install the terminfo:

curl -o rio.terminfo https://raw.githubusercontent.com/raphamorim/rio/main/misc/rio.terminfo
sudo tic -xe xterm-rio,rio rio.terminfo
rm rio.terminfo

SSH Connections​

When connecting to remote systems via SSH, the remote system also needs the Rio terminfo. Options:

  1. Install on remote system: Use the manual installation method above
  2. Use fallback TERM: TERM=xterm-256color ssh user@host
  3. Configure Rio: Set a different TERM in your Rio config file
  4. Automatic copy: Some users create scripts to automatically copy terminfo when SSHing: 
    infocmp -a xterm-rio | ssh myserver tic -x -o ~/.terminfo /dev/stdin

Verification​

After installation, verify everything works:

# Check terminfo is installed
infocmp rio