7 stable releases

Uses old Rust 2015

1.2.4 Apr 6, 2017
1.2.3 Apr 5, 2017
1.2.2 Apr 3, 2017
1.0.1 Apr 2, 2017

#1429 in Text processing

MIT license

285KB
287 lines

txtpic

Generate Unicode art from images

Installation

You'll need Cargo to install txtpic.

$ cargo install txtpic

Usage

txtpic 1.2.4
Jeremy Dormitzer <jeremy.dormitzer@gmail.com>
Generates text representations of images

USAGE:
txtpic [FLAGS] [OPTIONS] <IMAGE>

FLAGS:
-h, --help       Prints help information
-i, --invert     Invert the result to make it suitable for black text on a white background
-V, --version    Prints version information

OPTIONS:
-c, --character-set <CHARACTERS>    An alternate character set to use
-p, --preset <PRESET NAME>          A preset character set to use [default: small]  [values: small, medium, large, emoji]
-w, --width <WIDTH>                 An approximate width value for the result [default: 80]

ARGS:
<IMAGE>    The input image

Note: the --width option attempts find a width close to the target width that preserves 
the aspect ratio of the original image. For certain images, there may be only one or two 
valid widths within a reasonable range, so the --width option may not appear to have an effect.
In this case, try extremely high or extremely low width values to affect the output.

Example

Here is an adorable cat.

Adorable cat

Converting it with:

$ txtpic --width 100 cat.jpg

Gives the output:

Text cat

Dependencies

~10MB
~41K SLoC