Skip to content

markmysler/asciify

Repository files navigation

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors