st-custom-static

Drop-in replacements for Streamlit's default loading animation. Swap out the running man with one of 13 polished alternatives in seconds.

Install

pip install st-custom-static
st-install --icon italic-h-sweep

Streamlit's version is auto-detected. Restart any running apps to apply the change.

Restore the original

st-install --restore

Available icons

Name	Preview
italic-h-sweep
italic-h-striped
italic-h-wave
italic-h-scan
italic-h-sequential
italic-h-cascade
three-dots
bar-chart
progress-ring
spinning-sync
pulsing-dot
rotating-gear
hourglass

Supported Streamlit versions

1.45.1, 1.46.1, 1.47.1, 1.48.1, 1.49.1, 1.50.0, 1.51.0, 1.52.0, 1.53.1, 1.54.0, 1.55.0, 1.56.0, 1.57.0

Pin a specific version if auto-detection is wrong:

st-install --icon italic-h-sweep --version 1.57.0

Use in a project

Add to pyproject.toml or requirements.txt:

st-custom-static

Then run st-install --icon <name> once after pip install.

Manual build

Clone and build from source using the scripts in manual-build/.

How it works

Pre-built zips are published as GitHub Releases per version/icon combination. st-install downloads the matching zip, backs up Streamlit's original static/ folder, and replaces it with the custom build. The CI workflow in this repo rebuilds those zips automatically when icons or workflow config changes.