belilo 2026.5.24

A command-line tool for whitening images.
Documentation 
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

# 🖼️ Belilo 🧼

![Stars](https://img.shields.io/github/stars/Inc44/belilo?style=social)
![Forks](https://img.shields.io/github/forks/Inc44/belilo?style=social)
![Watchers](https://img.shields.io/github/watchers/Inc44/belilo?style=social)
![Repo Size](https://img.shields.io/github/repo-size/Inc44/belilo)
![Language Count](https://img.shields.io/github/languages/count/Inc44/belilo)
![Top Language](https://img.shields.io/github/languages/top/Inc44/belilo)
[![Issues](https://img.shields.io/github/issues/Inc44/belilo)](https://github.com/Inc44/belilo/issues?q=is%3Aopen+is%3Aissue)
![Last Commit](https://img.shields.io/github/last-commit/Inc44/belilo?color=red)
[![Release](https://img.shields.io/github/release/Inc44/belilo.svg)](https://github.com/Inc44/belilo/releases)
[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/Inc44)

Belilo, which translates to 'whitewasher' in Russian, is a useful tool created with ❤️ using Rust. It quickly whitens images, providing a clean, uniform appearance. It's fast, efficient, and precise.

## ⚙️ Features

- 🚀 Fast image whitening powered by [Rayon](https://crates.io/crates/rayon).
- 🖼️ Supports many image formats (BMP, GIF, JPEG, PNG, QOI, TGA, and WEBP).
- 🗂️ Batch process multiple images at once.
- 📁 Organized output to keep trimmed images together.
- 🛠️ Easy-to-use command-line interface.

## 🚀 Installation from crates.io

```bash
cargo install belilo
```

## 🛠️ Build from Source

```bash
git clone https://github.com/Inc44/belilo.git
cd belilo
cargo build --release
```

## 📦 Publish

```bash
cargo publish
```

## 📖 Usage Example

```bash
cargo run --release <input_paths>... [options]
```

Or

```bash
belilo <input_paths>... [options]
```

## 🎨 Command-Line Arguments

| Argument        | Description                                            |
|-----------------|--------------------------------------------------------|
| `<input_paths>` | Paths to the input images or directories (required)    |
| `--override`    | Override the input image instead of creating a new one |

## 🐛 Bugs

Not yet found.

## ⛔ Known Limitations

Not yet known.

## 🙏 Thanks

Creators of:

- [Rust](https://www.rust-lang.org)
- [clap](https://github.com/clap-rs/clap)
- [Image](https://github.com/image-rs/image)
- [Rayon](https://github.com/rayon-rs/rayon)
- [walkdir](https://github.com/BurntSushi/walkdir)

## 🤝 Contribution

Contributions, suggestions, and new ideas are heartily welcomed. If you're considering significant modifications, please initiate an issue for discussion before submitting a pull request.

## 📜 License

[![MIT](https://img.shields.io/badge/License-MIT-lightgrey.svg)](https://opensource.org/licenses/MIT)

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## 💖 Support

[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/xamituchido)
[![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/inc44)
[![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white)](https://www.patreon.com/Inc44)