logo-art

Convert images to Unicode/True Color ANSI art for terminal display.

Uses half-block characters (▄/▀) to pack two pixel rows per terminal line with 24-bit true color escape sequences. Algorithm ported from dom111/image-to-ansi.

Usage

use logo_art::{image_to_ansi, print_image};

// Embed a PNG at compile time
const LOGO: &[u8] = include_bytes!("logo.png");

fn main() {
    // Print directly (width = 40 columns, height proportional)
    print_image(LOGO, 40);

    // Or get the ANSI string
    let ansi = image_to_ansi(LOGO, 80);
    print!("{ansi}");
}

Build-time conversion

You can convert the image during compilation so your binary ships a pre-rendered ANSI string with zero runtime image processing.

build.rs

use std::{env, fs, path::Path};

fn main() {
    let out_dir = env::var("OUT_DIR").unwrap();
    let logo_bytes = include_bytes!("assets/logo.png");
    let ansi = logo_art::image_to_ansi(logo_bytes, 40);
    fs::write(Path::new(&out_dir).join("logo.ansi"), ansi).unwrap();
    println!("cargo::rerun-if-changed=assets/logo.png");
}

Cargo.toml (add a build dependency)

[build-dependencies]
logo-art = "0.2"

src/main.rs

const LOGO: &str = include_str!(concat!(env!("OUT_DIR"), "/logo.ansi"));

fn main() {
    print!("{LOGO}");
}

API

• image_to_ansi(image_data: &[u8], width: u32) -> String — Convert image bytes to an ANSI escape code string. width sets the output width in terminal columns; height is derived proportionally.
• print_image(image_data: &[u8], width: u32) — Convenience wrapper that prints directly to stdout.

Example CLI

cargo run --example cli -- path/to/image.png 60

Features

• True color (24-bit) ANSI output
• Transparency support (renders transparent pixels with default terminal colors)
• Proportional scaling from a single width parameter
• Minimal dependencies (image crate with PNG feature only)

License

MIT