中文版

termfoto

Fast, lightweight terminal photo viewer — browse images like a pro.

  ╭─────────────────────────────────────────────────╮
  │  🖼  img_0001.png  🖼  img_0002.png  ...        │
  │                                                 │
  │  8-column chafa thumbnails · vim-style nav      │
  │  Enter fullscreen · original size · zero-block  │
  │                                                 │
  │  photo_0042.png [42/156]  ←→↑↓ navigate  ...   │
  ╰─────────────────────────────────────────────────╯

✨ Features

🎯 Design Philosophy

Do one thing, and do it well. termfoto is not a slideshow, a batch exporter, or a photo editor. It does one thing — lets you see your images in the terminal, as fast as possible.

• Main thread never blocks — all I/O and encoding run on background threads
• Terminal-native experience — like ls or vim: launches instantly, responds immediately
• Ruthlessly minimal — before adding a feature, ask: "will it make browsing slower?"

📦 Installation

Zero dependencies by default. termfoto uses your terminal's built-in protocols (sixel/kitty) or halfblocks rendering with no system packages required.

💡 Want even better quality? Install with chafa support: cargo install termfoto --features chafa (requires libchafa-dev). Prebuilt binaries include chafa statically — download and run, no deps needed.

Option 1: Cargo (recommended)

cargo install termfoto

Option 2: Prebuilt binary

Download from Releases, drop into PATH:

chmod +x termfoto
sudo cp termfoto /usr/local/bin/

Option 3: .deb package (Debian/Ubuntu)

curl -LO https://github.com/PineWhisperStudio/termfoto/releases/latest/download/termfoto_latest_amd64.deb
sudo apt install ./termfoto_latest_amd64.deb

Option 4: Build from source

git clone https://github.com/PineWhisperStudio/termfoto.git
cd termfoto
cargo build --release
ln -s $(pwd)/target/release/termfoto ~/.local/bin/dr

Optional alias

# Add to ~/.bashrc or ~/.config/fish/config.fish
alias dr='termfoto'

🚀 Usage

termfoto                 # browse current directory
termfoto ~/Pictures      # browse a directory
termfoto photo.jpg       # open a single image (fullscreen mode)

⌨ Keybindings

🔧 Tech Stack

📜 License

MIT