Image2ASCII

Python application for converting an image to ASCII code.
Explore the docs »

My Blog · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Image2ASCII is application for creating ASCII code or ASCII image from your images. You can also learn how to design your application with Python and PyQt5 here.

(back to top)

Built With

• PyQt5
• Python 3.6.5
• PyInstaller

(back to top)

Installation

Below is an tutorial for installing and setting up this app. If you wanna use this one without caring about the source code, please clone and run "Image2ASCII.exe" instead.

1. Clone the repo

   git clone https://github.com/PhongCode/Image2ASCII.git

2. Install required packages

   pip install -r requirements.txt

3. Run main.py

   python main.py

(back to top)

Roadmap

• Convert image to ASCII code
• Convert image to ASCII image
• Add Upload image theme
• Add resolution slider
• Add README.md
• Fix reading bug on .PNG image

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "Contribute". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b contribute/amazing_feature)
3. Commit your Changes (git commit -m 'Add some amazing_feature')
4. Push to the Branch (git push origin contribute/amazing_feature)
5. Open a Pull Request

(back to top)

Contact

Nguyễn Triệu Phong - Facebook: Nguyễn Triệu Phong - [email protected]

Project Link: https://github.com/PhongCode/Image2ASCII

(back to top)