PHPackages                             alecrabbit/php-console-spinner - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. alecrabbit/php-console-spinner

ActiveLibrary[CLI & Console](/categories/cli)

alecrabbit/php-console-spinner
==============================

Extremely flexible spinner for \[async\] php cli applications

0.55.0(4y ago)24032.0k—0%15[5 PRs](https://github.com/alecrabbit/php-console-spinner/pulls)2MITPHPPHP >=7.2

Since Nov 18Pushed 2y ago4 watchersCompare

[ Source](https://github.com/alecrabbit/php-console-spinner)[ Packagist](https://packagist.org/packages/alecrabbit/php-console-spinner)[ Patreon](https://www.patreon.com/alecrabbit)[ RSS](/packages/alecrabbit-php-console-spinner/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (9)Versions (15)Used By (2)

 [![Logo](https://github.com/alecrabbit/php-console-spinner/raw/master/doc/image/logo/logo.png)](https://github.com/alecrabbit/php-console-spinner/raw/master/doc/image/logo/logo.png)

 ***Spinner - your task is running***

🇺🇦 🏵️ PHP Console Spinner
=========================

[](#-️-php-console-spinner)

[![demo](doc/image/demo/fpdemo.svg)](doc/image/demo/fpdemo.svg)

[![PHP Version](https://camo.githubusercontent.com/da101af3dd27f76f6b7dcf70b975ac9472276cd6d8789a4db2bd7d82cadcfaa2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f6465762d6d61737465722e737667)](https://php.net)[![Tests Status](https://github.com/alecrabbit/php-console-spinner/workflows/tests/badge.svg)](https://github.com/alecrabbit/php-console-spinner/actions)

[![Build Status](https://camo.githubusercontent.com/fb1390c3e2470445194af7a703c3564b676ec27fd0a34539a573ca5a0eb541cb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/alecrabbit/php-console-spinner/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/25b9d857308bfc9c7bc5e76089ce3e0199f19e1562da12b3b6fd3c767469495c/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/alecrabbit/php-console-spinner/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/cc3b152b074dcc5006a3e3d7c4c91e9979ae82cf6806a24719a3b8478ff74e46/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/alecrabbit/php-console-spinner/?branch=master)

[![Latest Stable Version](https://camo.githubusercontent.com/c587fc5b87284c7c07edb09720714d58963b2505d801f19552b8f2b78a64dff8/68747470733a2f2f706f7365722e707567782e6f72672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f762f737461626c65)](https://packagist.org/packages/alecrabbit/php-console-spinner)[![Packagist Pre Release Version](https://camo.githubusercontent.com/6a284cbba108c81c883cfd96774bbc2ee486b5b3ea25977faac3e436d44ae357/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f767072652f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e6572)](https://packagist.org/packages/alecrabbit/php-console-spinner)[![Latest Unstable Version](https://camo.githubusercontent.com/2af641afd58de7ed7f14af5b22e7de0d2469094aed7839c2315ebe1099b13e5b/68747470733a2f2f706f7365722e707567782e6f72672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f762f756e737461626c65)](https://packagist.org/packages/alecrabbit/php-console-spinner)

[![License](https://camo.githubusercontent.com/faff19f94c88fc7a11b10c100662260b6f3a5c11bcdb9376df7ef52c3e2a2342/68747470733a2f2f706f7365722e707567782e6f72672f616c65637261626269742f7068702d636f6e736f6c652d7370696e6e65722f6c6963656e7365)](https://packagist.org/packages/alecrabbit/php-console-spinner)

> Old version `0.55.0` is available in branch [0.55.x](https://github.com/alecrabbit/php-console-spinner/tree/0.55.x)

### New version 1.0.0

[](#new-version-100)

> - ‼️ ATTENTION ‼️ Documentation is a bit clumsy at the moment and CAN BE MISLEADING

> - WIP
> - ‼️ API is subject to change until `1.0.0-BETA.0`
> - is intended to be used with event loop (see [limitations](doc/limitations.md))

- [Installation](#installation)
- [Quick start](#quickstart)
- [Why?](#why)
- [How does it work?](doc/how_does_it_work.md)
- [Usage](doc/usage.md)
- [Features](#features)
- [Known issues](doc/known_issues.md)
- [Development](doc/development.md)
- [Links](#links)

###  Installation

[](#-installation)

```
composer require alecrabbit/php-console-spinner
```

###  Quick start (asynchronous)

[](#-quick-start-asynchronous)

```
use AlecRabbit\Spinner\Facade;
// ...
$spinner = Facade::createSpinner();

// that's basically it :)
```

> Fully working examples can be found in [example](example) directory

> For more information see [Usage](doc/usage.md)

### Why?

[](#why)

Main purpose of this library is to provide a simple way to show spinner in console applications (mainly long-running ones). Spinner could be an indicator of running task. For more information see [Features](doc/features.md) and [Examples](example).

[alecrabbit/php-console-spinner-extras](https://github.com/alecrabbit/php-console-spinner-extras)library provides additional components to extend functionality:

- show progress of running task
- messages of some sort, like status messages
- additional spinners

###  Features

[](#-features)

> See [Features](doc/features.md) and [limitations](./doc/limitations.md) for more details

FeatureExtremely flexible🟢️ ️"Zero" dependencies ️🟢️ [\*](doc/limitations.md)Asynchronous🟢️ ️Synchronous🟢️ ️AutoStart (async)🟢️ ️Signal handling (async)🟢️ ️Cursor auto hide/show🟢️ ️### "Zero" dependencies

[](#zero-dependencies)

"Zero" dependencies mode means that the library does not require any additional dependencies to work. The only exception is `psr/container`. That's why zero is in quotes.

```
    "require": {
        "php": ">=8.2",
        "psr/container": "^2.0"
    },
```

###  Links

[](#-links)

- Inspired by [sindresorhus/cli-spinners](https://github.com/sindresorhus/cli-spinners)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity47

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~168 days

Recently: every ~159 days

Total

6

Last Release

802d ago

Major Versions

0.55.x-dev → 1.0.0-ALPHA.5+BUILD.02023-10-13

PHP version history (2 changes)0.55.0PHP >=7.2

1.0.0-ALPHA.5+BUILD.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/fd47373a86071491b154326d2437fb6fb444ec02d87d22d7d203f67e1de6e5b5?d=identicon)[alecrabbit](/maintainers/alecrabbit)

---

Top Contributors

[![alecrabbit](https://avatars.githubusercontent.com/u/11045453?v=4)](https://github.com/alecrabbit "alecrabbit (3564 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (4 commits)")[![damienlagae](https://avatars.githubusercontent.com/u/2233003?v=4)](https://github.com/damienlagae "damienlagae (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

asyncasynchronousclicolorconsolepercentagephpreactphprevoltspinnerterminalxtermxterm256phpcliconsoleclockshellcolormoonprettyansispinnersnakescriptsbashcolorful8bit256colorArrow

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alecrabbit-php-console-spinner/health.svg)

```
[![Health](https://phpackages.com/badges/alecrabbit-php-console-spinner/health.svg)](https://phpackages.com/packages/alecrabbit-php-console-spinner)
```

###  Alternatives

[alecrabbit/php-cli-snake

Lightweight cli spinner with zero dependencies

29211.3k5](/packages/alecrabbit-php-cli-snake)[seregazhuk/php-watcher

Automatically restart PHP application once the source code changes

394137.8k4](/packages/seregazhuk-php-watcher)[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind

It's like Tailwind CSS, but for the console.

2.5k239.8M286](/packages/nunomaduro-termwind)[kevinlebrun/colors.php

Colors for PHP CLI scripts

3426.7M45](/packages/kevinlebrun-colorsphp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)