speedtest-cli

Run a speed test

$ speedtest-cli

Run a speed test and display values in bytes, instead of bits

$ speedtest-cli --bytes

Run a speed test using HTTPS, instead of HTTP

$ speedtest-cli --secure

Run a speed test without performing download tests

$ speedtest-cli --no-download

Run a speed test and generate an image of the results

$ speedtest-cli --share

List all speedtest.net servers, sorted by distance

$ speedtest-cli --list

Run a speed test to a specific speedtest.net server

$ speedtest-cli --server [server_id]

Run a speed test and display the results as JSON (suppresses progress information)

$ speedtest-cli --json

speedtest-cli [OPTION...]

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.

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

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

Please file issues on the Github bug tracker: https://github.com/sivel/speedtest-cli

This manual page was written by Jonathan Carter <jonathan@ubuntu.com> Speedtest-cli was written by Matt Martz <matt@sivel.net>