Skip to main content

Convert images to ASCII art in the terminal with optional color.

Project description

Asciify

Convert images to colored ASCII art in your terminal. This tool transforms any image into ASCII characters while preserving the original colors.

Example Output

Features

  • Convert images to ASCII art
  • Preserve original colors in terminal output
  • Adjustable output width
  • Option for monochrome output
  • Supports most common image formats (PNG, JPEG, GIF, etc.)

Installation

pip install asciifyy

Usage

Basic usage:

asciify path/to/image.jpg

Options

  • -w, --width : Set output width in characters (default: 100)

    asciify path/to/image.jpg -w 150
    
  • -nc, --no-color : Disable colored output

    asciify path/to/image.jpg --no-color
    

Requirements

  • Python 3.7 or higher
  • Pillow (PIL)
  • Colorama

Development

To set up the development environment:

git clone https://github.com/markmysler/asciify.git
cd asciify
pip install -e .

License

MIT License - See LICENSE for details.

Author

Mark Mysler (myslermark@gmail.com)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

asciifyy-1.0.4.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

asciifyy-1.0.4-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

Details for the file asciifyy-1.0.4.tar.gz.

File metadata

  • Download URL: asciifyy-1.0.4.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for asciifyy-1.0.4.tar.gz
Algorithm Hash digest
SHA256 b12597c0e4d0b365c5bc96af2ed07aa21025add50a7e930affa453fda3607470
MD5 8708417ad9ce3809c4187ad4568693d6
BLAKE2b-256 96d5d8923cbde2b85c3ece4dd55e210f2518205ba58d541151a3f5106614109f

See more details on using hashes here.

File details

Details for the file asciifyy-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: asciifyy-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 3.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for asciifyy-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 feb8a251e2f169fce5779dc388a471e579896bc0d6f818bf8fd05f590cc94627
MD5 573f6adb84ce92235bd275a8a0e768da
BLAKE2b-256 427358f356024e6dcf3efd3306e8a90734124bc290d822635e2745e943f7c957

See more details on using hashes here.

Supported by

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