ASCII Image Generator 🖼

.............................................................,,.....................................
........,;;++++;,...........................................:%;.....................................
.......;??&&&&&&&:..........................................;%;...............................,,....
......,?+,+&&&&&&&,...................................,::...;%;...............................,;:::,
......,?+,+&&&&&&&,...................................;%;...;%;................................::;;,
......,?&&&&&&&&%&,...................................;%;...;%;................................,,:,.
....,,,;;;;;+&&&%&,.,............,:::,....,,,....,,,.,;%;,,.;%;..,,,......,::,........,::,..........
..,+????????&&&%%&,,,,,........:?&&&%?:..,?&,....;&:.+&%&&;.;%;;?&&?:....;&&&&?,...,;?&&&&+,........
.,+&&&&&&&&&&&&%%&:,:::,......:&?:,,:&&,.,&&,....+%:.,+%+,,.;%&?;:;%&,..;%+,,:&&,.,?&;,,:?%+........
.:&&&&&&&&&&&%%%%&:,:::,......;%;....+%+.,&&,....+%:..;%;...;%+....+%;.:%?....:%?.,&?....:%?........
.+&&&&&&&&&&%%%%%&,::::,......;%;....:%&.,&&,....+%:..;%;...;%;....:%+.+%;....,&&,,&?....,&?........
.+&&&&&&&&&&%%%%&:,:::::......;%;....,&&,.&&,....+%:..;%;...;%;....:%+.?%:.....?%:,&?....,&?........
.?&&&&&&;:::::::,,::::::,.....;%;....,&&,.&&,....+%:..;%;...;%;....:%+.?%:.....?%:,&?....,&?........
.?&&&&&:,,,,,,,,::::::::,.....;%;....,&&,.&&,....+%:..;%;...;%;....:%+.+%:.....?%:,&?....,&?........
.+&&&&+,:,,,::::::::::::......;%;....:%?.,&&,....+%:..;%;...;%;....:%+.;%+....,&&,,&?....,&?........
.;&&&%;,,,,::::::::::::,......;%;....+%;..?%:....+%:..;%;...;%;....:%+.,&&,...;%+.,&?....,&?........
.,&&&%;,,::::::::::::::,......;%&+;:+%?,..;%&;:;?&%:..,&&:,.;%;....:%+..:%?::;&?,.,&?....,&?........
..:?&&;,::::::::::::::,.......;%++&&&+,....;?&&?++%:...:?&;.:?;....:?;...:?&&&+,..,?+....,?+........
...,,,,,:::::,,,,,,,,,........;%;.,,,........,,..;%:.....,,................,,,......................
.......:::::::::::,...........;%;................+%,................................................
......,::::::::,::,...........;%;...............,&&,................................................
.......::::::::,,:,...........;%;............,,:&&:.................................................
.......,:::::::::,............;%;............?&&?:..................................................
........,,:::::,,..............,,............::,....................................................
....................................................................................................
....................................................................................................
........,,,,,,,,,...................................................................................
........,,,,,,,,,...................................................................................
....................................................................................................

Pure Python script to generate ascii image art from a picture.

Installation and Usage

1. Clone the repository to your local machine.

   git clone https://github.com/brianobot/ascii_image.git
   

2. Ensure you have python installed and running on your local machine. ( Run the command below in a terminal console to confirm installation)

   python -v
   

   if the command produces an output without an error message continue
   else visit https://www.python.org/downloads to get python on your machine.

3. Navigate into directory that contains the script on your terminal/cmd prompt console.

4. Install the dependencies needed to run the script.

   pip install -r requirements.txt

5. • Run the script from the Command Line

   Copy the script into the directory that contains the image you wish to work on and run the command below.

   python ascii_image.py <file_name of the image you wish to use>

   Example

   python ascii_image.py my_image.jpeg

   • Run the script directly

   Copy the script into the directory that contains the image you wish to work on and double click on the script to run it directly.

   Follow the prompts on the screen to execute the tasks properly

Contribution and Issue Report

If you run into a bug while using this program, you can report the issue to the maintainer via a mail.
If you find places of potential upgrades and improvement to the program logic or implementaion, clone the repo, effect your changes and make a pull request, Thank you! 🤗

Maintainer

• Brian Obot brianobot9@gmail.com