ferrite

Crates.ioferrite
lib.rsferrite
version0.1.28
created_at2024-12-15 11:35:33.716082+00
updated_at2025-08-02 20:18:35.938198+00
descriptionFast and efficient image viewer with focus on performance
homepage
repositoryhttps://github.com/master-of-zen/ferrite
max_upload_size
id1484080
size323,517
Zen (master-of-zen)

documentation

https://docs.rs/ferrite

README

Ferrite

IT VIEWS IMAGES FAST

Features

  • 🚀Blazingly-high-performance image loading with async caching
  • ⚙️Highly Configurable
  • 🎯Straight to the point

⚡Quick Start

cargo install ferrite
ferrite [IMAGE_PATH]

Keybindings

Navigation

  • Left Arrow / A: Previous image
  • Right Arrow / D: Next image
  • Q: Quit

🔍View Controls

  • + / = / W: Zoom in
  • - / S: Zoom out
  • 0: Reset zoom
  • F: Toggle fit mode

🖱️Mouse Controls

  • Scroll: Zoom in/out
  • Left Click + Drag: Pan image

⚙️Configuration

Ferrite uses TOML for configuration. Generate a default config:

ferrite --generate-config

The config file location is determined by:

  1. FERRITE_CONF environment variable
  2. Default XDG config path (~/.config/ferrite/config.toml)

Fields in config are self descriptive.

🏃PERFORMANCE

  • PARALLEL image loading
  • SMART caching system
  • ADAPTIVE memory usage
  • ASYNC I/O everywhere
  • GPU POWER via egui

License

GPL-3.0-or-later

Commit count: 175

cargo fmt