# speedtest-cli
> Command line interface for testing internet bandwidth using speedtest.net

> **ARCHIVED**: This tool's repository has been archived and is no longer actively maintained.

## Summary
Test internet download speed, upload speed, and latency from the command line using speedtest.net servers.

## Capabilities
- Measure download and upload speeds
- Test latency to speedtest.net servers
- Output results in simple text, CSV, or JSON format
- Select specific test servers or exclude servers
- Run download-only or upload-only tests
- Generate shareable result images via --share flag
- Use as a Python API for programmatic speed testing

## When to Use
- When you need to quickly test internet connection speed from the terminal
- When automating bandwidth monitoring in scripts
- When you need speed test results in JSON or CSV for processing

## When NOT to Use
- When you need continuous network monitoring over time
- When you need ICMP-style latency measurements (use ping)
- When you want the latest Ookla speedtest features (use the official Ookla CLI instead)

## Usage Patterns
### Run a basic speed test
```
speedtest-cli
```
Runs a full download and upload speed test against the nearest server

### Simple output
```
speedtest-cli --simple
```
Shows just ping, download, and upload numbers

### JSON output for scripting
```
speedtest-cli --json
```
Outputs results as JSON for use in scripts or pipelines

### List available servers
```
speedtest-cli --list
```
Lists all available speedtest.net servers sorted by distance

## Installation
- **pip**: `pip install speedtest-cli`
- **homebrew**: `brew install speedtest-cli`

## Related Tools
- [speedtest-net](/tools/speedtest-net) (alternative): speedtest-net is a JavaScript-based alternative

---
Source: https://littlescripts.sh/tools/speedtest-cli