Skip to content

Releases: Gishankrishka/python-jp2a

Release - jp2a v1.4.0

19 Oct 16:35
@Gishankrishka Gishankrishka
1.4.0
ffe91b9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Release - jp2a v1.4.0 Latest
Latest

jp2a v1.4.0 - Release Notes

Release Date: October 19, 2025

✨ New Features

🎥 Automatic Video Audio Playback

  • Videos now play audio automatically in the background
  • Audio synced to ASCII frame rate for perfect lip-sync
  • Supports MP4, MOV, AVI, MKV, WebM

⚡ Performance Improvements

  • Optimized ASCII rendering for faster frame rates
  • Better memory management
  • Improved timing calculations

🐛 Bug Fixes

  • Fixed audio playback on Windows, macOS, and Linux
  • Improved FFmpeg integration with better error handling
  • Fixed frame timing synchronization
  • Resolved terminal clearing delays

📖 Update

From GitHub

git pull origin main

From pip

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

🎯 Usage

# Play video with audio
python jp2a.py video.mp4 --fullscreen --highres

# Custom resolution
python jp2a.py video.mp4 --width 100 --color

⚠️ Note

Audio is intentionally slowed (~30%) to match ASCII rendering speed for synchronization. Use --width 80 for faster playback.

📄 License

MIT © 2025 Gishan Krishka

Assets 2
Loading

jp2a-python v1.0.0

13 Aug 10:38
@Gishankrishka Gishankrishka
1.0.0
12eeebc
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
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

🧰 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

Loading