colorgram

Crates.iocolorgram
lib.rscolorgram
version0.1.2
created_at2025-05-09 03:46:01.864305+00
updated_at2025-09-05 19:28:28.714374+00
descriptionRust library that extracts colors from image. Port of colorgram.py
homepagehttps://github.com/arabianq/colorgram-rust
repositoryhttps://github.com/arabianq/colorgram-rust
max_upload_size
id1666185
size634,311
arabian (arabianq)

documentation

README

colorgram-rust


colorgram-rust is a rust program that lets you extract colors from image. It is a port of colorgram.py (which is itself a port of colorgram.js, so it's basically a port of a port =D)

Why? Well, it's ~25 times faster than colorgram.py (9 ms vs 225 ms for test.png on my laptop)

Installation as CLI utility

cargo install colorgram

Adding to your rust project

[dependencies]
colorgram = "0.1.0"

Usage Example (code from main.rs)

use colorgram::extract;

fn main() {
    let img_path = "test.png";
    let colors_amount = 10;

    let colors = extract(img_path, colors_amount).unwrap();
    for color in colors {
        println!("RGB: {} {} {} HSL: {} {} {} Proportion: {:.2}", color.rgb.r, color.rgb.g, color.rgb.b, color.hsl.h, color.hsl.s, color.hsl.l, color.proportion);
    }
}
Commit count: 9

cargo fmt