Linux

Installation options:

• Alpine Linux package: pkgs.alpinelinux.org/packages?name=rio
• Arch Linux package: archlinux.org/packages/extra/x86_64/rio (or rio-git from AUR)
• Nix package: NixOS/nixpkgs/rio
• Nix flake: NixOS Flake Installation
• openSUSE package: openSUSE:Factory/rioterm
• Flathub: flathub.org/apps/com.rioterm.Rio
• Void Linux package: https://github.com/void-linux/void-packages/tree/master/srcpkgs/rio
• Terra (Fedora) package: https://github.com/terrapkg/packages/tree/frawhide/anda/devs/rio

Note: Debian packages (.deb) and Red Hat packages (.rpm) are packaged and released along with GitHub releases.

In case your distro doesn't have the package manager option listed above, proceed to build from the source.

NixOS Flake Installation

Note: If you are unsure if you should use the package from nixpkgs or the flakes package, always go for the nixpkgs derivation as the flakes package output is for development purposes only.

For NixOS

To integrate Rio into your NixOS system, add the following to your NixOS configuration:

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    rio.url = "github:raphamorim/rio/main";
  };
  
  outputs = { self, nixpkgs, rio }: {
    nixosConfigurations.your-hostname = nixpkgs.lib.nixosSystem {
      modules = [
        ({ pkgs, ... }: {
          environment.systemPackages = [
            rio.packages.${pkgs.system}.rio
          ];
        })
      ];
    };
  };
}

For Home-Manager

To configure Rio using Home-Manager, add the following to your home-manager configuration:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    rio.url = "github:raphamorim/rio/main";
  };

  outputs = { self, nixpkgs, rio }: {
    homeConfigurations.your-username = nixpkgs.lib.homeManagerConfiguration {
      pkgs = import nixpkgs;
      modules = [
        ({ pkgs, ... }: {
          programs.rio.enable = true;
          package = rio.packages.${pkgs.system}.rio;
        })
      ];
    };
  };
}

Single User Installation

For a less declarative installation:

nix profile install github:raphamorim/rio/main

Manual Pages

After installing Rio, you can optionally install manual pages for offline documentation:

# Install scdoc (required to build man pages)
# Ubuntu/Debian:
sudo apt install scdoc

# Arch Linux:
sudo pacman -S scdoc

# Fedora:
sudo dnf install scdoc

# openSUSE:
sudo zypper install scdoc

# Build and install man pages from source
git clone https://github.com/raphamorim/rio.git
cd rio/extra/man
make
sudo make install

# Access documentation
man rio                # Main Rio manual
man 5 rio             # Configuration file format
man 5 rio-bindings    # Key bindings reference