Skip to main content

Create ASCII artwork from images.

Project description

Imgscii is a simple program that converts images into ASCII artwork. Follow the prompts and your ASCII art will be printed to your console. I plan on adding more features and improvements in the future.

Getting Started

You can get started by installing Imgscii using PIP:

pip install imgscii


As A Module

After you have installed the package from PIP you can import Imgscii into your project.

import imgscii


Imgscii currently supports a small set of keyword arguments.

monochrome: ASCII art will be printed with default console style… no color!

imgscii.printscii("images/my-photo.jpg", monochrome=True)

columns: Define the width of your ASCII art in columns. Aspect ratio will be maintained.

imgscii.printscii("images/my-photo.jpg", columns=75)

char_set: Provide your own character set.

imgscii.printscii("images/my-photo.jpg", char_set=("#", "$", "Q", "v", "j", ";", "."))

From The Console

Imgscii can be executed from the console as well. Use cd to navigate to the directory containing imgscii.pyand run the program with the following command:


You can also use command line arguments.

-m, –monochrome: Print ASCII art without colors -c, –columns: Define the width of ASCII art in columns.


  • Add more options for printing
  • Create more ASCII artwork

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Imgscii, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size Imgscii-1.0.2-py3-none-any.whl (4.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size (9.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page