Image in ASCII

ASCII Art Converter

Project Description:
A graphical desktop application in Python for converting raster images to ASCII art. The project is implemented as a classic Unix filter: it takes an image and outputs a clean text stream suitable for further processing in pipelines or scripts.

Features:
1) Support for a wide range of image formats (PNG, JPG, JPEG, BMP, GIF, WebP).
2) Automatic scaling considering aspect ratio and character height compensation to maintain proportions.
3) Conversion to grayscale with optimal brightness mapping to a limited set of ASCII characters.
4) Real-time preview of ASCII art in a monospaced font.
5) Export of the result as plain text (.txt) or rendered image (.png) with customizable background and text color.
6) Minimalist dark interface on PyQt6 with convenient buttons for opening, copying, and saving.
7) Detailed logging of operations to a file for debugging and auditing.
8) Full modularity: each stage (loading, processing, conversion, rendering, UI) is separated into its own file and easily reusable.

Example of Work:
Converting a portrait retains recognizable facial features and details even with a limited width of 120 characters. In the screenshot: on the left - text preview in the application, on the right - exported PNG image with rendered ASCII.
In the screenshot, the left part is ASCII text in QTextEdit, the right is a rendered png of Joseph Vissarionovich Stalin on the background of the USSR flag.

Technologies:
Python 3, PyQt6 (GUI), Pillow (image processing).

Repository:
https://github.com/fedyaqq34356/image-to-ascii.git