Command Line Interface and pure Go API to Test Internet Speed using speedtest.net.
You can speedtest 2x faster than speedtest.net with almost the same result. See the experimental results. Inspired by sivel/speedtest-cli
Go API Installation below.
$ brew tap showwin/speedtest
$ brew install speedtest
### How to Update ###
$ brew update
$ brew upgrade speedtest
Please download the compatible package from Releases. If there are no compatible packages you want, please let me know on Issue Tracker.
$ speedtest --help
usage: speedtest-go [<flags>]
Flags:
--help Show context-sensitive help (also try --help-long and --help-man).
-l, --list Show available speedtest.net servers.
-s, --server=SERVER ... Select server id to speedtest.
--custom-url=CUSTOM-URL Specify the url of the server instead of getting a list from speedtest.net.
--saving-mode Test with few resources, though low accuracy (especially > 30Mbps).
--json Output results in json format.
--location=LOCATION Change the location with a precise coordinate.
--city=CITY Change the location with a predefined city label.
--city-list List all predefined city labels.
--proxy=PROXY Set a proxy(http[s] or socks) for the speedtest.
eg: --proxy=socks://10.20.0.101:7890
eg: --proxy=http://10.20.0.101:7890
--source=SOURCE Bind a source interface for the speedtest.
eg: --source=10.20.0.101
-m --multi Enable multi-server mode.
-t --thread=THREAD Set the number of concurrent connections.
--search=SEARCH Fuzzy search servers by a keyword.
--no-download Disable download test.
--no-upload Disable upload test.
-d --debug Enable debug mode.
--version Show application version.
Simply use speedtest
command. The closest server is selected by default. Use the -m
flag to enable multi-measurement mode (recommended)
$ speedtest
Testing From IP: 124.27.199.165 (Fujitsu) [34.9769, 138.3831]
Target Server: [6691] 9.03km Shizuoka (Japan) by sudosan
Latency: 24.15396ms
Jitter: 777.465µs
Min: 22.8926ms
Max: 25.5387ms
Download Test: ................
Upload Test: ................
Download: 73.30 Mbit/s
Upload: 35.26 Mbit/s
If you want to select other servers to test, you can see the available server list.
$ speedtest --list
Testing From IP: 124.27.199.165 (Fujitsu) [34.9769, 138.3831]
[6691] 9.03km 32.3365ms Shizuoka (Japan) by sudosan
[6087] 120.55km 51.7453ms Fussa-shi (Japan) by Allied Telesis Capital Corporation
[6508] 125.44km 54.6683ms Yokohama (Japan) by at2wn
[6424] 148.23km 61.4724ms Tokyo (Japan) by Cordeos Corp.
...
and select them by id.
$ speedtest --server 6691 --server 6087
Testing From IP: 124.27.199.165 (Fujitsu) [34.9769, 138.3831]
Target Server: [6691] 9.03km Shizuoka (Japan) by sudosan
Latency: 21.424ms
Jitter: 1.644ms
Min: 19.142ms
Max: 23.926ms
Download Test: ................
Upload Test: ........
Target Server: [6087] 120.55km Fussa-shi (Japan) by Allied Telesis Capital Corporation
Latency: 38.694699ms
Jitter: 2.724ms
Min: 36.443ms
Max: 39.953ms
Download Test: ................
Upload Test: ................
[6691] Download: 65.82 Mbit/s, Upload: 27.00 Mbit/s
[6087] Download: 72.24 Mbit/s, Upload: 29.56 Mbit/s
Download Avg: 69.03 Mbit/s
Upload Avg: 28.28 Mbit/s
With --city
or --location
option, the closest servers of the location will be picked.
You can measure the speed between your location and the target location.
$ speedtest --city-list
Available city labels (case insensitive):
CC CityLabel Location
(za) capetown [-33.9391993, 18.4316716]
(pl) warsaw [52.2396659, 21.0129345]
(sg) yishun [1.4230218, 103.8404728]
...
$ speedtest --city=capetown
$ speedtest --location=60,-110
With --saving-mode
option, it can be executed even in an insufficient memory environment like IoT devices.
The memory usage can be reduced to 1/10, about 10MB of memory is used.
However, please be careful that the accuracy is particularly low, especially in an environment of 30 Mbps or higher. To get more accurate results, run multiple times and average.
For more details, please see saving mode experimental result.
--saving-mode
is still a good way to save computer performance.
go get github.com/showwin/speedtest-go
The code below finds the closest available speedtest server and tests the latency, download, and upload speeds.
package main
import (
"fmt"
"github.com/showwin/speedtest-go/speedtest"
)
func main() {
var speedtestClient = speedtest.New()
// Use a proxy for the speedtest. eg: socks://127.0.0.1:7890
// speedtest.WithUserConfig(&speedtest.UserConfig{Proxy: "socks://127.0.0.1:7890"})(speedtestClient)
// Select a network card as the data interface.
// speedtest.WithUserConfig(&speedtest.UserConfig{Source: "192.168.1.101"})(speedtestClient)
user, _ := speedtestClient.FetchUserInfo()
// Get a list of servers near a specified location
// user.SetLocationByCity("Tokyo")
// user.SetLocation("Osaka", 34.6952, 135.5006)
serverList, _ := speedtestClient.FetchServers(user)
targets, _ := serverList.FindServer([]int{})
for _, s := range targets {
// Please make sure your host can access this test server,
// otherwise you will get an error.
// It is recommended to replace a server at this time
s.PingTest()
s.DownloadTest()
s.UploadTest()
fmt.Printf("Latency: %s, Download: %f, Upload: %f\n", s.Latency, s.DLSpeed, s.ULSpeed)
}
}
Speedtest-go is a great tool because of the following 4 reasons:
- Cross-platform available.
- Low memory environment.
- Testing time is the SHORTEST compare to speedtest.net and sivel/speedtest-cli, especially about 2x faster than speedtest.net.
- Result is MORE CLOSE to speedtest.net than speedtest-cli.
The following data is summarized. If you got interested, please see more details.
distance = distance to testing server
- 0 - 1000(km) ≒ domestic
- 1000 - 8000(km) ≒ same region
- 8000 - 20000(km) ≒ really far!
- 20000km is half of the circumference of our planet.
distance (km) | speedtest.net | speedtest-go | speedtest-cli |
---|---|---|---|
0 - 1000 | 92.12 | 91.21 | 70.27 |
1000 - 8000 | 66.45 | 65.51 | 56.56 |
8000 - 20000 | 11.84 | 9.43 | 11.87 |
distance (km) | speedtest.net | speedtest-go | speedtest-cli |
---|---|---|---|
0 - 1000 | 65.56 | 47.58 | 36.16 |
1000 - 8000 | 58.02 | 54.74 | 26.78 |
8000 - 20000 | 5.20 | 8.32 | 2.58 |
distance (km) | speedtest.net | speedtest-go | speedtest-cli |
---|---|---|---|
0 - 1000 | 45.03 | 22.84 | 24.46 |
1000 - 8000 | 44.89 | 24.45 | 28.52 |
8000 - 20000 | 49.64 | 34.08 | 41.26 |
See Contributors, PRs are welcome!
You can find or report issues in the Issue Tracker.