speedtest-cli(1)

📦
version 2.1.3 · 4 versions
, in debian bookworm, debian trixie, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute

💖 speedtest-cli — the manual page, bestie edition 💖

okay so real talk: this is the manual page for speedtest-cli, a General Commands Manual entry. Yes, the classic ones. Let's get into it. ✨

🌸 NAME 🌸

speedtest-cli — a command line interface for testing your internet bandwidth using speedtest.net 🦋

🎀 SYNOPSIS 🎀

speedtest-cli [OPTION...]

that's it. that's the whole vibe. 💅

✨ DESCRIPTION ✨

So like, Speedtest.net is a web service for testing your broadband connection by downloading a file from a nearby speedtest.net server on the web. And this tool? It lets you access that whole service from the command line. no browser, no ads, no nonsense. main character energy fr. 👑

Speedtest mini is a version of the Speedtest.net server that you can host locally. yes bestie, your own lil server, in your own lil house. 🏠

💅 OPTIONS 💅

Usage, once again for the people in the back:

speedtest-cli [OPTION...]

🫶 Help Options

  • -h, --help — Displays usage for the tool. like, it tells you how to use it. iconic behaviour.

⭐ Options

  • --no-download — Do not perform download test. skipping leg day, but for downloads.
  • --no-upload — Do not perform upload test. same energy, other direction.
  • --single — Only use a single connection instead of multiple. This simulates a typical file transfer. one connection, one dream. 🌈
  • --bytes — Display values in bytes instead of bits. Does not affect the image generated by --share, nor output from --json or --csv. so like, bytes not bits, got it? but it doesn't touch your --share image, and it doesn't touch --json or --csv output. stay in your lane bestie. 💀
  • --share — Generate and provide a URL to the speedtest.net share results image, not displayed with --csv. cute lil shareable image!! except when you're doing --csv, then it's a no-show. 🙈
  • --simple — Suppress verbose output, only show basic information. quiet luxury. 🎀
  • --csv — Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s and not affected by --bytes. spreadsheet girlies rise up. 📊
  • --csv-delimiter CSV_DELIMITER — Single character delimiter to use in CSV output. Default ",". one character only!! just one!! the default is a comma.
  • --csv-header — Print CSV headers. label your columns, you're a professional. 👑
  • --json — Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s and not affected by --bytes. for the devs, the scripts, the automation girlies. 🤖
  • --list — Display a list of speedtest.net servers sorted by distance. closest first, obviously. 📍
  • --server SERVER — Specify a server ID to test against. Can be supplied multiple times. yes you can stack it. multiple times. go off.
  • --exclude EXCLUDE — Exclude a server from selection. Can be supplied multiple times. also stackable!! not that server. or that one. 🚫
  • --mini MINI — URL of the Speedtest Mini server. your local lil guy.
  • --source SOURCE — Source IP address to bind to. you're picking which IP you go out from, fancy.
  • --timeout TIMEOUT — HTTP timeout in seconds. Default 10. ten seconds and then we're DONE. ⏰
  • --secure — Use HTTPS instead of HTTP when communicating with speedtest.net operated servers. lock it up. 🔒
  • --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. so like, pre allocation is on by default because it makes uploads faster, BUT if your system is low on memory, use this so you don't get a MemoryError. noted, bestie. 🧠
not me warning you about a literal MemoryError — that's real, that's not a drill, that's the whole point of this flag. 😭
  • --version — Show the version number and exit. just a lil peek at who she is. 💖

🌈 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

found a bug? don't be shy, put it there. 🫶

👑 AUTHORS 👑

This manual page was written by Jonathan Carter <jonathan@ubuntu.com>

Speedtest-cli was written by Matt Martz <matt@sivel.net>

and that's the whole page bestie!! this manual was from the speedtest-cli crew, dated 2018-01-05, and it's the speedtest-cli(1) entry — go test your wifi and text me the numbers, i wanna see. 🎀✨💖

📦 where this page comes from