Metadata-Version: 2.4
Name: textual-coloromatic
Version: 0.2.1
Summary: A Textual widget for displaying ASCII art with color effects and animations.
Project-URL: Repository, https://github.com/edward-jazzhands/textual-coloromatic
Project-URL: Changelog, https://github.com/edward-jazzhands/textual-coloromatic/blob/master/Changelog.md
License: MIT
Keywords: art,ascii,color,coloromatic,python,textual,tui,widget
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Requires-Dist: textual-slidecontainer>=0.4.2
Requires-Dist: textual>=3.4.0
Description-Content-Type: text/markdown

# textual-coloromatic

![badge](https://img.shields.io/badge/linted-Ruff-blue?style=for-the-badge&logo=ruff)
![badge](https://img.shields.io/badge/formatted-black-black?style=for-the-badge)
![badge](https://img.shields.io/badge/type_checked-MyPy-blue?style=for-the-badge&logo=python)
![badge](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)

Textual-Color-O-Matic is a [Textual](https://github.com/Textualize/textual) library for color animations.

It is designed to make it easy to animate strings with cool color effects.

## Features

- Color system built on Textual's color system. Thus, it can display any color in the truecolor/16-bit spectrum,
and can take common formats such as hex code and RGB, or just a huge variety of named colors.
- Make a gradient automatically between any two colors.
- Animation system that's simple to use. Just make your gradient and toggle it on/off. It can also be started
or stopped in real-time.
- Update the loaded ASCII art in real-time.
- Animation settings can be modified to get different effects. Set a low amount of colors and a low speed for a
very old-school retro look, set it to a high amount of colors and a high speed for a very smooth animation, or
experiment with a blend of these settings.
- Included demo app to showcase the features.

## Documentation

### [Click here for documentation](https://edward-jazzhands.github.io/libraries/textual-coloromatic/)

## Questions, issues, suggestions?

Feel free to post an issue.

## Video

Coming soon (and documentation, I swear)
