belilo 2026.5.28

A command-line tool for whitening images.
Documentation

๐Ÿ–ผ๏ธ Belilo ๐Ÿงผ

Stars Forks Watchers Repo Size Language Count Top Language Issues Last Commit Release Sponsor

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.
  • ๐Ÿ–ผ๏ธ 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.

โš ๏ธ Disclaimers

Input images with zero width or height (0x0) are skipped entirely, as according to image standards supported by this tool, they are not valid images by definition.

๐Ÿš€ Installation from crates.io

cargo install belilo

๐Ÿ› ๏ธ Build from Source

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

๐Ÿ“ฆ Publish

cargo publish

๐Ÿ“– Usage Example

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

Or

belilo <input_paths>... [options]

๐ŸŽจ Command-Line Arguments

Argument Description
<input_paths> Paths to the input images or directories (required)
-o, --override Override the input image instead of creating a new one
-k, --keep Keep modification time
-t, --threshold <value> Threshold for whitening (0-255) (default: 220)

๐Ÿ› Bugs

Not yet found.

โ›” Known Limitations

Not yet known.

๐Ÿ™ Thanks

Creators of:

๐Ÿค 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

This project is licensed under the MIT License. See the LICENSE file for details.

๐Ÿ’– Support

BuyMeACoffee Ko-Fi Patreon