asciisciit

ASCII Art, Video, and Plotting Toolbox

Ever wanted to convert gifs to text and then back into gifs again?

Ever wanted to stream your webcam into your terminal as text?

Me neither.

But now I can!

Installation

Should work with py2 or py3, on both Linux and Windows.

Install with pip to make sure you get the dependencies.

$ git clone https://github.com/derricw/asciisciit.git

$ cd asciisciit

$ pip install .

You can also install from pypi.

$ pip install asciisciit

Use

Examples to run!

Convert a gif to ascii and render it back to gif in 8 point font:

$ asciit dealwithit.gif ascii_render.gif -p 8

Display webcam feed from camera 0 in a new terminal, with histogram equalization:

$ asciit -w 0 --n --e

Play a video file in a new terminal, scale to 0.15 characters per pixel, display at 24 fps:

$ asciit cats.mp4 -s 0.15 --n -f 24.0

You can even use URLs.

$ asciit https://media.giphy.com/media/bn0zlGb4LOyo8/giphy.gif cage.gif --e -s 0.6 -f 8

Using the module

Images

>>> from asciisciit import AsciiImage
>>> img = AsciiImage("my_img.png", scalefactor=0.2)
>>> print(img)
>>> img.render("output.png", fontsize=8, bg_color=(20,20,20), fg_color=(255,255,255))

Gifs

>>> from asciisciit import AsciiMovie
>>> gif = AsciiMovie("my_gif.gif", scalefactor=0.2)
>>> gif.play(fps=15.0)  #play at 15 fps
>>> gif.render("ouput.gif", fps=15.0, fontsize=8)

Movies

>>> from asciisciit import AsciiMovie
>>> movie = AsciiMovie("my_movie.avi", scalefactor=0.2)
>>> movie.play(fps=24.0)
>>> movie.render("output.avi", fps=24.0, fontsize=8) # requires ffmpeg

TODO:

1. Color
2. more/custom look up tables