RIO-BINDINGS(5)

📦
version 0.5.29 · 3 versions
, in arch rolling

💅 RIO-BINDINGS (5) — like, the file formats manual, bestie

okay so this is the manual page for rio-bindings, straight out of the File Formats Manual section, and it's literally your cheat sheet for the default key bindings in the Rio terminal emulator. no cap, it's giving "how do I make this terminal do the thing" energy 🎀

✨ NAME ✨

Rio-bindings — the default key bindings for the Rio terminal emulator. that's it, that's the whole vibe check 🦋

🌸 DESCRIPTION 🌸

so this page documents the default key bindings for the Rio terminal emulator. you can customize all of them in the configuration file, under the [bindings] section. iconic behavior only 💅

⭐ SYNTAX ⭐

key bindings use this exact syntax in the config file, copy it character for character bestie:

[[bindings.keys]]
key = "<key>"
with = "<modifiers>"
action = "<action>"

where, and listen closely:

  • key is the key name (e.g. "q", "Enter", "F1") 🍓
  • with specifies modifier keys: "super", "alt", "ctrl", "shift"
  • action is the action to perform

you can stack multiple modifiers with "|", like for example: "ctrl|shift". slay, combine them 🧚

👑 DEFAULT BINDINGS 👑

🔥 Application Control

  • Super+Q (macOS) / Ctrl+Shift+Q (Linux/Windows) — quit Rio. bye bestie 😭
  • Super+N (macOS) / Ctrl+Shift+N (Linux/Windows) — create a new window ✨
  • Super+W (macOS) / Ctrl+Shift+W (Linux/Windows) — close the current window
  • Super+T (macOS) / Ctrl+Shift+T (Linux/Windows) — create a new tab 🎀
  • Super+Comma (macOS) / Ctrl+Comma (Linux/Windows) — open the configuration editor

💖 Text Operations

  • Super+C (macOS) / Ctrl+Shift+C (Linux/Windows) — copy the selected text to the clipboard
  • Super+V (macOS) / Ctrl+Shift+V (Linux/Windows) — paste from the clipboard
  • Super+A (macOS) / Ctrl+Shift+A (Linux/Windows) — select all the text

🦋 Font Size

  • Super+Plus (macOS) / Ctrl+Plus (Linux/Windows) — increase font size (bigger!!)
  • Super+Minus (macOS) / Ctrl+Minus (Linux/Windows) — decrease font size
  • Super+0 (macOS) / Ctrl+0 (Linux/Windows) — reset font size to default, back to factory settings vibes

🌈 Scrolling

  • Page Up — scroll up one page
  • Page Down — scroll down one page
  • Shift+Page Up — scroll up half page
  • Shift+Page Down — scroll down half page
  • Home — scroll to top of buffer
  • End — scroll to bottom of buffer
  • Super+1-9 (macOS) / Ctrl+1-9 (Linux/Windows) — switch to tab 1-9 🎯
  • Super+Left (macOS) / Ctrl+Shift+Left (Linux/Windows) — switch to previous tab
  • Super+Right (macOS) / Ctrl+Shift+Right (Linux/Windows) — switch to next tab

🧚 Vi Mode

  • Ctrl+Shift+Space — toggle Vi mode for keyboard navigation, main character energy
  • h, j, k, l — move cursor left, down, up, right
  • w — move to start of next word
  • b — move to start of previous word
  • e — move to end of current word
  • 0 — move to beginning of line
  • $ — move to end of line
  • g, g — move to top of buffer
  • G — move to bottom of buffer
  • / — start forward search
  • ? — start backward search
  • n — jump to next search match
  • N — jump to previous search match
  • v — start visual selection
  • V — start line selection
  • Ctrl+V — start block selection
  • y — copy selection
  • Escape — exit Vi mode, escape the simulation 😌
  • Super+F (macOS) / Ctrl+Shift+F (Linux/Windows) — start search
  • Enter — confirm search
  • Escape — cancel search
  • Ctrl+G / F3 — find next match
  • Ctrl+Shift+G / Shift+F3 — find previous match

🫶 Split Panels

  • Super+D (macOS) / Ctrl+Shift+D (Linux/Windows) — split panel horizontally
  • Super+Shift+D (macOS) / Ctrl+Shift+Alt+D (Linux/Windows) — split panel vertically
  • Super+Shift+W (macOS) / Ctrl+Shift+Alt+W (Linux/Windows) — close the current split panel
  • Super+H/J/K/L (macOS) / Ctrl+Shift+H/J/K/L (Linux/Windows) — navigate between split panels

💀 Developer

  • F12 — toggle developer tools (when available)
  • Ctrl+Shift+I — open inspector (when available)
ngl, those two are both "when available", so don't come for me if they're not there 🙈

🎀 CUSTOMIZATION 🎀

you can customize key bindings by adding entries to the [bindings] section in the configuration file. like this, literally:

[[bindings.keys]]
key = "q"
with = "super"
action = "Quit"

[[bindings.keys]]
key = "Enter"
with = "ctrl|shift"
action = "CreateWindow"

🌸 AVAILABLE ACTIONS 🌸

here's the full menu of actions you can wire up, no skips, all of them:

  • Quit — quit the application
  • CreateWindow — create a new window
  • CloseWindow — close the current window
  • CreateTab — create a new tab
  • CloseTab — close the current tab
  • SelectTab1 through SelectTab9 — switch to a specific tab
  • SelectPreviousTab — switch to previous tab
  • SelectNextTab — switch to next tab
  • Copy — copy selected text
  • Paste — paste from clipboard
  • SelectAll — select all text
  • IncreaseFontSize — increase font size
  • DecreaseFontSize — decrease font size
  • ResetFontSize — reset font size to default
  • ScrollUp — scroll up
  • ScrollDown — scroll down
  • ScrollPageUp — scroll up one page
  • ScrollPageDown — scroll down one page
  • ScrollHalfPageUp — scroll up half page
  • ScrollHalfPageDown — scroll down half page
  • ScrollToTop — scroll to top of buffer
  • ScrollToBottom — scroll to bottom of buffer
  • ToggleViMode — toggle Vi mode
  • Search — start search
  • OpenConfigEditor — open configuration file in editor
  • SplitHorizontally — split panel horizontally
  • SplitVertically — split panel vertically
  • ClosePanel — close current split panel
  • FocusNextPanel — focus next split panel
  • FocusPreviousPanel — focus previous split panel

🔗 SEE ALSO 🔗

rio(1), rio(5) — go read those too, iykyk 💜

🐛 BUGS 🐛

found a bug? don't suffer in silence bestie, please report it at https://github.com/raphamorim/rio/issues. the maintainers will love you for it 🫶

👑 MAINTAINERS 👑

  • Raphael Amorim <rapha850@gmail.com>
ok that's the whole page!! shoutout to the source/version line, which reads RIO-BINDINGS(5) and is dated 2026-11-01 — so this page is from the future, and honestly? that's on brand ⭐💅✨
📦 where this page comes from