📸 ASCII Converter

A powerful and fast desktop application to transform images and videos into stylized ASCII art. Built with Python and optimized for performance.

🚀 Key Features

• Fast Video Rendering: Optimized engine that processes hundreds of frames in seconds.
• Audio Support: Automatically merges original audio with the generated ASCII video.
• Real-time Preview: Adjust the "Width" slider to see instant changes in detail density.
• Social Media Ready: Unique "Copy as Markdown" feature for perfect pasting into Discord or Telegram.
• Standalone EXE: No Python installation required – just download and run.

🛠 Tech Stack

• GUI: CustomTkinter (Modern Dark Theme)

• Image Processing: OpenCV & Pillow (PIL)

• Video Processing: MoviePy 2.0+ & ImageIO

📖 How to Use

1. Select File: Upload any image (.png, .jpg) or video (.mp4, .avi).

2. Adjust Detail: Use the slider to change the character width (lower for retro look, higher for detail).

3. Export:

   • Click "Save as PNG" for a static image.
   • Click "Copy as Markdown" to share the text version.
   • Click "Render ASCII Video" to create a full MP4 with sound.

   📦 Installation (for Developers)

4. Clone the repository: git clone https://github.com/kleorr/ASCII-Converter.git

5. Install dependencies: pip install customtkinter Pillow opencv-python moviepy proglog imageio imageio-ffmpeg

6. Run the script: python main.py