Imgscii

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

Usage

As A Module

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

import imgscii

imgscii.printscii("images/my-photo.jpg")

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:

python imgscii.py

You can also use command line arguments.

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

To-Dos

• Add more options for printing
• Create more ASCII artwork