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.

Source Distribution (9.2 kB view hashes)

Uploaded source

Built Distribution

Imgscii-1.0.2-py3-none-any.whl (4.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page