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.1a10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d92ffaa0e0e515a4f2edfe9526c66623a5e344fd48f8da3c145047a442fad2a |
|
MD5 | 79a14c350edf0fd1a0a818c6b45b86d1 |
|
BLAKE2b-256 | 9aecd414879003fd2b1917df946c76d4261d6207d637f1072c891a3f093983af |