Unicode Animatio

Lightweight Unicode and ASCII terminal animation data for Python.

GitHub · PyPI · Website · Docs · X

Unicode Animatio v0.0.4 packages deterministic animation frames and timing for terminals and other text renderers. It has no runtime dependencies and does not take ownership of colors, labels, layout, progress, or task state.

The distribution and CLI name is unicode-animatio. The Python import root is unicode_animations.

Read This First

1. Read At a Glance for the package naming and renderer boundary.
2. Follow Install and Quick Start to read animation frames from Python.
3. Use Choosing a Preset to select a category.
4. Use the terminal or browser preview commands before integrating a renderer.
5. Read Development before changing the package.

Trust and Brand Safety

• Official GitHub: https://github.com/openminion/unicode-animatio
• Official website: https://www.openminion.com
• Official X account: https://x.com/OpenMinion

Unicode Animatio has no official token, coin, NFT, airdrop, staking program, treasury product, or investment offering. Any claim otherwise is unauthorized and should be treated as a scam.

At a Glance

Common Commands

python3 -m pip install unicode-animatio
unicode-animatio --list
unicode-animatio --categories
unicode-animatio helix
unicode-animatio-web --port 8765

Install

Install from PyPI:

python3 -m pip install unicode-animatio

For a source checkout:

python3 -m pip install -e ".[dev]"

Quick Start

Read raw frames and timing:

from unicode_animations import spinners

spinner = spinners["braille"]
print(spinner.frames)
print(spinner.interval)

Use the provider boundary when the consumer should not depend on the catalog implementation:

from unicode_animations import get_provider

provider = get_provider()
animation = provider.get("helix")

print(provider.provider_id)
print(animation.frames)
print(animation.interval_ms)

Preview the catalog in a terminal:

unicode-animatio --list --category graph
unicode-animatio edgepulse

Preview it in a local browser:

unicode-animatio --web

What Unicode Animatio Provides

• immutable animation frame data and millisecond timing
• canonical animation names, categories, and category lookup
• braille-grid helpers: make_grid and grid_to_braille
• compatibility aliases: makeGrid and gridToBraille
• a structural provider entry point for host applications
• a terminal preview CLI: unicode-animatio
• a local browser preview CLI: unicode-animatio-web
• a PEP 561 type marker and typed public API

What Unicode Animatio Does Not Provide

• terminal UI or async rendering frameworks
• progress bars, task orchestration, or job-state tracking
• renderer colors, backgrounds, labels, or layout
• automatic reduced-motion or accessibility policy
• hosted demos or remote APIs
• framework-specific Rich, Textual, or Typer adapters

The host renderer owns presentation and accessibility. The package returns raw frames and timing only.

Available animations

The catalog currently contains 58 deterministic animations:

Choosing a Preset

Inspect exact names and timing rather than selecting from memory:

unicode-animatio --categories
unicode-animatio --list --category data
unicode-animatio packetflow

Development

make dev-install
make hooks-install
make check

Use make release-check before publishing or changing the documented public surface.

Docs and Release

• docs/README.md: package documentation map
• docs/getting-started.md: package usage and contributor bootstrap
• docs/source-tree-owner-map.md: code owners and package layout
• API_COMPATIBILITY.md: public names and provider contract
• RELEASING.md: release and publish flow

Questions and bug reports belong in GitHub Issues.

License and Brand-use Boundary

• Source code license: MIT
• Brand/trademark grant: none

The license grants rights to use, modify, and redistribute the code. It does not grant rights to present a fork, clone, token, website, or social account as the official Unicode Animatio or OpenMinion project or imply affiliation or endorsement.