ferrite 0.1.28

Fast and efficient image viewer with focus on performance
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# Ferrite
[![](https://img.shields.io/crates/v/ferrite.svg)](https://crates.io/crates/ferrite)
[![](https://tokei.rs/b1/github/master-of-zen/ferrite?category=code)](https://github.com/master-of-zen/ferrite)


IT VIEWS IMAGES FAST

## Features

- 🚀Blazingly-high-performance image loading with async caching
- ⚙️Highly Configurable
- 🎯Straight to the point
## ⚡Quick Start

```bash
cargo install ferrite
ferrite [IMAGE_PATH]
```
+ Set it as default image viewer.
[Here are instructions](/install/README.md)
## 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:

```bash
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