Awesome
<div align="center"><img src="img2ascii.png">
A command-line tool for converting images to ASCII art
🛠️ Installation
# Clone the repository
git clone https://github.com/JosefVesely/img2ascii
# Navigate to the project directory
cd img2ascii
# Compile the program
make
🚀 Usage
Run using the following syntax:
img2ascii [options] -i <FILE> [-o <FILE>]
Options:
| Short | Long | Parameter | Description |
|---|---|---|---|
| -i | --input | File | Path of the input image file (required) |
| -o | --output | File | Path of the output file |
| -w | --width | Number | Width of the output image |
| -c | --chars | String | Characters to be used for the ASCII image |
| -p | Print the output to the console | ||
| -r | --reverse | Reverse the string of characters |
🧩 Examples
| Input | Output |
|---|---|
| <img src="images/c.png" width="300"> | <img src="examples/ascii-c.png" width="500"> |
img2ascii -i images/c.png -w 40 -p | |
| <img src="images/monroe.jpg" width="300"> | <img src="examples/ascii-monroe.png" width="500"> |
img2ascii -i images/monroe.jpg -w 35 -p -r | |
| <img src="images/pink_floyd.jpg" width="300"> | <img src="examples/ascii-pink_floyd.png" width="500"> |
img2ascii -i images/pink_floyd.jpg -w 80 -p -r | |
| <img src="images/pepsi.png" width="300"> | <img src="examples/ascii-pepsi.png" width="500"> |
img2ascii -i images/pepsi.png -w 35 -p -r | |
| <img src="images/aperture.jpg" width="300"> | <img src="examples/ascii-aperture.png" width="500"> |
img2ascii -i images/aperture.jpg -w 50 -p |
🧪 Compatibility
The supported image file formats are PNG, JPEG and BMP
This program has been tested and works on the following operating systems:
- Windows 11
- Linux Mint 22
🤝 Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request
📜 License
This project is licensed under the MIT License