<picture class="only-github">
<source media="(prefers-color-scheme: dark)" srcset="https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-dark-theme.gif">
<source media="(prefers-color-scheme: light)" srcset="https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-light-theme.gif">
<img src="https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-light-theme.gif" alt="Textual Window banner">
</picture>
<!-- MKDOCS-START
MKDOCS-END -->
# Textual-Color-O-Matic
[](https://github.com/edward-jazzhands/textual-coloromatic/releases/latest)
[](https://python.org)
[](https://mypy-lang.org/)
[](https://opensource.org/license/mit)
Textual-Color-O-Matic is a [Textual](https://github.com/Textualize/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.
## 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, 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 `repeat` constructor 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.
## Demo App
If you have [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/stable/), you can immediately try the demo app:
```sh
uvx textual-coloromatic
```
```sh
pipx run textual-coloromatic
```
## Documentation
### [Click here for documentation](https://edward-jazzhands.github.io/libraries/textual-coloromatic/docs/)
## Video
<video style="width: 100%; height: auto;" controls loop>
<source src="https://edward-jazzhands.github.io/assets/textual-coloromatic/demo-0.2.1-handbrake.mp4" type="video/mp4">
Your browser does not support the video tag.
</video>
[](https://github.com/user-attachments/assets/1140fd13-526c-4bc8-b489-a6e59d9b5252)
## Questions, Issues, Suggestions?
Use the [issues](https://github.com/edward-jazzhands/textual-coloromatic/issues) section for bugs or problems, and post ideas or feature requests on the [TTY group discussion board](https://github.com/orgs/ttygroup/discussions).
Raw data
{
"_id": null,
"home_page": null,
"name": "textual-coloromatic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "art, ascii, color, coloromatic, python, textual, tui, widget",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/28/e4/d83a7145cbdb9f7cd29864dc555d9c0a99f212ee77b8d124987952ae5747/textual_coloromatic-1.0.0.tar.gz",
"platform": null,
"description": "<picture class=\"only-github\">\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-dark-theme.gif\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-light-theme.gif\">\n <img src=\"https://edward-jazzhands.github.io/assets/textual-coloromatic/banner-light-theme.gif\" alt=\"Textual Window banner\">\n</picture>\n\n<!-- MKDOCS-START\n\n\nMKDOCS-END -->\n\n# Textual-Color-O-Matic\n\n[](https://github.com/edward-jazzhands/textual-coloromatic/releases/latest)\n[](https://python.org)\n[](https://mypy-lang.org/)\n[](https://opensource.org/license/mit)\n\nTextual-Color-O-Matic is a [Textual](https://github.com/Textualize/textual) library for color animations and tiling effects.\n\nIt 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.\n\n## Features\n\n- Color system built on Textual's color system. Thus, it can display any color in the truecolor/16-bit spectrum,\nand can take common formats such as hex code and RGB, or just a huge variety of named colors.\n- Make a gradient automatically between any two colors, or through any number of colors.\n- Animation system that's simple to use. Just make your gradient and toggle it on/off. It can also be started\nor stopped in real-time.\n- Comes with 3 different animation modes - \"gradient\", \"smooth_strobe\", and \"fast_strobe\".\n- Comes with 18 built-in patterns and a pattern constructor argument for easy setting.\n- Has a `repeat` constructor argument for creating your own patterns or tiling any art.\n- Fully reactive - update the loaded ASCII art change patterns in real-time. Will resize automatically when width or height is set to auto.\n- Animation settings have a variety of variables to modify, including horizontal, reverse, FPS, and quality.\n- Included demo app to showcase the features.\n\n## Demo App\n\nIf you have [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/stable/), you can immediately try the demo app:\n\n```sh\nuvx textual-coloromatic\n```\n\n```sh\npipx run textual-coloromatic\n```\n\n## Documentation\n\n### [Click here for documentation](https://edward-jazzhands.github.io/libraries/textual-coloromatic/docs/)\n\n## Video\n\n<video style=\"width: 100%; height: auto;\" controls loop>\n <source src=\"https://edward-jazzhands.github.io/assets/textual-coloromatic/demo-0.2.1-handbrake.mp4\" type=\"video/mp4\">\n Your browser does not support the video tag.\n</video>\n\n[](https://github.com/user-attachments/assets/1140fd13-526c-4bc8-b489-a6e59d9b5252)\n\n## Questions, Issues, Suggestions?\n\nUse the [issues](https://github.com/edward-jazzhands/textual-coloromatic/issues) section for bugs or problems, and post ideas or feature requests on the [TTY group discussion board](https://github.com/orgs/ttygroup/discussions).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Textual widget for displaying ASCII art with color effects and animations.",
"version": "1.0.0",
"project_urls": {
"Changelog": "https://github.com/edward-jazzhands/textual-coloromatic/blob/master/Changelog.md",
"Repository": "https://github.com/edward-jazzhands/textual-coloromatic"
},
"split_keywords": [
"art",
" ascii",
" color",
" coloromatic",
" python",
" textual",
" tui",
" widget"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a01a728070277a432a082af766aadc8a835aea58f8b776243b85be7d2eb6cd56",
"md5": "37e1948d6bd3e825be88614350752569",
"sha256": "7136fabe2f81691d6ff26dd47f6c4d6a16ddfbca3b235255cdfbf11129e42ac3"
},
"downloads": -1,
"filename": "textual_coloromatic-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37e1948d6bd3e825be88614350752569",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 35307,
"upload_time": "2025-07-28T09:34:53",
"upload_time_iso_8601": "2025-07-28T09:34:53.670332Z",
"url": "https://files.pythonhosted.org/packages/a0/1a/728070277a432a082af766aadc8a835aea58f8b776243b85be7d2eb6cd56/textual_coloromatic-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "28e4d83a7145cbdb9f7cd29864dc555d9c0a99f212ee77b8d124987952ae5747",
"md5": "3a3cd7d1c629032d6447bbad8fffea51",
"sha256": "9ae89cb1d6523e4ce697f4a01f9891cc7149c0747f5e7e00ed85b00d8ea87a21"
},
"downloads": -1,
"filename": "textual_coloromatic-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "3a3cd7d1c629032d6447bbad8fffea51",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 115919,
"upload_time": "2025-07-28T09:34:55",
"upload_time_iso_8601": "2025-07-28T09:34:55.231872Z",
"url": "https://files.pythonhosted.org/packages/28/e4/d83a7145cbdb9f7cd29864dc555d9c0a99f212ee77b8d124987952ae5747/textual_coloromatic-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 09:34:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "edward-jazzhands",
"github_project": "textual-coloromatic",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "textual-coloromatic"
}
JSON
