Textual-Color-O-Matic is a Textual library for color animations and tiling effects.
It is designed to make it easy to animate strings with cool color effects, as well as set background patterns that can function as wallpaper or backdrops for widgets.
- 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, or through any number of 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.
- Comes with 3 different animation modes - "gradient", "smooth_strobe", and "fast_strobe".
- Comes with 18 built-in patterns and a pattern constructor argument for easy setting.
- Has a
repeatconstructor argument for creating your own patterns or tiling any art. - Fully reactive - update the loaded ASCII art change patterns in real-time. Will resize automatically when width or height is set to auto.
- Animation settings have a variety of variables to modify, including horizontal, reverse, FPS, and quality.
- Included demo app to showcase the features.
If you have uv or pipx, you can immediately try the demo app:
uvx textual-coloromaticpipx run textual-coloromaticdemo-0.2.1-handbrake.mp4
Use the issues section for bugs or problems, and post ideas or feature requests on the TTY group discussion board.