txtpic's Introduction

txtpic

Generate Unicode art from images

Installation

You'll need Cargo to install txtpic.

$ cargo install txtpic

Usage

txtpic 1.2.4
Jeremy Dormitzer <[email protected]>
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.

Converting it with:

$ txtpic --width 100 cat.jpg

Gives the output:

txtpic's People

Contributors

Stargazers

Watchers

txtpic's Issues

Can't use a custom character set

$ /home/elad/.cargo/bin/txtpic --character-set "▀▀▂▃▄▅▆▇█▉▊▋▌▍▎▏▐░▒▓▔▕▖▗▘▙▚▛▜▝▞▟" ~/test.png 
error: The argument '--character-set <CHARACTERS>' cannot be used with '--preset <PRESET NAME>'

USAGE:
    txtpic <IMAGE> --character-set <CHARACTERS> --preset <PRESET NAME> --width <WIDTH>

For more information try --help

I was hoping txtpic could generate a unicode-block-character representation of my test image, but for some reason it's convinced that I used --preset

--width has no effect

edit: it's a bit weird, with some ~~PNG~~ files it works as expected with some other it just ignores the width argument :-\

Hosted txtpic

Hey, cool project. I saw your crate and thought I'd quickly hack together a hosted version for fun.

Not much else to see here, just thought I'd point to a fun use of your crate, so feel free to close. (And if you happen to want to maintain/own it on our platform, just let me know.)

Recommend Projects