Skip to main content

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


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)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ascii_art_maker-0.8.0-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

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

Hashes for ascii_art_maker-0.8.0.tar.gz
Algorithm Hash digest
SHA256 9aab30e657afa7e81aaa2857d9f54894b4880c9108817a7e3afaf6349ed97f3b
MD5 75c9d5f2ea6e20ef9aca00ac822a5275
BLAKE2b-256 3ef5d5db4f0087655bc60cfb055c6bbab6932e4ad927fee67f3c7eb674cbb8b8

See more details on using hashes here.

File details

Details for the file ascii_art_maker-0.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ascii_art_maker-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 df279d64184f85f43db7bdcd3b291f00f2634e28f442015beb0fd4a55f87735b
MD5 e4359db9a2bfe01467d58c5d66422af9
BLAKE2b-256 ed971c4bac8b1a19c04d501cdd86fa2c13e7534a5bd5683e3cd6f7cb40f5bdb0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page