See: A TUI file viewer.

File browser with syntax-highlighted preview

Git highlighting with visual diff - modified files marked with ● and colored text

Fuzzy search across entire directory tree

Text selection in preview pane

Split panes with tab bar for multiple files

Build

cargo build --release

Run

cargo run [FILE_PATH]

Controls

Press ? in the app to see all keyboard shortcuts, or see config.example.toml for the full list of configurable key bindings.

Configuration

Configuration file location: ~/.config/viewer/config.toml

See config.example.toml for all available options including:

• File/directory exclusion patterns
• Theme configuration (Helix themes or custom colors)
• Customizable key bindings

Key Features

• Image and PDF support through kitty protocol

Auto-Refresh

The viewer automatically watches for file changes:

• Current directory: Refreshes file list when files are added/deleted
• Preview file: Refreshes preview when the viewed file is modified
• Search index: Refreshes every 30 seconds to pick up new files

Development

Pre-commit Hooks

Use prek! https://github.com/j178/prek