asciipy

python library and cli tool to convert images and videos to ascii

Example output:

additional examples can be found in /examples/

Command line usage:

asciipy [input_file] [output_file] [width] (optional, default=80)

Command line examples:

• image with default size: asciipy test.png ascii.png

• video with default size: asciipy test.mp4 ascii.mp4

• image with custom size: asciipy test.png ascii.png 160

• video with custom size: asciipy test.mp4 ascii.mp4 160

Optional dependencies (URL and Youtube support):

• note: these libraries can be manually installed instead. youtube_dl can be used instead of yt-dlp
• asciipy-any[full] will install requests and yt-dlp to enable downloading from urls and youtube videos.
• asciipy-any[url] will install requests to enable downloading from urls.
• asciipy-any[youtube] will install yt-dlp to enable downloading youtube videos.

Python usage:

• you can find our documentation here: https://asciipy-any.readthedocs.io/

Python examples:

image to ascii cli

from asciipy import ImageConverter
import sys

img = ImageConverter()
img.convert(sys.argv[1], './ascii.png')
print(f"{sys.argv[1]} converted and written to ./ascii.png")

Planned features:

• proper gif support (mostly done, but still to buggy to be considered finished)
• ability to write output as html
• ability to convert vectors (not sure how i could even go about this)

need help?

• join my discord server!

• or my guilded server (i'm often not online here)