https://github.com/imacod3r/image-to-ascii
Script that takes an image and converts into an ASCII Art representation.
https://github.com/imacod3r/image-to-ascii
ascii-art pillow-library python
Last synced: 8 months ago
JSON representation
Script that takes an image and converts into an ASCII Art representation.
- Host: GitHub
- URL: https://github.com/imacod3r/image-to-ascii
- Owner: ImaCod3r
- Created: 2024-07-10T11:53:50.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-05T14:27:38.000Z (almost 2 years ago)
- Last Synced: 2025-03-02T21:18:03.403Z (over 1 year ago)
- Topics: ascii-art, pillow-library, python
- Language: Python
- Homepage:
- Size: 389 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Image to ASCII Converter
This project is a python script that converts as image into an ASCII art representation. It uses the Python Imaging Library (PIL) to manipulate the image and convert it into a grayscale image, which is then converted into an ASCII art representation using a predefined set of ASCII characters.
## ⚙️ Installation
To run this project, you need to have Python installed on your system. You can download the latest version of Python from the official Python website.
Additionally, you need to install the Python Imaging Library (PIL) using pip:
```bash
pip install pillow
```
## 💡 Usage
To use this script, simply run the `main.py` file and enter the path to the image you want convert when prompted.
## 📝 Notes
- The ASCII art representation is generated using a predefined set of ASCII characters. You can improve this by allowing the user to customize the set of characters used or by using a more advanced algorithm to generate the ASCII art.
- The script does not handle errors well. You can improve this by adding more robust error handling and providing more informative error messages.
## 👷♂️ Author
This project was created by **Edson Rodrigues (Imacod3r)**.