unicode-animatio

Lightweight Unicode braille spinner animations for Python.

GitHub · Install · What Ships · Website · X

• 18 spinner families as raw frame data
• typed Python API with JS-style compatibility aliases
• built-in terminal preview CLI and local browser demo
• no runtime dependencies

unicode-animatio is the public package and repo name. The Python import root remains unicode_animations, while the public CLI entrypoints use unicode-animatio and unicode-animatio-web.

Official project links

• GitHub: https://github.com/openminion/unicode-animatio
• Issues: https://github.com/openminion/unicode-animatio/issues

What the package provides

unicode-animatio provides:

• immutable spinner frame data via unicode_animations.spinners
• braille-grid helpers: make_grid and grid_to_braille
• compatibility aliases: makeGrid and gridToBraille
• a terminal preview CLI: unicode-animatio
• a local web preview CLI: unicode-animatio-web

What the package does not provide

This package does not provide:

• async terminal rendering frameworks
• progress bars, task orchestration, or job-state tracking
• hosted demo infrastructure or remote APIs
• framework-specific adapters for Rich, Textual, or Typer

Install

Install from PyPI:

python3 -m pip install unicode-animatio

Editable install during local development:

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

Quick start

from unicode_animations import spinners

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

Grid helpers:

from unicode_animations import grid_to_braille, make_grid

grid = make_grid(4, 4)
grid[0][0] = True
grid[1][1] = True
grid[2][2] = True
grid[3][3] = True

print(grid_to_braille(grid))

CLI and demos

Terminal preview:

unicode-animatio --list
unicode-animatio
unicode-animatio helix

Local browser demo:

unicode-animatio --web
unicode-animatio-web --port 8765
unicode-animatio-web --host 0.0.0.0 --port 8765 --no-open

Python API terminal demo:

python examples/terminal_demo.py
python examples/terminal_demo.py --seconds-per-spinner 2 --loops 2
python examples/terminal_demo.py helix
python examples/terminal_demo.py --list

Available animations

The package currently ships these braille spinner families. The preview glyph is the first frame from each animation:

For a live preview:

unicode-animatio --list
unicode-animatio helix
unicode-animatio --web

Development

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e ".[dev]"
python3 -m pytest -q
python3 -m ruff check .
python3 -m build

Package docs

• Getting started
• Package docs index
• API compatibility
• Release guide
• Source tree owner map

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.

License and brand-use boundary

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

The software license grants rights to use, modify, and redistribute the code. It does not grant rights to use the unicode-animatio or OpenMinion names, logos, branding, website identity, or social identity except for truthful attribution. Forks, clones, and derivative distributions must not present themselves as the official unicode-animatio package or imply affiliation, endorsement, or maintenance by unicode-animatio or OpenMinion contributors unless that is actually true.

Community

• Contributing
• Code of Conduct
• License (MIT)