Spinner Reference
Complete reference of all 109 available spinners
All 109 spinners with their names, frame counts, and animation speed. Use any name in the spinner option.
Note on Emoji Rendering: Some spinners include emoji characters (🌍, 🕛, etc.). These may render differently depending on your terminal, font, and operating system. If emoji spinners don't display properly, use spinners like
dots,line,breathe, orhelixinstead.
Braille Animations
Fast-moving Unicode braille character animations, perfect for smooth visual feedback.
| Name | Frames | Speed | Preview |
|---|---|---|---|
breathe | 17 | 100ms | ⠀ ⠂ ⠌ ⡑ ⢕ |
cascade | 13 | 60ms | ⠀⠀⠀⠀ ⠁⠀⠀⠀ ⠋⠀⠀⠀ |
checkerboard | 4 | 250ms | ⢕⢕⢕ ⡪⡪⡪ ⢊⠔⡡ |
columns | 26 | 60ms | ⡀⠀⠀ ⡄⠀⠀ ⡆⠀⠀ |
diagSwipe | 16 | 60ms | ⠁⠀ ⠋⠀ ⠟⠁ |
dna | 12 | 80ms | ⠋⠉⠙⠚ ⠉⠙⠚⠒ |
fillSweep | 11 | 100ms | ⣀⣀ ⣤⣤ ⣶⣶ |
helix | 16 | 80ms | ⢌⣉⢎⣉ ⣉⡱⣉⡱ |
infinity | 32 | 60ms | ⢎⡱⣉⠆ ⢎⡱⣈⠆ |
orbit | 8 | 100ms | ⠃ ⠉ ⠘ ⠰ |
pulse | 5 | 180ms | ⠀⠶⠀ ⠰⣿⠆ |
rain | 12 | 100ms | ⢁⠂⠔⠈ ⠂⠌⡠⠐ |
scan | 10 | 70ms | ⠀⠀⠀⠀ ⡇⠀⠀⠀ |
scanline | 6 | 120ms | ⠉⠉⠉ ⠓⠓⠓ |
snake | 16 | 80ms | ⣁⡀ ⣉⠀ ⡉⠁ |
sparkle | 6 | 150ms | ⡡⠊⢔⠡ ⠊⡰⡡⡘ |
wave | 8 | 100ms | ⠁⠂⠄⡀ ⠂⠄⡀⢀ |
waveRows | 16 | 90ms | ⠖⠉⠉⠑ ⡠⠖⠉⠉ |
Dots & Lines
Classic dot sequences and simple line animations.
| Name | Frames | Speed | Preview |
| --------------------- | ------ | ----- | -------- | --- |
| dots | 10 | 80ms | ⠋ ⠙ ⠹ ⠸ |
| dots2 | 8 | 80ms | ⣾ ⣽ ⣻ ⣟ |
| dots3 | 10 | 80ms | ⠋ ⠙ ⠚ ⠞ |
| dots4 | 14 | 80ms | ⠄ ⠆ ⠇ ⠋ |
| dots5 | 17 | 80ms | ⠋ ⠙ ⠚ ⠞ |
| dots6 | 24 | 80ms | ⠁ ⠉ ⠙ ⠚ |
| dots7 | 24 | 80ms | ⠈ ⠉ ⠋ ⠓ |
| dots8 | 29 | 80ms | ⠁ ⠁ ⠉ ⠙ |
| dots8Bit | 256 | 80ms | ⠀ ⠁ ⠂ ⠃ |
| dots9 | 8 | 80ms | ⢹ ⢺ ⢼ ⣸ |
| dots10 | 7 | 80ms | ⢄ ⢂ ⢁ ⡁ |
| dots11 | 8 | 100ms | ⠁ ⠂ ⠄ ⡀ |
| dots12 | 56 | 80ms | ⢀⠀ ⡀⠀ ⠄⠀ |
| dots13 | 8 | 80ms | ⣼ ⣹ ⢻ ⠿ |
| dots14 | 12 | 80ms | ⠉⠉ ⠈⠙ ⠀⠹ |
| dotsCircle | 8 | 80ms | ⢎ ⠎⠁ ⠊⠑ |
| line | 4 | 130ms | - \ | / |
| line2 | 6 | 100ms | ⠂ - – |
| simpleDots | 4 | 400ms | . .. ... |
| simpleDotsScrolling | 6 | 200ms | . .. ... |
Arrows & Directions
Animations showing direction and movement.
| Name | Frames | Speed | Preview |
|---|---|---|---|
arrow | 8 | 100ms | ← ↖ ↑ ↗ |
arrow2 | 8 | 80ms | ⬆️ ↗️ ➡️ ↘️ |
arrow3 | 6 | 120ms | ▹▹▹▹▹ ▸▹▹▹▹ |
doubleArrow | 8 | 100ms | ⇐ ⇖ ⇑ ⇗ |
Shapes & Boxes
Box and circle animations.
| Name | Frames | Speed | Preview |
|---|---|---|---|
arc | 6 | 100ms | ◜ ◠ ◝ ◞ |
bouncingBar | 16 | 80ms | [ ] [= ] [== ] |
bouncingBall | 10 | 80ms | ( ● ) ( ● ) |
boxBounce | 4 | 120ms | ▖ ▘ ▝ ▗ |
boxBounce2 | 4 | 100ms | ▌ ▀ ▐ ▄ |
bounce | 4 | 120ms | ⠁ ⠂ ⠄ ⠂ |
circle | 3 | 120ms | ◡ ⊙ ◠ |
circleHalves | 4 | 50ms | ◐ ◓ ◑ ◒ |
circleQuarters | 4 | 120ms | ◴ ◷ ◶ ◵ |
circleQuartersNegative | 4 | 120ms | ◵ ◶ ◷ ◴ |
circleQuartersNegativeAlt | 4 | 120ms | ◶ ◷ ◴ ◵ |
growHorizontal | 12 | 120ms | ▏ ▎ ▍ ▌ |
growVertical | 10 | 120ms | ▁ ▃ ▄ ▅ |
hamburger | 3 | 100ms | ☱ ☲ ☴ |
point | 5 | 125ms | ∙∙∙ ●∙∙ ∙●∙ |
squareCorners | 4 | 180ms | ◰ ◳ ◲ ◱ |
triangle | 4 | 50ms | ◢ ◣ ◤ ◥ |
Toggles & Effects
Simple toggle switches and visual effects.
| Name | Frames | Speed | Preview |
|---|---|---|---|
toggle | 2 | 250ms | ⊶ ⊷ |
toggle2 | 2 | 80ms | ▫ ▪ |
toggle3 | 2 | 120ms | □ ■ |
toggle4 | 4 | 100ms | ■ □ ▪ ▫ |
toggle5 | 2 | 100ms | ▮ ▯ |
toggle6 | 2 | 300ms | ဝ ၀ |
toggle7 | 2 | 80ms | ⦾ ⦿ |
toggle8 | 2 | 100ms | ◍ ◌ |
toggle9 | 2 | 100ms | ◉ ◎ |
toggle10 | 3 | 100ms | ㊂ ㊀ ㊁ |
toggle11 | 2 | 50ms | ⧇ ⧆ |
toggle12 | 2 | 120ms | ☗ ☖ |
toggle13 | 3 | 80ms | = * - |
Creative & Complex
Complex animations and special effects.
| Name | Frames | Speed | Preview |
| ----------------- | ------ | ----- | ----------------- | --- |
| aesthetic | 8 | 80ms | ▰▱▱▱▱▱▱ ▰▰▱▱▱▱▱ |
| balloon | 7 | 140ms | (space) . o |
| bluePulse | 5 | 100ms | 🔹 🔷 🔵 |
| balloon2 | 7 | 120ms | . o O ° |
| betaWave | 7 | 80ms | ρββββββ βρβββββ |
| binary | 10 | 80ms | 010010 001100 |
| christmas | 2 | 400ms | 🌲 🎄 |
| dqpb | 4 | 100ms | d q p b |
| dwarfFortress | 133 | 80ms | Complex ASCII |
| fillSweep | 11 | 100ms | ⣀⣀ ⣤⣤ ⣶⣶ |
| fish | 27 | 80ms | ASCII fish |
| flip | 12 | 70ms | _ / ‾ |
| hearts | 5 | 100ms | 💛 💙 💜 |
| layer | 3 | 150ms | - = ≡ |
| material | 92 | 17ms | ███ progress bars |
| mindblown | 14 | 160ms | 😐 😮 💥 |
| noise | 3 | 100ms | ▓ ▒ ░ |
| orangeBluePulse | 10 | 100ms | 🔸 🔶 🟠 |
| orangePulse | 5 | 100ms | 🔸 🔶 🟠 |
| pipe | 8 | 100ms | ┤ ┘ ┴ └ |
| pong | 30 | 80ms | Pong game |
| rollingLine | 8 | 80ms | / - \ | |
| sand | 35 | 80ms | ⠁ ⠂ ⠄ ⡀ |
| shark | 26 | 120ms | ASCII shark |
| smiley | 2 | 200ms | 😄 😝 |
| soccerHeader | 12 | 80ms | ⚽ 🧑 |
| speaker | 4 | 160ms | 🔈 🔉 🔊 |
| squish | 2 | 100ms | ╫ ╪ |
| star | 6 | 70ms | ✶ ✸ ✹ ✺ |
| star2 | 3 | 80ms | + x * |
| timeTravel | 12 | 100ms | 🕛 🕧 🕐 |
| weather | 23 | 100ms | ☀️ ⛅ ☁️ 🌧 |
Earth & Space
Earth and space-themed animations.
| Name | Frames | Speed | Preview |
|---|---|---|---|
clock | 12 | 100ms | 🕛 🕐 🕑 |
earth | 3 | 180ms | 🌍 🌎 🌏 |
moon | 8 | 80ms | 🌑 🌒 🌓 |
Interaction
Special interaction animations.
| Name | Frames | Speed | Preview |
|---|---|---|---|
fingerDance | 6 | 160ms | 🤘 🤟 🖖 |
fistBump | 7 | 80ms | 🤜 👊 🤛 |
grenade | 14 | 80ms | ، ′ ´ |
monkey | 4 | 300ms | 🙈 🙈 🙉 |
runner | 2 | 140ms | 🚶 🏃 |
Usage
Use any spinner name with the Spinner class:
import { Spinner } from "@visulima/spinner";
const spinner = new Spinner({
spinner: "breathe", // Use any name from above
text: "Loading...",
});
spinner.start();Get a random spinner:
import { getRandomSpinner } from "@visulima/spinner";
const spinner = getRandomSpinner();For more examples and patterns, see the Usage Guide.
Sources
The spinners are sourced from three excellent open-source projects (all MIT licensed):
- cli-spinners by Sindre Sorhus
- Rattles by vyfor
- unicode-animations by gunnar gray