spin - CLI Spinner

spin is a command line (CLI) tool written in C++ that displays an animated spinner while a background process is running. It is useful for visually indicating that a task is in progress, especially if the task takes a considerable amount of time.

Install

• Manual

git clone https://github.com/VictorH028/spin && cd  spin

make build-bin

• this apt

wget -P $PREFIX/etc/apt/sources.list.d  https://raw.githubusercontent.com/VictorH028/victorh028.github.io/refs/heads/main/key/demon-termux-packages.list

apt update

apt install spin

Usage

Command line:

Usage: spin [options]

Options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -t TEXT, --text=TEXT  Text to show
  -i INT, --interval=INT
                        Interval in milliseconds
  -s NAME, --style=NAME
                        Style the spinner
  --cmd=COMMAND         Command to execute
  -c COLOR, --color=COLOR
                        Change text color
  -q, --quiet           Run quietly, suppressing output

  Information:
    To show information

    --show_colors       Show list colors
    --show_style        Show list the symbols

It also has an integrated manual. man spin

Note

Predefined Symbol

circleHalves: ◐◓◑◒

Example

Show a spinner with custom text:

spin -t "Loading..." --cmd "sleep 3"

echo "Hola mundo" | spin -t 

The option --cmd has parallel execution

spin -c 230 --cmd "sleep 10, sleep 15, sleep 20"

⊨ ps af                                                         ~
  PID TTY      STAT   TIME COMMAND
20312 pts/0    S<sl   0:00 /data/data/com.termux/files/usr/bin/fis
20410 pts/0    T<l    0:00  \_ spin -cmd sleep 10, sleep 20
20414 pts/0    T<     0:00  |   \_ sleep 10
20415 pts/0    T<     0:00  |   \_ sleep 20

Usage for

_pkgs=("pkg1" "pkg2" "pkg3")
spin -cmd '$(for package in "${_pkgs[@]}"; do
    echo "pkg install -y $package;"
done)'

Programming

Use as python module:

• Requirement

pip install pybind11

• Compilation

make build-python

Example

import spinners
import time

# Create a Spinner object
s = spinners.Spinner()

# Set.textnand)symbols 
s.set_color("105")
s.set_text("Cargando...")
s.set_symbols("dots")

#Start and stop the spinner
s.start()
time.sleep(5)
s.stop()

Use in C++

#include "spinners.hpp"

int main (int argc, char *argv[]) {
    spinners::Spinner spinner;
    spinner.setColor(105);
    spinner.setText("Loading..");
    spinner.setSymbols("dots");

    spinner.start();
    sleep(5);
    spinner.stop();
    return 0;
}

Note

Project ideas obtained from ora

Contribute

If you would like to contribute to this project, please fork the repository and submit a pull request.

Reference

• ANSI Escape Sequences
• optparce