Skip to main content

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

Release files for Imgscii 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Imgscii 1.0.2
File Size Uploaded
Imgscii-1.0.2.zip 9.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Imgscii 1.0.2
File Interpreter ABI Platform
Imgscii-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 13.6 kB

Release files / Imgscii-1.0.2.zip

Download URL Imgscii-1.0.2.zip
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5e87fe5f00c5ded0cb213180ccae0cffb7668989ba4cbb8820ed3be1be027f37
BLAKE2b-256 checksum
How to use checksums
dfd9e70f8b4fc29e424245dd80dc73c4bbf0898f0b15c52a98952f503025e5f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / Imgscii-1.0.2-py3-none-any.whl

Download URL Imgscii-1.0.2-py3-none-any.whl
Size 4.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2d175a41076d44d6fa3dda54dfe0fa9698a473f03785f8f54e4532acd88d628c
BLAKE2b-256 checksum
How to use checksums
3672a1262818d2e0322d500bcf5379a170ede31198a910b2ec31b49df12673f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.1

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page