Skip to main content

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

Project description

Documentation Status pypi version Discord

asciipy

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

Example output:

image example gif example

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:

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?

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asciipy-any-0.3.0.tar.gz (22.3 kB view hashes)

Uploaded Source

Built Distribution

asciipy_any-0.3.0-py3-none-any.whl (22.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page