speedtest-cli

A nicer terminal front-end for Ookla's official speedtest CLI. It runs the real Ookla test (for accurate results) and renders live progress bars plus a formatted summary instead of Ookla's default output.

Requirements

Install Ookla's speedtest binary (the official one, not the Python speedtest-cli package — they aren't the same and produce different numbers):

# macOS
brew install speedtest --force

# Debian / Ubuntu
curl -s https://packagecloud.io/install/repositories/ookla/speedtest-cli/script.deb.sh | sudo bash
sudo apt-get install speedtest

# Other platforms: https://www.speedtest.net/apps/cli

Verify it's on your PATH:

speedtest --version

This wrapper is pure Python 3 with no extra dependencies.

Install

ln -s /path/to/run_speedtest.py ~/.local/bin/speedtest-cli

Usage

speedtest-cli                    # live progress + formatted summary
speedtest-cli --simple           # one-line summary
speedtest-cli --json             # compact JSON (download_mbps, upload_mbps, ping_ms, server fields)
speedtest-cli --raw-json         # Ookla's full raw JSON (jitter, packet loss, result URL, etc.)
speedtest-cli --server-id 1234   # pin a specific Ookla server
speedtest-cli --no-color         # disable ANSI colors

Example output

Speedtest by Ookla
  ISP   : Comcast
  Server: Chicago, IL, United States

  ● Ping       ████████████████████████████   14.32 ms
  ↓ Download   ████████████████████████████  245.31 Mbps
  ↑ Upload     ████████████████████████████   12.04 Mbps

────────────────────────────────────────────────────
  ↓ Download     245.31 Mbps
  ↑ Upload        12.04 Mbps
  ⚡ Latency      14.32 ms (jitter 0.84 ms)
  ⊘ Loss           0.00 %
────────────────────────────────────────────────────
  Server: Chicago, IL, United States
  ISP   : Comcast
  Result: https://www.speedtest.net/result/c/...