to-ascii 3.3.0

A package which can convert videos, images, and gifs to ascii art!

To-Ascii

Converts videos, images, and gifs into ascii art!

[Example] [Example 2]

• Works on most common image types
• Works on most common video types
• Works on gifs

How does it work?

Videos:

When the conversion process is started, the video file is opened up and went through frame by frame. Each frame is composed of a set of arrays like [[[r, g, b], [r, g, b]], [[r, g, b], [r, g, b]]], the software then goes through each frame and calculates the average brightness of each pixel, which is then used to get a value from a gradient of ascii characters. Then, at the end, a set of "pretty" frames are made, that list looks like ['frame', 'frame',..] with frame obviously being the ascii art for each frame. When .view() is called or the video is viewed, the software print()s out each frame and then time.sleep()s for a bit.

Images:

The process is virtually identical to the one above, except it doesn't need to do a multitude of frames/images, it only needs to convert one. When .view() is called it just displays the image.

Installation

Via pip:

python3 -m pip install to-ascii

Example Usage

CLI:

to-ascii -t filetype -f filename

Video / GIF:

from toascii import Video

v = Video('my_file.mp4', scale=.1, verbose=True)
v.convert()  # convert the frames into ascii
v.view()  # play the converted frames in the console

Image:

from toascii import Image

img = Image('my_image.png', scale=.1, verbose=True)  # load the image
img.convert()  # convert the image to ascii
img.view()  # view the final asciified image

Documentation

• toascii.Video(filename='video.mp4', *, scale=1, w_stretch=2, gradient=Union[int, str], verbose=False)
  • Note: only filename can be a positional argument, the rest are kwargs.
  • Arguments:
    • filename the name of the file/video which is to be opened and processed
    • scale the amount/1 which the video dimensions are multiplied by
    • w_stretch the amount that the width dimension is multiplied by
    • gradient either an integer from the preset gradients, or a custom gradient Example: '#$a=+-., '
    • verbose whether or not to show extra information
  • Functions:
    • convert actually converts the video into ascii
    • view view the converted video

• toascii.Image(filename='image.png', *, scale=1, w_stretch=2, gradient=Union[int, str], verbose=False)
  • Note: only filename can be a positional argument, the rest are kwargs.
  • Arguments:
    • filename the name of the file/image which is to be opened and processed
    • scale the amount/1 which the image dimensions are multiplied by
    • w_stretch the amount that the width dimension is multiplied by
    • gradient either an integer from the preset gradients, or a custom gradient Example: '#$a=+-., '
    • verbose whether or not to show extra information
  • Functions:
    • convert actually converts the image into ascii
    • view view the converted image