Skip to content

2dameneko/img-vid-ascii

Repository files navigation

img-vid-ascii: Next-Gen ASCII Art Transformation 🔄🎨

Transform images and videos into stunning ASCII and unicode art and back with speed and quality. This isn't just another converter - it's a complete toolkit that preserves audio, maintains quality, and delivers performance.

Bad Apple!! PV Demo

Why This Stands Out ✨

🎭 Dual Media Magic
Convert both images AND videos seamlessly with a single utility. Your favorite images and clips become mesmerizing ASCII art in seconds.

3 Shades ASCII

💾 Ultra-Compact .ascii Format
Share creations that are 10–100× smaller than originals! A 50MB video becomes a 1.5MB .ascii file — perfect for messaging and storage.

🔊 Perfect Audio Preservation
Enjoy videos with original, untouched audio quality. Soundtracks remain crystal clear and perfectly synced.

⏩ Lightning-Fast Processing
Experience 3–5× realtime conversion speeds. GPU acceleration makes reconstruction back to MP4 blazing fast.

1 Blocks Style

Key Dependencies ⚙️

OpenCV-Python
Handles core media processing — image/video loading, grayscale conversion, and smart contrast enhancement.

FFmpeg-Downloader
Automatically installs and configures FFmpeg for seamless audio extraction and embedding without quality loss.

Numba
Supercharges reconstruction with JIT compilation, delivering GPU-like speeds for ASCII-to-video conversion.

Pillow
Powers professional font rendering during reconstruction, supporting custom character sets and anti-aliased text.

🔄 Complete Round-Trip Workflow

graph LR
    A[Original] -->|2_convert_to_ascii| B[Tiny .ascii File]
    B -->|3_play_ascii| C[Terminal Playback]
    B -->|4_convert_from_ascii| D[Shareable Media]
Loading

🎨 Unlimited Creativity
Choose from any character sets or create your own! Specialized fonts bring runic symbols and geometric shapes to life.

5 Blocks Style

Quick Start 🚀

  1. Install

    git clone https://github.com/2dameneko/img-vid-ascii
    cd img-vid-ascii
    0_install
  2. Convert & Play

    2_convert_to_ascii "your_video.mp4"
    3_play_ascii "your_video.ascii"

Dance Animation Demo

  1. Share Everywhere
    convert_from_ascii "your_video.ascii"

Share
Send the tiny .ascii file to friends — they'll see the full show with original audio!

4 Blocks Style

Transform Back
Create a viral social media version from the reconstructed MP4.

Technical Details ⚙️

Audio Perfection
Original audio extracted without re-encoding.

GPU-Powered Reconstruction
Supports NVIDIA CUDA, AMD AMF, and Intel QSV for fast conversion.

Smart Compression
Internal ZIP-based format with metadata and audio preservation.

Character Gallery 🖼️

2 Standard Style
6 Standard Style

Video Showcase 🎥

ZAKO ASCII Demo

Join the ASCII Revolution! 💻➡️🎨

Rediscover your media through the beauty of ASCII!

License

Apache License 2.0

Credits

About

img-vid-ascii: Next-Gen ASCII Art Transformation

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published