artscii

A cli tool to generate ascii art.

::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
:::::::::::::::::::::::::::::::::::::::::;::::::::::::::::::::::::::::::::::::::::
:::::::::::::::::::::::::::::::::::;?%::%%;+:%::;:;:::::::::::::::::::::::::::::::
::::::::::::::::::::::::::::;:;;%%%?%%%%%%%%%%%*%%;:+:::::::::::::::::::::::::::::
:::::::::::::::::::::::::::::%%%%%%%%%%%%%%%%%%%%%%%%%::::::::::;:::::::::::::::::
::::::::::::::::%+::::::;+%%?%%%%%%%%%%%%%%%%%%%%%%%%%*%%::::::%%%::::::::::::::::
:::::::::::::%?++%%%:::;;:%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%:;;::%%%%+:%%::::::::::::
:::::::::::;%%%?:%%%:::%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%::%%%%%%%:::::::::::::
:::::::::::::%%%%%%%::::%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%:::?%%%%%::::::::::::::
::::::::::::::::%%%::%%%%%%%%%%%%%%%%:@S%%%%%+#@%%%%%%%%%%%%%%:%%*::::::::::::::::
::::::::::::::::;:%%%:%%%%%%%%%%%%%%:.@@@%%%@:.@@%%%%%%%%%%%?%%?::::::::::::::::::
::::::::::::::::::::%%%%%%%%%%%%%%%%@@@@#%%%#@@@@%%%%%%%%%%%%%%:::::::::::::::::::
:::::::::::::::::;%%%%:SS%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%SSSS*%%%:::::::::::::::::
::::::::::::::::::;:%%%:S%:::SSS%%%%%%%%%%@%%%%%%%%SSS*::;;S:%%+;:::::::::::::::::
::::::::::::::::::::::%%::S::::::+:::.::::::::.:::;:::::;::+%%::::::::::::::::::::
::::::::::::::::::::::;:%::;::::::::::::::::::::::::::::::;*?:::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::;:::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::

Installation

Pre-built binary (for CLI use)

If you want to use it as a CLI tool, head over to the releases page.

• Download artscii-...-.tar.gz for your preferred platform.
• Extract the file via tar xzvf artscii-...-.tar.gz.
• Run ./artscii --path /path/to/img.

Using Cargo (for lib use)

If you want to use this as a dependency in your project.

cargo install artscii

Usage

As a library

use artscii::core::frame::Frame;

// load image as a frame
let frame = Frame::from_path("./path/to/img")?
    .resize(32, 32)?
    .colorise()?;

// holds a Vec<char> with the converted ascii chars
let ascii = frame.to_ascii().unwrap();

// optionally print it
Frame::render(ascii);

As a CLI tool

artscii --path path/to/img

Options

artscii [OPTIONS]
  --path <PATH>  Options:   -p, --path <PATH>
  -v, --verbose...   Increase logging verbosity
  -q, --quiet...     Decrease logging verbosity
  -h, --help         Print help