#ascii-art #gif #image #ffmpeg #png #jpeg #terminal

app i2a-rs

A tool converting images to ASCII graph

1 unstable release

0.1.0 Mar 21, 2024

#293 in Video

GPL-2.0-or-later

5.5MB
530 lines

i2a-rs

Yet another Image to ASCII Art tool

Highlights

  • support for multiple formats i2a-rs can render static as well as animated images
  • responsive i2a-rs automatically resizes images when terminal size changed
  • efficient i2a-rs calls ffmpeg to decode GIFs and caches rendered stuff for next time use

Install

Currently you can install by cloning the repo and build the binary:

git clone https://github.com/hsfzxjy/i2a-rs/
cd i2a-rs
cargo build --release  
# The release version has better performance while rendering GIFs

ffmpeg

i2a-rs requires ffmpeg to decode GIFs, so make sure the command ffmpeg is available before rendering a GIF image. You may follow this link to get it installed correctly.

Usage

Render a static image (JPEG, PNG, etc.)

cargo run --release images/google.png

Google-Demo

Redner a GIF image and play infinitely

cargo run --release images/cube.gif

or just play for one cycle

cargo run --release images/cube.gif --once

GIF-Demo

Dependencies

~16MB
~373K SLoC