I'm happy to make this sugestion as my first GitHub contribution to a project :-). I've added a --csv filename mode that write speedtest results to that filename.

speedtest-cli --csv bandwith_report.csv

If the file doesn't extists it generates a new one with a header. If it cannot write launches an error. This is a sample result:

Test server;Date/Time;Latency;Dowload Speed (Kb/s);Upload Speed (Kb/s)
Grupo TVHoradada (Pilar De La Horadada) [87.32 km];2015-07-06T11:28:32.013159;64.8;59847;25499
Grupo TVHoradada (Pilar De La Horadada) [87.32 km];2015-07-06T11:29:30.652184;62.22;59636;25775
TVAlmansa S.L. (Almansa) [50.87 km];2015-07-06T11:32:33.344205;85.19;60257;24798
TVAlmansa S.L. (Almansa) [50.87 km];2015-07-06T11:33:29.556000;62.26;58992;25111
...

You can install a cron jon to execute the test each hour for example and store results for future analysis or graphic.

$crontab -e
0 */1 * * * /home/myuser/speedtest-cli --csv bandwith_report.csv >> /dev/null

Edited: Standar output is been redirected to /dev/null in crontab. It could be interesting to add a --silent mode to use in combination with --csv

If multiple servers reported the exact same lat. and long. then they would overwrite eachother in the dict. I changed it to use a dict of lists so that you could have multiple servers with the exact same distance. (3 of my closest 5 reported the exact same corrdinates.)

The latency it was printing was not the latency from the chosen best server. Now it is.

Added a print out of the IP and ISP info.

I've added a option to test against a list of servers loaded from a json file.

I needed this option because the server I wanted to test against sometimes didn't appeared in speedtest.get_servers()

Now we can define one ore more servers like this: example-server.json

{
    "313.8447559412203": [
        {
            "url": "http://speedtest.glasfaser-ostbayern.de:8080/speedtest/upload.php",
            "lat": "49.0167",
            "lon": "12.0833",
            "name": "Regensburg",
            "country": "Germany",
            "cc": "DE",
            "sponsor": "R-KOM GmbH & Co. KG",
            "id": "4404",
            "host": "speedtest.glasfaser-ostbayern.de:8080",
            "d": 313.8447559412203
        }
    ]
}

#726 #717

python speedtest.py --search="United States"
# python speedtest.py --search "United States"
# set server by search result
python speedtest.py --search="United States" --server 18531
# test command
curl -s https://raw.githubusercontent.com/du5/speedtest-cli/7b3309c/speedtest.py \
| python - --search="United States"

pip install git+https://github.com/du5/speedtest-cli.git
speedtest --search="Hong Kong"
speedtest --search="Hong Kong" --server=13538 --share

Safeguard against sum() errors in case on "None" values. Those None values can appear if the requests somehow failed, see https://github.com/sivel/speedtest-cli/issues/752

Also gracefully catch and handle invalid status code responses.

I added support for binding sockets to a specific network interface since specifying the source ip is not enough on Linux based platforms.

The implementation was done by setting the SO_BINDTODEVICE socket option, according to this Stack Overflow Answer..

The interface will be passed as an argument like following --interface INTERFACE, for example --interface wlan0.

This feature will also solve issue #668.

Hi @sivel 👋,

I changed the style of output.

Before:

After:

The old output looked weird and it was very complicated. To me, this new output looks cute and simple. That's why I decided to renew it, I hope you like it.

Best regards, Mert Doğu.

Issue on the list command

root@prometheus:~# speedtest-cli --list
Retrieving speedtest.net configuration...
Traceback (most recent call last):
  File "/usr/bin/speedtest-cli", line 2000, in <module>
    main()
  File "/usr/bin/speedtest-cli", line 1986, in main
    shell()
  File "/usr/bin/speedtest-cli", line 1875, in shell
    secure=args.secure
  File "/usr/bin/speedtest-cli", line 1091, in __init__
    self.get_config()
  File "/usr/bin/speedtest-cli", line 1174, in get_config
    map(int, server_config['ignoreids'].split(','))
ValueError: invalid literal for int() with base 10: '

May be of interest, may not.

I wanted something that would allow me to easily monitor link quality over time; this is pretty easy for latency etc but nothing gave me an automated way of graphing speedtests.

The changes simply add a --plotly option which, if used, will spit out the upload, download and latency measurements from the results dict to the online graphing service, subsequent runs will append to the existing graph, with the timestamps for the X axis also being taken from the results dict.

Example graph output (mine) is here: https://plot.ly/~matjohn2/6.embed

Have also added a little Dockerfile and info in the readme as to how I use this, but like I said, may be of little interest to the wider speedtest-cli community, could have created a separate wrapper using the API, but only just noticed the API when submitting the PR ;)

HTTP is insecure – any attacker with a privileged network position could intercept the request and possibly drop/rewrite it. HTTPS makes it much harder for anyone to do so.

Some more reasons:

• SSL’s not perfect, but we need to make surveillance as expensive as possible.
• For privacy not to be suspicious, privacy should be on by default.

My requirement was to perform periodic automated tests to different servers while building up a file of results. This allows a "health check" to be performed on internet connection to see if particular times of day had better internet speeds. New options added: (1) Allow saving and loading configuration. Allows local configuration file to be used for automated tests. (2) Allow saving and loading of server list. Allows a custom server list to be supplied for automated speed tests allowing different distance servers to be used. (3) Allow saving of test results. Allows automated speed testing to build up a file of test results for long term testing. File format is csv.

I'd like speedtest to be able to bind to a client port, in addition to an IP. I extended source_address to support IP:PORT scheme and made it so you could optionally include the port or the IP address. The reason I want to bind to a client port is that I want my firewall to be route the speedtest through different external gateways based on the client port. This allows me to run speed tests against the different egress routes on my network but run the speedtest from a device that is not my router. This should be entirely backwards compatible.

I found the following error in the code if I want to get a better server this way:

sp = speedtest.Speedtest()
best_servers = sp.get_servers()
sp.get_best_server(best_servers)

I get an error:

Traceback (most recent call last):
  File "/speedtest/main.py", line 18, in <module>
    test_connection()
  File "/speedtest/main.py", line 8, in test_connection
    sp.get_best_server(best_servers)
  File "\speedtest\venv\lib\site-packages\speedtest.py", line 1459, in get_best_server
    url = os.path.dirname(server['url'])
TypeError: 'float' object is not subscriptable

I also added the else block, otherwise the condition is incorrect on line 1456.

Hello. I added the --custom argument so that users can include a URL like https://www.speedtest.net/api/js/servers?engine=js&search=orange&https_functional=true&limit=1 and perform speedtests against a server of their liking.

Update 7/3/2022:

• added interoperability feature to make --custom work alongside with --server that way we can choose a specific server from custom link.

For instance, a command like speedtest --custom "https://www.speedtest.net/api/js/servers?engine=js&search=Comcast&https_functional=true" --server 37808 should ping Comcast (Atlanta, GA)