Is viu in the official Debian repositories?

No — viu is not packaged in the official Debian archives. This repository is currently the only apt source, serving viu 1.6.1.

How do I install the latest viu on Debian?

Add the deb.griffo.io repository once using the instructions above, then run: sudo apt install viu. New releases arrive through the normal sudo apt upgrade.

Are the packages signed and how are they built?

Every package is signed with the repository's GPG key (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) and built from upstream releases in public GitHub packaging repositories that anyone can inspect.

Which Debian releases are supported?

Debian 12 Bookworm, Debian 13 Trixie, Forky and Sid.

Install Latest viu on Debian via apt

Source	Version
deb.griffo.io	1.6.1 ✅
Official Debian	🚫 not packaged

← Back to home

What is 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.

            🚀 Why Latest Versions Matter: viu continuously improves support for new image formats, terminal protocols, and display options. The latest releases include AVIF support, improved Kitty protocol rendering, better GIF animation handling, and performance optimizations for large images.
        

⚡ 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

Run the commands

Step 1: Add Repository

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 update

install -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

🆓 There is an always-free mirror. deb-free.griffo.io serves packages free forever — no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries Ghostty, Oh My Posh and Zed; viu is not one of them, so the repository above is the only way to get it today — ask and it can be enrolled.

How the free mirror works →

Step 2: Install viu

# Install latest viu
sudo apt install viu

# Verify installation
viu --version

# Install latest viu
apt install viu

# Verify installation
viu --version

🎯 Usage Examples

Basic usage:

# Display a single image
viu image.png

# Display multiple images
viu *.jpg

# Display from stdin (e.g. downloaded image)
curl -sL https://example.com/photo.jpg | viu -

# Display a GIF animation
viu animation.gif

Sizing options:

# Set width in terminal columns
viu -w 80 image.png

# Set height in terminal rows
viu -h 24 image.png

# Disable auto-resizing (use original size)
viu -s image.png

Pipeline examples:

# Browse images in a directory
for f in ~/Pictures/*.jpg; do viu -w 40 "$f"; done

# Preview image from a URL
curl -sL https://example.com/image.png | viu -

# Use with fzf to browse and preview
find . -name "*.png" | fzf --preview "viu -w 60 {}"

🚀 Why Choose deb.griffo.io?

📊 Repository Comparison:

Official Debian: viu is not packaged in official Debian repositories
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 Debian package with clean install/remove
✅ Multi-Distribution: Works on Bookworm, Trixie, Forky, and Sid

📦 Package Build Repository

The Debian packages are automatically built and maintained in this GitHub repository:

🖼️ viu-debian - Latest release builds

🔗 Related Packages

Also available from deb.griffo.io:

Yazi File Manager - Terminal file manager with built-in image preview
eza - Modern ls replacement
fzf Fuzzy Finder - Combine with viu for interactive image browsing

            🎯 Perfect for: Developers previewing assets from the terminal, sysadmins checking images over SSH, users of Kitty, Ghostty, or WezTerm who want pixel-perfect image display, and anyone integrating image previews into shell scripts or tools like yazi and fzf.
        

💝 Support This Project

If this repository saves you time and effort, please consider supporting it!

⭐ Star on GitHub 🐦 Share on Twitter

🖼️ Install Latest viu on Debian