CherryPill / ASCII-art-creator

ASCII art generator for images

ASCII art creator

ASCII art creator is a creation tool that allows you to turn your images into ASCII art. You can either create images that will comprise of ASCII characters or write the actual characters to a .txt file for posting somewhere, but beware that it works best with Monospaced font, if it's something else, the characters will be skewed and generally look unpleasant.

The program supports the following formats:

• GIF
• PNG
• JPG

You can choose if you want to preserve the original colors of the image or render it using two colors for background and foreground, be aware that if you use original colors and choose a dark background the image will be dark overall too.

Download

Examples:

• Processing a GIF image with preserved colors and dark background

Input:

Ouput:

• Processing a still PNG/JPG image

Input:

Output (rendered with preserved colors on white background):

Output (rendered with preserved colors on yellow background):

# Showcase

Build & Run instructions

Build using your locally installed maven and run with the installed JRE >= 8:

mvn package && java -jar target/ascii_art-1.0-SNAPSHOT-shaded.jar

Build and install into the local repo as a developer using your locally installed maven and run using exec-maven-plugin:

mvn clean install exec:java -DskipTests=true

Prerequisites:

You need Java Runtime Environment (8 and onwards) installed on your machine.

⚠️ Warning

Due to a currently unresolved bug in JDK. Some gifs may be processed incorrectly or not processed at all.