Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Requirements

Operating Systems

Sauva supports macOS and Linux. Windows is not currently supported.

Terminal

The TUI requires an interactive terminal, including when the input is read from a pipe or file. Sauva reads the supplied input first, then accepts keyboard input from the terminal.

The minimum terminal size for the TUI is 60 columns by 16 rows. A larger terminal, such as 100 columns by 30 rows, provides room for additional preview panels.

Use --output to print a JSON or Rust string literal without an interactive terminal.

Glyph Images

Glyph images require a compatible terminal and fonts installed on your system. Sauva does not bundle fonts.

kitty and Ghostty are supported for automatic graphics detection. See Compatibility for the available protocols and modes.

Unicode properties, browsing, searching, and text analysis remain available when glyph images are disabled or unavailable.

Building from Source

Installing with Cargo requires Rust 1.88.0 or later. A release binary does not require Rust to be installed.