Spinners - 🛎 60+ Elegant terminal spinners for Rust

May 2, 2026 · View on GitHub

Sponsors

France-Nuage _{Sovereign French cloud for the CLIs you ship. Re-internalisable infra.}	Hook0 _{Add webhook delivery to your CLI's backend. Self-hosted, retries done.}	Natalia _{Spinning while users wait? Natalia answers their calls 24/7 meanwhile.}	Netir _{Hire vetted French freelance CLI authors or join the marketplace.}
NoBullshitConseil _{Tech advisory without the bullshit. Straight talk for founders.}	Qualneo _{Qualiopi LMS for French trainers — friendly nod from a CLI builder.}	Recapro _{Sovereign AI for meeting notes. Less spinner, more shipped reports.}

Interested in sponsoring? Get in touch

200083093-cf48fcab-d95c-4a59-ac66-6e167dd33e7e

Usage

use spinners::{Spinner, Spinners};
use std::thread::sleep;
use std::time::Duration;

fn main() {
    let mut sp = Spinner::new(Spinners::Dots9, "Waiting for 3 seconds".into());
    sleep(Duration::from_secs(3));
    sp.stop();
}

Example

cargo run --example cycle

cargo run --example simple

Enables native terminal progress bar support via the ConEmu OSC 9;4 protocol. Terminals like Ghostty, Windows Terminal, iTerm2, Kitty, and WezTerm render these as GUI progress bars in the title/tab bar. Unsupported terminals silently ignore the sequences.

[dependencies]
spinners = { version = "4.1.0", features = ["osc-progress"] }

The progress bar is emitted as an indeterminate/pulsing indicator while the spinner is active, and cleared when the spinner is stopped or dropped. Sequences are only emitted when the output stream is a terminal, so piped output is unaffected.

Signal handling caveat: If the process is killed abruptly (e.g. SIGINT via Ctrl+C, SIGKILL), the Drop implementation may not run and the progress bar won't be cleared. Terminals like Ghostty mitigate this with a ~15-second auto-clear timeout, but for immediate cleanup, applications should install their own signal handler that stops the spinner (e.g. by dropping it or calling .stop()) before exiting.

Spinners - 🛎 60+ Elegant terminal spinners for Rust

Sponsors

Install

Usage

Example

Feature flags

`osc-progress`

License