#cli #image

bin+lib ptit

Converts an image to block characters

2 releases

Uses new Rust 2021

0.1.1 May 24, 2022
0.1.0 May 24, 2022

#2231 in Command line utilities

MIT license

170KB
234 lines

ptit

Put this in text

A CLI for turning images or videos into block text elements to view in the terminal

Installation

Cargo

Requires a Rust install

cargo install ptit

Usage

URL

Input
cargo run -- -cr url "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/132.png"
Output

[]

File

Input
cargo run -- -cr file "~/Downloads/63.png"

[]

Flags

Crop

Adding the -c/--crop flag will crop the image to it's content, removing all surrounding transparent pixels

Example

Used in combination with -r to avoid large images

Without

With

Resize

Using the -r/--resize flag will resize the image to fit to your terminal, either squashing or biggering the image

Example

Used in combination with -c to avoid large images

Without

With

Solid

Using the -s/--solid flag will stop dithering on pixels with an alpha of less than 255

I had to use XTerm for these screenshots, hence bad colours

Example

Without

With

Dependencies

~17–26MB
~406K SLoC