A command-line tool for converting images to ASCII art

Installation 💿

# Clone the repository
git clone https://github.com/JosefVesely/Image-to-ASCII

# Enter the project directory
cd Image-to-ASCII

# Compile the program using Make
make

Usage 📋

Usage: img2ascii [options] -i <FILE> [-o <FILE>]

A command-line tool for converting images to ASCII art

Options:
    -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
    -c, --chars  <STRING>   Characters to be used for the ASCII image
    -p, --print             Print the output to the console
    -r, --reverse           Reverse the string of characters

Examples 🌟

Input	Output
	img2ascii -i images/c.png -w 40 -p
	img2ascii -i images/monroe.jpg -w 35 -p -r
	img2ascii -i images/pink_floyd.jpg -w 80 -p -r
	img2ascii -i images/pepsi.png -w 35 -p -r
	img2ascii -i images/aperture.jpg -w 50 -p

TODO ✔️

• Add option for colored output
• Name the output files with input filename and date (e.g. monroe_08-18-2023.txt)
• Name the output files with input filename (e.g. monroe.txt)
• Create a release

Contributing 🤝

Contributions are welcome! If you have any improvements or bug fixes, feel free to submit a pull request

License 📄

This project is licensed under the MIT License - see the LICENSE file for details