Quickly Converting media to ASCII!
ASCII-gen is an open-source image-to-ASCII converter that allows users to transform images into text art, making it an essential tool for creatives and developers alike. The projects core functionality includes extracting frames from videos or loading images, converting them to ASCII art, and optimizing the output GIF for both quality and size. The project is written in Python and is compatible with Linux, and Windows systems.
| Feature | Description | |
|---|---|---|
| ⚙️ | Architecture | The project runs in a GUI using tkinter (built into Python - no paid dependencies) |
| 🔌 | Integrations | The project integrates external libraries such as Pillow, moviepy, tkinter, numpy, imageio, and more. |
| 🧩 | Modularity | The project's structure is modular with each functionality separated into a dedicated Python script, enhancing code organization, reusability, and maintenance. |
| ⚡️ | Performance | Written to work dynamically with multithreading. |
| 📦 | Dependencies | The project depends on various external libraries and frameworks, listed within the requirements.txt. |
Expand
| File | Summary |
|---|---|
| requirements.txt | Install crucial dependencies for the ASCII-gen project. The requirements file lists necessary packages including colorama, decorator, imageio, moviepy, numpy, pillow, proglog, termcolor, tqdm. These packages support features such as image processing, GUI development, and video processing. tkinter is used for the GUI and is built into Python. |
| installer-linux.sh | Installs essential dependencies for the Ascii-image-converter software on Linux systems. Configures package repositories, updates system packages, installs Ascii-image-converter, gifsicle, and Python dependencies. |
| gui.py | The main file. Does all of the GUI workload. |
| run.bat | Launches the Graphical User Interface (GUI) application for windows. |
System Requirements:
- Python:
version 3.10 to 3.12
- Clone the ASCII-gen repository:
$ git clone https://github.com/KillaMeep/ASCII-gen.git
- Change to the project directory:
$ cd ASCII-gen
Run the program!:
$ run.batIf you're on Linux:
$ ./insaller-linux.sh $ pip3 install -r requirements.txt $ python3 gui.py