jp2a-python v1.0.0

Release Notes: jp2a-python v1.0.0

Release Date: 2025-08-13

✅ Features

• Initial public release of jp2a-python.
• Convert images to ASCII art with optional ANSI color.
• Convert videos to ASCII with high-resolution Unicode half-blocks.
• Terminal fullscreen mode with automatic resizing.
• Flip images horizontally or vertically (--flipx, --flipy).
• Edge detection mode (--edges-only) for stylized ASCII output.
• HTML output support (--html) for web embedding.
• Optional borders and background fill for a polished display.
• Works with URLs, local files, or piped input.
• Fully functional CLI (jp2a) and programmatic API (convert_to_ascii).

🛠 CLI Options

• --width, --height: Control output dimensions.
• --color: Enable terminal color.
• --html: Export ASCII to HTML.
• --charset: Custom ASCII characters.
• --invert: Invert brightness.
• --highres: Use Unicode half-blocks.
• --fullscreen: Fit output to terminal size.
• --flipx, --flipy: Flip horizontally/vertically.
• --edges-only: Edge detection mode.
• --fill: Fill background in color mode.
• --border / -b: Draw a border.
• --clear: Clear terminal before drawing.
• --output / -o: Write output to a file.
• --version / -V: Show version information.

📝 Notes

• Press Ctrl+C to stop video playback gracefully.
• High-res mode automatically enables color for best visual results.
• Tested on Python 3.9+.

🔗 Links

• GitHub: https://github.com/Gishankrishka/python-jp2a

🧰 Installation

pip install git+https://github.com/Gishankrishka/python-jp2a.git

⚡ Example Usage

# Convert an image to ASCII
jp2a image.png --width 100 --color

# Convert a video to ASCII
jp2a video.mp4 --fullscreen --highres

---

Full Changelog: https://github.com/Gishankrishka/python-jp2a/commits/1.0.0