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.1a11-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 84f2c131b96cb0da92bc60ed300886cdbd4a6601f04f866e0b7b415581c11a1e |
|
MD5 | 0a2e0f3d2076170f30fd8c8caaa09886 |
|
BLAKE2b-256 | 0d3e41fdc704d4dfcdd76f69fa5f07ef3abd4535c90688d65085465d48602324 |