Back to projects

PyAscii-Art

Convert images to ASCII art with Python. Simple library for transforming images into text-based ASCII representations.

MIT Updated Dec 11, 2021

Image to Ascii-Art

forthebadge made-with-python
Python 3.6

Usage

  • Make sure you have Python installed in your system.
  • Run Following command in the CMD.
 pip install PyAscii-Art

Example

  from PyAsciiArt import AsciiArt
  
  # Path to the image
  image_path = r"image.jpg"
  
  # Create new Ascii-Art
  ascii_art = AsciiArt(image_path)

  ascii_art.generatePixelArray()     # Generate the pixel-array of the image
  ascii_art.trimPixelColors()        # Set the pixel brightness value to match the char list
  ascii_art.generateAsciiImage()     # Generate the image
  ascii_art.writeToFile("image.txt") # Write the image to the image.txt file