vngnc3 / ascii-encoder

ASCII Encoder 🎨⌨️🤖

Prerequisites

🐍 This project needs Python installed on your system.

Installation

1. Clone the repository:

   git clone https://github.com/vngnc3/ascii-encoder
   cd ascii-encoder

2. Install the required dependencies: Make sure you are in the project directory and run:

   pip install -r requirements.txt

Usage

Run the code, add images into input folder, then run it again.

python main.py

To configure the parameters, edit main.py file and change # Render Settings to your liking. Experiment with the settings for different results. You can even add more ASCII character shading style in the main.py file.

Run the code as many times as you want with your new render settings.

Features

• Multiple Shading Styles: Choose from various predefined shading styles to customize the look of your ASCII art.
• Adjustable Dimensions: Set the number of columns and line height to control the size and aspect ratio of the output.
• Inversion and Normalization: Invert colors and normalize pixel values for different artistic effects.

Feature requests, bug reports

Hit me up on Twitter/X: @vngnc