A powerful ASCII art generator with CLI and importable API.
Project description
ASCII Art Maker
A powerful ASCII art generator for terminal and Python projects.
Features
- Text to ASCII art with font and color
- Gradient colors
- Image → ASCII (Pillow)
- Auto font suggestion
- Animated ASCII text
- Interactive menu mode
- Config file (.asciirc)
- Custom ASCII character sets
- True color (24-bit) support
- Export to HTML, SVG, PNG
- Batch processing
- Zoom and pan for large ASCII art
- ASCII watermarking
- ASCII math formula rendering (LaTeX)
Installation
pip install .
Usage
CLI
ascii-art-maker "Hello World" --font slant --color cyan --gradient
ascii-art-maker --image path/to/image.png
ascii-art-maker --interactive
Python API
from ascii_art_maker import generate_ascii, gradient_ascii, image_to_ascii
print(generate_ascii("Hello World", font="slant"))
print(gradient_ascii(generate_ascii("Hello")))
print(image_to_ascii("image.png"))
Advanced Features
from ascii_art_maker import set_custom_charset, truecolor, export_ascii_html, export_ascii_svg, batch_process, zoom_ascii, pan_ascii, watermark_ascii, latex_to_ascii
set_custom_charset(["#", " "])
print(image_to_ascii("image.png"))
set_custom_charset(None)
print(truecolor("Hello", (255,0,0)))
print(export_ascii_html("ASCII ART", color="red"))
print(export_ascii_svg("ASCII ART", color="#ff0000"))
print(batch_process(["Hello", "World"], generate_ascii))
print(zoom_ascii("ASCII ART", factor=2))
print(pan_ascii("ASCII ART", x=0, y=0, width=10, height=2))
print(watermark_ascii("ASCII ART", "WATERMARK"))
print(latex_to_ascii("x^2 + 1"))
Testing
python -m unittest discover tests
License
MIT
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
ascii_art_maker-0.8.0.tar.gz
(7.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ascii_art_maker-0.8.0.tar.gz.
File metadata
- Download URL: ascii_art_maker-0.8.0.tar.gz
- Upload date:
- Size: 7.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9aab30e657afa7e81aaa2857d9f54894b4880c9108817a7e3afaf6349ed97f3b
|
|
| MD5 |
75c9d5f2ea6e20ef9aca00ac822a5275
|
|
| BLAKE2b-256 |
3ef5d5db4f0087655bc60cfb055c6bbab6932e4ad927fee67f3c7eb674cbb8b8
|
File details
Details for the file ascii_art_maker-0.8.0-py3-none-any.whl.
File metadata
- Download URL: ascii_art_maker-0.8.0-py3-none-any.whl
- Upload date:
- Size: 7.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df279d64184f85f43db7bdcd3b291f00f2634e28f442015beb0fd4a55f87735b
|
|
| MD5 |
e4359db9a2bfe01467d58c5d66422af9
|
|
| BLAKE2b-256 |
ed971c4bac8b1a19c04d501cdd86fa2c13e7534a5bd5683e3cd6f7cb40f5bdb0
|