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.0.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.0-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: asciifyy-1.0.0.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.0.tar.gz
Algorithm Hash digest
SHA256 c668c838fbd7374cfc1b7c4f3c9f9ddfcd721012b287a672b35ff0c15eead058
MD5 c7b8badd086887ab9c357f16b17fe99f
BLAKE2b-256 27d40b82316751ff505c81b124659542818b6da6298c9ea5e555767905e51217

See more details on using hashes here.

File details

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

File metadata

  • Download URL: asciifyy-1.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 82cfa07ecd59e9b2fd3a67102081533d5bffd729a2d6682fc2df51ddc94aaef2
MD5 c6a1767736c8af455c6c56f2d70e4903
BLAKE2b-256 c43b603297875c3c9954320a7d0777859d911e48f66d1cb5618392d546a0802a

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