#ascii #image #terminal #cli-tool #cli

bin+lib tapciify

CLI tool that can let you view images in terminal as ASCII art

19 releases (12 stable)

new 3.3.0 Apr 7, 2024
3.2.0 Mar 30, 2024
2.2.1 Jan 20, 2024
2.2.0 Dec 31, 2023
0.5.0 Mar 27, 2023

#41 in Video

Download history 2/week @ 2023-12-25 5/week @ 2024-01-15 92/week @ 2024-02-12 27/week @ 2024-02-19 15/week @ 2024-02-26 8/week @ 2024-03-11 150/week @ 2024-03-18 122/week @ 2024-03-25 439/week @ 2024-04-01

719 downloads per month

MIT license

62KB
1K SLoC

ASCII Rin Shima

Tapciify

CLI tool that can let you view images in terminal as ASCII art

Requirements

  1. CC linker (Windows - Microsoft Visual Studio with C++ Support) (Linux - gcc)

  2. Rust

Installation

cargo install tapciify

Converting image

  1. Run: tapciify -i imagePath -w imageWidth for image.

  2. Run: tapciify -i imagePath -w imageWidth -r for reversed colors.

Converting video

In this example I set framerate to 24 (but you can use any another)

Requires ffmpeg

  1. Make frames from video into dir:

    mkdir frames; ffmpeg -i bad_apple.mkv frames/%08d.jpeg
    
  2. Run:

    tapciify -i frames/* -w videoWidth -f 24
    

Examples

Original ASCII ASCII colored Pixels Braille Braille colored Background string
Original Image ASCII art ASCII colored art ASCII art using pixels (█ symbol) Braille Braille colored Background string
Original image tapciify -i ./assets/examples/ferris.webp -w 64 tapciify -i ./assets/examples/ferris.webp -w 64 -c tapciify -i ./assets/examples/ferris.webp -w 64 --pixels tapciify -i ./assets/examples/ferris.webp -w 64 -b tapciify -i ./assets/examples/ferris.webp -w 64 -bc tapciify -i ./assets/examples/bad-apple.webp -w 64 --background-string badapple

Dependencies

~11–22MB
~143K SLoC