fileview 1.6.2

A minimal file tree UI for terminal emulators
Documentation

FileView (fv)

Crates.io Downloads CI License: MIT MSRV

A minimal, fast terminal file browser with vim-like keybindings

English | 日本語

Why fv?

  • Instant startup - No config needed, just cargo install fileview
  • Image preview - Kitty/iTerm2/Sixel support with auto-detection
  • Git integration - Color-coded file status at a glance
  • Vim keybindings - Navigate with j/k/h/l
  • Fuzzy finder - Quick file search with Ctrl+P

Quick Start

cargo install fileview
fv

Features

Feature Description
Tree navigation Expand/collapse with vim keys
Multi-select Batch operations on files
Preview panel Text, images, hex dump
File operations Create, rename, delete, copy/paste
Fuzzy finder Ctrl+P for quick search
Mouse support Click, scroll, drag
Nerd Fonts Icons enabled by default

Image Preview

FileView auto-detects your terminal:

Terminal Protocol
Kitty / Ghostty / Konsole Kitty Graphics
iTerm2 / WezTerm / Warp iTerm2 Inline
Foot / Windows Terminal Sixel
VS Code / Alacritty Halfblocks

Keybindings (Quick Reference)

Key Action
j/k Navigate up/down
h/l Collapse/expand
g/G Top/bottom
Space Toggle mark
/ Search
Ctrl+P Fuzzy finder
P Preview panel
q Quit

Full keybinding list

CLI Options

fv [OPTIONS] [PATH]

Options:
  -p, --pick          Pick mode: output selected path(s)
  -f, --format FMT    Output format: lines, null, json
  --stdin             Read paths from stdin
  --on-select CMD     Run command on selection
  --choosedir         Output directory on exit
  --no-icons          Disable Nerd Fonts icons

Exit Codes

Code Meaning
0 Success
1 Cancelled (pick mode)
2 Runtime error
3 Invalid arguments

Shell Integration

# Add to .bashrc or .zshrc
fvcd() {
  local dir=$(fv --choosedir "$@")
  [ -n "$dir" ] && [ -d "$dir" ] && cd "$dir"
}

Installation Options

# Standard install
cargo install fileview

# With Chafa support (better image quality on basic terminals)
brew install chafa  # or apt install libchafa-dev
cargo install fileview --features chafa

License

MIT