PyASCII

PyASCII is a Python script that applies an ASCII filter to both images and videos. The script allows for customization of resolution, contrast, sharpness, and color filters.

The Sprite Sheet used in the script was made by @DanXimemes

Features

• Image, GIF, and Video Processing: Convert media files into ASCII art.
• Customizable Filters: Apply color filters using built-in options or configure your own through the filters.toml file.
• Multi-threaded Video Processing: Speeds up video conversion by utilizing multiple CPU cores.

Graphical User Interface

A separate script includes a basic Graphical User Interface (GUI) that simplifies the process of selecting files, adjusting settings, and executing the conversion. This GUI version is designed to be user-friendly, especially for those who prefer a visual interface over command-line operations.

To use the GUI version, simply run the PyASCII_GUI.py script or the packaged executable at the release page.

Installation

1. Clone the repository:

   git clone https://github.com/madmattp/PyASCII.git
   

2. Install dependencies:

   pip install -r requirements.txt
   

Usage

To run the script, use the following command:

python PyASCII.py -i <media_file> [options]

Command Line Options:

• -i, --input PATH: Specifies the input image or video file (Required).
• -r, --resolution RES: Sets the resolution of the output (Default is 720).
• -f, --filter FILTER: Applies a monochrome filter to the output.
• -c, --contrast FACTOR: Adjusts the contrast (Default: 1).
• -s, --sharpness FACTOR: Adjusts the sharpness (Default: 1).
• -t, --threads INTEGER: Specifies the number of threads for processing (Default: 1)
• -o, --output PATH: Specifies the output file path. If not set, a default name will be used.

Examples

Convert an Image

python3 PyASCII.py -i cat_image.jfif -r 480 -s 1.6 -c 1.7 -f Orange -o output_image.png

Convert a Video

python3 PyASCII.py -i cat_huh.mp4 -r 1080 -f Brat

cat_huh.mp4

output_video.mp4

How it Works

Image Processing:

1. The image is resized while maintaining its aspect ratio.
2. The pixel values are mapped to ASCII characters based on their brightness.
3. The resulting image is saved as a PNG file at ./PyASCII_Image.png or at a custom PATH defined by the -o flag.

Video Processing:

1. The video is split into subclips.
2. Each subclip is processed into ASCII art frames.
3. The final video is generated by concatenating the processed subclips, with the original audio track added back.

Notes

• Ensure that the sprite sheet (sprite_sheet.png) is available in the script's directory.
• For faster video processing, increase the number of threads using the -t option (depending on your CPU's core count).