python library and cli tool to convert images and videos to ascii.
Project description
asciipy
python library and cli tool to convert images and videos to ascii
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
Python usage:
asciipy provides three classes VideoConverter
, ImageConverter
, and BaseConverter
-
BaseConverter: provided for subclassing, and internal use
-
VideoConverter: takes three positional arguments,
input
,output
,width
, and 1 keyword argument,progress
-
- (os.PathLike, IOBase, str) input: input video to convert
-
- (os.PathLike, IOBase, str) output: destination of the converted video
-
- (int) width: desired width in ascii characters (height is implicit from the aspect ratio of the input)
-
- (bool) progress: if a progress indicator should be printed during conversion
-
ImageConverter: takes three positional arguments,
input
,output
, andwidth
-
- (os.PathLike, IOBase, str) input: input image to convert
-
- (os.PathLike, IOBase, str) output: destination of the converted image
-
- (int) width: desired width in ascii characters (height is implicit from the aspect ratio of the input)
both converter classes implement a .convert()
method, which takes no arguments, to start the conversion
Python examples:
image to ascii cli
from asciipy import ImageConverter
import sys
img = ImageConverter(sys.argv[1], './ascii.png')
img.convert()
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 implemented)- ability to write output as html
- ability to convert vectors (not sure how i could even go about this)
need help?
-
or my guilded server (i'm often not online here)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for asciipy_any-0.1.1a8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf86665fcdeca9b4aaebe6be0d85911bc547cc79cc859827c8924f7282c808a5 |
|
MD5 | 3a14e40de206dc53c7324c1f00388cc8 |
|
BLAKE2b-256 | a32ffdd1cf8a4a9ac5a817dad2b84e7c8060ff74f032784b34249fb6927580c0 |