#ferrite #navigation #viewer #cache #config #points #configurable #ferrite-navigation

ferrite-navigation

Navigation and path handling for Ferrite image viewer

9 releases

new 0.1.24 May 17, 2025
0.1.23 May 3, 2025
0.1.22 Apr 18, 2025
0.1.21 Jan 6, 2025
0.1.17 Dec 31, 2024

#6 in #configurable

Download history 6/week @ 2025-02-05 55/week @ 2025-02-12 8/week @ 2025-02-19 4/week @ 2025-02-26 157/week @ 2025-04-16 13/week @ 2025-04-23 130/week @ 2025-04-30 33/week @ 2025-05-07

333 downloads per month
Used in 2 crates (via ferrite-core)

GPL-3.0-or-later

38KB
150 lines

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

Dependencies

~24–67MB
~1M SLoC