Что такое viu?
viu is a small but powerful command-line image viewer written in Rust that displays images directly in your terminal. It adapts to your terminal's capabilities, using the best available protocol — from the high-fidelity Kitty and iTerm2 graphics protocols down to Unicode block characters as a universal fallback.
⚡ Key Features of viu
🖼️ Multiple Display Protocols
Supports Kitty terminal graphics protocol, iTerm2 inline images, Sixel graphics, and Unicode block characters — automatically picks the best one for your terminal.
📦 Wide Format Support
Displays PNG, JPEG, GIF, BMP, ICO, TIFF, WebP, AVIF, and many more formats via Rust's image crate.
🎞️ GIF Animation
Plays animated GIFs directly in the terminal, looping through frames at the correct frame rate.
📏 Flexible Sizing
Control width, height, or let viu auto-fit the image to your terminal window. Useful for pipelines and scripting.
🔗 Pipe-Friendly
Reads from stdin or file arguments, making it composable with tools like curl, find, and shell pipelines.
⚡ Fast & Lightweight
Written in Rust — minimal startup time, low memory footprint, and no runtime dependencies beyond the binary.
🖥️ Supported Terminal Protocols
- Kitty: Full-resolution pixel-perfect images (kitty, Ghostty, WezTerm)
- iTerm2: Inline image protocol (iTerm2, WezTerm, Tabby, VSCode)
- Sixel: Compatible with foot, Windows Terminal, and many classic terminals
- Unicode blocks: Universal fallback — works in every terminal
📦 Installation from deb.griffo.io
Шаг 1: Добавить репозиторий
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updateШаг 2: Установить viu
# Install latest viu
sudo apt install viu
# Verify installation
viu --version# Install latest viu
apt install viu
# Verify installation
viu --version🎯 Примеры использования
Basic usage:
# Display a single image
viu image.png
# Display multiple images
viu *.jpg
# Display from stdin
curl -sL https://example.com/photo.jpg | viu -
# Display a GIF animation
viu animation.gifSizing options:
# Set width in terminal columns
viu -w 80 image.png
# Set height in terminal rows
viu -h 24 image.png
# Disable auto-resizing
viu -s image.pngPipeline examples:
# Browse images in a directory
for f in ~/Pictures/*.jpg; do viu -w 40 "$f"; done
# Use with fzf to browse and preview
find . -name "*.png" | fzf --preview "viu -w 60 {}"🚀 Почему deb.griffo.io?
- Официальный Ubuntu: viu не упакован в официальных репозиториях Ubuntu
- Cargo Install: Requires Rust toolchain and compilation time
- deb.griffo.io: Latest version available immediately via
apt
- ✅ Latest Features: Get newest viu features including AVIF and improved protocol support
- ✅ No Rust Compilation: Pre-built musl static binary, no toolchain or extra dependencies needed
- ✅ Automatic Updates: Packages updated within hours of upstream releases
- ✅ Proper Packaging: Correctly packaged as a package with clean install/remove
- ✅ Multi-Distribution: Работает на Jammy, Noble, Questing и Resolute
📦 Репозиторий сборки пакетов
Пакеты Ubuntu автоматически собираются и поддерживаются в этом репозитории GitHub:
- 🖼️ viu-debian - Latest release builds
🔗 Связанные пакеты
Также доступны на deb.griffo.io:
- Файловый менеджер Yazi - Терминальный файловый менеджер со встроенным предпросмотром изображений
- eza - Современная замена ls
- fzf Fuzzy Finder - Сочетайте с viu для интерактивного просмотра изображений
💝 Support This Project
If this repository saves you time and effort, please consider supporting it!