fiv
| Crates.io | fiv |
| lib.rs | fiv |
| version | 0.2.0 |
| created_at | 2026-01-18 14:12:42.747563+00 |
| updated_at | 2026-01-18 14:12:42.747563+00 |
| description | A fast, lightweight image viewer |
| homepage | https://github.com/Occy88/fiv |
| repository | https://github.com/Occy88/fiv |
| max_upload_size | |
| id | 2052407 |
| size | 167,198 |
Octavio del Ser (Occy88)
documentation
README
Fiv - Fast Image Viewer
A fast, lightweight image viewer built in Rust.
Features
- Instant navigation - Images are preloaded in the background as you browse
- Smooth scrolling - Hold arrow keys to rapidly flip through images
- Lightweight - Minimal memory usage with smart caching
- Wide format support - JPEG, PNG, GIF, BMP, WebP
Installation
From Package Managers
Debian/Ubuntu:
# Download the latest .deb from releases
sudo dpkg -i fiv_*.deb
Fedora/RHEL:
# Download the latest .rpm from releases
sudo rpm -i fiv-*.rpm
Arch Linux (AUR):
yay -S fiv
macOS (Homebrew):
brew tap Occy88/tap
brew install fiv
From Source
# Clone the repository
git clone https://github.com/Occy88/fiv.git
cd fiv
# Build and install
make release
sudo make install
Usage
# View images in current directory
fiv
# View images in a specific directory
fiv /path/to/images
Controls
| Key | Action |
|---|---|
Right / D / Space |
Next image |
Left / A |
Previous image |
Home |
First image |
End |
Last image |
Q / Escape |
Quit |
Tip: Hold navigation keys for rapid scrolling.
Building
Requirements:
- Rust 1.70+
- Linux:
libxkbcommon-dev,libwayland-dev
# Development build
cargo build
# Release build (optimized)
cargo build --release
# Run tests
cargo test
License
MIT License - see LICENSE for details.