pyascii-maker 0.1.0

Advanced ASCII art generator with support for images, GIFs, videos, text banners, and multiple export formats

pyascii-maker

Advanced ASCII art generator with support for images, GIFs, videos, text banners, and multiple export formats.

Installation

pip install pyascii-maker

With video support:

pip install pyascii-maker[video]

Usage

Basic image conversion

pyascii-maker image.jpg

Animated shimmer

pyascii-maker image.jpg --animate

Export formats

# HTML export
pyascii-maker image.jpg -o output.html

# Rendered image export
pyascii-maker image.jpg -o output.png --rendered

# With white background
pyascii-maker image.jpg --rendered -o out.jpg --bg white

# ASCII text file
pyascii-maker image.jpg -o output.txt

Character sets

pyascii-maker image.jpg -c blocks
pyascii-maker image.jpg -c binary
pyascii-maker image.jpg -c matrix
pyascii-maker image.jpg --custom-chars "░▒▓█ "

Text-only ASCII art

pyascii-maker --text "HELLO" -f doom
pyascii-maker --list-fonts

Batch processing

pyascii-maker --folder ./images -o ./output

GIF and video

pyascii-maker animation.gif
pyascii-maker video.mp4

Advanced options

# RGB channel limiting
pyascii-maker image.jpg --rgb-cap 100,200,255

# Color enhancement
pyascii-maker image.jpg --saturation 2.0 --brightness 1.2

# Custom font for rendered images
pyascii-maker image.jpg --custom-font /path/to/font.ttf

# Add a banner
pyascii-maker image.jpg --label "DAISY" --theme cyan

CLI Reference

Option	Description	Default
-w, --width	Output width in characters	80
-c, --char-set	Character set style	standard
--custom-chars	Custom character string	-
--contrast	Contrast multiplier	1.0
--brightness	Brightness multiplier	1.0
--saturation	Saturation for rendered images	1.0
--invert	Invert brightness mapping	False
--rgb-cap	Cap RGB channels as R,G,B	-
--char-size	Font size for rendered image	15
--char-width	Pixel width per character	10
--char-height	Pixel height per character	18
--scale-factor	Downscale factor	0.09
--custom-font	Path to custom .ttf/.otf font	-
--bg-color	Background color (hex or name)	black
--rendered	Render ASCII as image file	False
-o, --output	Output file path	-
--animate	Animate with shimmer effect	False
--label	Add ASCII text banner	-
--font, -f	Pyfiglet font for banner	slant
--theme	Color theme for banners	cyan
--folder	Batch process folder	-

Supported Formats

• Images: jpg, jpeg, png, bmp, webp, tiff, tif
• Animated: gif
• Video: mp4, avi, mov, mkv, webm (requires opencv-python-headless)
• Export: txt, html, png, jpg, bmp

License

MIT