koba-rs
| Crates.io | koba-rs |
| lib.rs | koba-rs |
| version | 0.1.2 |
| created_at | 2025-11-07 21:25:02.304949+00 |
| updated_at | 2025-11-23 19:36:52.287904+00 |
| description | Rust rewrite of https://github.com/simon0302010/koba, a terminal image renderer. |
| homepage | |
| repository | https://github.com/simon0302010/koba-rs |
| max_upload_size | |
| id | 1922198 |
| size | 5,445,560 |
(simon0302010)
documentation
README
koba-rs
A fast Rust implementation of koba — a terminal image renderer that converts images into ASCII/Unicode art.
Installation
cargo install koba-rs
Or build from source:
git clone https://github.com/simon0302010/koba-rs
cd koba-rs
cargo build --release
./target/release/koba-rs image.png
Quick Start
koba-rs image.png
Features
- Color and grayscale rendering
- Custom character sets (ASCII, Unicode, Braille, geometric shapes)
- Custom OpenType and TrueType font support
- Adjustable image scaling and block sizing
- GIF animation support
Arguments
| Argument | Description | Default |
|---|---|---|
IMAGE_PATH |
Path to input image (PNG, JPG, GIF) | Required |
-c, --char-range |
Unicode character range (e.g., 32-126) | 32-126 |
-s, --scale |
Scale factor for output | 1.0 |
--font |
Path to custom OpenType or TrueType font | Unifont |
--no-color |
Render in grayscale | false |
--no-invert |
Don't invert image for processing | false |
--min-size |
Minimum block size for processing | 2.5 |
--debug |
Print debug messages | false |
Credits
- GNU Unifont is used for character comparison.
License
This project is licensed under the GNU General Public License Version 3. See LICENSE for details.