speedtest

Test internet bandwidth using https://www.speedtest.net.

TLDR

Run a speed test

$ speedtest

Run a speed test and specify the unit of the output

$ speedtest --unit=[auto-decimal-bits|auto-decimal-bytes|auto-binary-bits|auto-binary-bytes]

Run a speed test and specify the output format

Run a speed test and specify the number of decimal points to use (0 to 8, defaults to 2)

$ speedtest --precision=[precision]

Run a speed test and print its progress (only available for output format human-readable and json)

$ speedtest --progress=[yes|no]

List all speedtest.net servers, sorted by distance

$ speedtest --servers

Run a speed test to a specific speedtest.net server

$ speedtest --server-id=[server_id]

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>