2018-02-05 23:16:51 +01:00
.TH "speedtest-cli" 1 "2018-01-05" "speedtest-cli"
2014-01-26 14:48:48 +01:00
.SH NAME
2016-09-13 16:02:29 +02:00
speedtest\- cli \- Command line interface for testing internet bandwidth using speedtest.net
2014-01-26 14:48:48 +01:00
.SH SYNOPSIS
2014-02-10 21:24:43 +01:00
.B speedtest\-cli
2016-09-13 16:02:29 +02:00
[OPTION...]
2014-01-26 14:48:48 +01:00
.SH 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.
.SH OPTIONS
2014-02-10 21:24:43 +01:00
Usage: speedtest\- cli [OPTION...]
2014-01-26 14:48:48 +01:00
.B Help Options
2014-02-10 21:24:43 +01:00
\fB \- h, \- \- help\fR
2014-01-26 14:48:48 +01:00
.RS
Displays usage for the tool.
.RE
.B Options
2018-02-05 23:16:51 +01:00
\fB \- \- no\- download\fR
.RS
Do not perform download test
.RE
\fB \- \- no\- upload\fR
.RS
Do not perform upload test
.RE
2019-03-11 15:57:19 +01:00
\fB \- \- single\fR
.RS
Only use a single connection instead of multiple. This simulates a typical file transfer.
.RE
2014-04-23 18:52:26 +02:00
\fB \- \- bytes\fR
.RS
2018-02-05 23:16:51 +01:00
Display values in bytes instead of bits. Does not affect the image generated by \- \- share, nor output from \- \- json or \- \- csv
2014-04-23 18:52:26 +02:00
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- share\fR
2014-01-26 14:48:48 +01:00
.RS
2018-02-05 23:16:51 +01:00
Generate and provide a URL to the speedtest.net share results image, not displayed with \- \- csv
2014-01-26 14:48:48 +01:00
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- simple\fR
2014-01-26 14:48:48 +01:00
.RS
Suppress verbose output, only show basic information
.RE
2016-09-13 16:02:29 +02:00
\fB \- \- csv\fR
.RS
Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s and not affected by \- \- bytes
.RE
2018-02-05 23:16:51 +01:00
\fB \- \- csv\- delimiter CSV_DELIMITER\fR
2016-09-13 16:02:29 +02:00
.RS
Single character delimiter to use in CSV output. Default ","
.RE
2018-02-05 23:16:51 +01:00
\fB \- \- csv\- header\fR
2016-09-13 16:02:29 +02:00
.RS
Print CSV headers
.RE
\fB \- \- json\fR
.RS
Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s and not affected by \- \- bytes
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- list\fR
2014-01-26 14:48:48 +01:00
.RS
Display a list of speedtest.net servers sorted by distance
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- server SERVER\fR
2014-01-26 14:48:48 +01:00
.RS
2018-02-05 23:16:51 +01:00
Specify a server ID to test against. Can be supplied multiple times
.RE
\fB \- \- exclude EXCLUDE\fR
.RS
Exclude a server from selection. Can be supplied multiple times
2014-01-26 14:48:48 +01:00
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- mini MINI\fR
2014-01-26 14:48:48 +01:00
.RS
URL of the Speedtest Mini server
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- source SOURCE\fR
2014-01-26 14:48:48 +01:00
.RS
Source IP address to bind to
.RE
2016-09-13 16:02:29 +02:00
\fB \- \- timeout TIMEOUT\fR
.RS
HTTP timeout in seconds. Default 10
.RE
\fB \- \- secure\fR
.RS
Use HTTPS instead of HTTP when communicating with speedtest.net operated servers
.RE
2018-02-05 23:16:51 +01:00
\fB \- \- no\- pre\- allocate\fR
.RS
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
.RE
2014-02-10 21:24:43 +01:00
\fB \- \- version\fR
2014-01-26 14:48:48 +01:00
.RS
Show the version number and exit
.RE
.SH EXAMPLES
\fB Automatically find closest server and start testing\fR
.RS
2014-02-10 21:24:43 +01:00
speedtest\- cli
2014-01-26 14:48:48 +01:00
.RE
\fB Specify testing against server 1491\fR
.RS
2014-02-10 21:24:43 +01:00
speedtest-cli \- \- server 1491
2014-01-26 14:48:48 +01:00
.RE
\fB Testing against Speedtest Mini\fR
.RS
2014-02-10 21:24:43 +01:00
speedtest-cli \- \- mini 172.18.66.1
2014-01-26 14:48:48 +01:00
.RE
.SH REPORTING BUGS
2014-02-10 21:24:43 +01:00
Please file issues on the Github bug tracker: https://github.com/sivel/speedtest\- cli
2014-01-26 14:48:48 +01:00
.SH AUTHORS
This manual page was written by Jonathan Carter <jonathan@ubuntu.com>
2014-02-10 21:24:43 +01:00
Speedtest\- cli was written by Matt Martz <matt@sivel.net>