Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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

Release History

This version
History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(4.4 kB) Copy SHA256 Hash SHA256
Wheel py3 Nov 30, 2016
(9.2 kB) Copy SHA256 Hash SHA256
Source None Nov 30, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting