Skip to content

jdormit/txtpic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Generate Unicode art from images

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages