speedtest-cli
speedtest-cli
TLDR
Run a speed test
Run a speed test and display values in bytes, instead of bits
Run a speed test using HTTPS, instead of HTTP
Run a speed test without performing download tests
Run a speed test and generate an image of the results
List all speedtest.net servers, sorted by distance
Run a speed test to a specific speedtest.net server
Run a speed test and display the results as JSON (suppresses progress information)
SYNOPSIS
speedtest-cli [OPTION...]
DESCRIPTION
Speedtest.net is a web service for testing your broadband connection by downloading a file from a nearby speedtest.net server on the web. This tool allows you to access the service from the command line.
Speedtest mini is a version of the Speedtest.net server that you can host locally.
OPTIONS
Usage: speedtest-cli [OPTION...]
Help Options
-h, --help
Displays usage for the tool.
Options
--no-download
Do not perform download test
--no-upload
Do not perform upload test
--single
Only use a single connection instead of multiple. This simulates a typical file transfer.
--bytes
Display values in bytes instead of bits. Does not affect the image generated by --share, nor output from --json or --csv
--share
Generate and provide a URL to the speedtest.net share results image, not displayed with --csv
--simple
Suppress verbose output, only show basic information
--csv
Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s and not affected by --bytes
--csv-delimiter CSV_DELIMITER
Single character delimiter to use in CSV output. Default ","
--csv-header
Print CSV headers
--json
Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s and not affected by --bytes
--list
Display a list of speedtest.net servers sorted by distance
--server SERVER
Specify a server ID to test against. Can be supplied multiple times
--exclude EXCLUDE
Exclude a server from selection. Can be supplied multiple times
--mini MINI
URL of the Speedtest Mini server
--source SOURCE
Source IP address to bind to
--timeout TIMEOUT
HTTP timeout in seconds. Default 10
--secure
Use HTTPS instead of HTTP when communicating with speedtest.net operated servers
--no-pre-allocate
Do not pre allocate upload data. Pre allocation is enabled by default to improve upload performance. To support systems with insufficient memory, use this option to avoid a MemoryError
--version
Show the version number and exit
EXAMPLES
Automatically find closest server and start testing
speedtest-cli
Specify testing against server 1491
speedtest-cli --server 1491
Testing against Speedtest Mini
speedtest-cli --mini 172.18.66.1
REPORTING BUGS
Please file issues on the Github bug tracker: https://github.com/sivel/speedtest-cli
AUTHORS
This manual page was written by Jonathan Carter <jonathan@ubuntu.com> Speedtest-cli was written by Matt Martz <matt@sivel.net>