speeder

README

speeder

A fast, data-efficient internet speed test CLI built in Go — with built-in game server latency checking for CS2 and Dota 2.

Uses the ndt7 protocol over M-Lab's open, nonprofit server network. No Ookla/speedtest.net dependency.

  Server:    ndt-mlab1-sin01.mlab-oti.measurement-lab.org
  Location:  Singapore SG

  Latency:   14.2 ms  jitter: 0.9 ms
  Download:  94.71 Mbps  (3.1s, 36.8 MB)
  Upload:    23.10 Mbps  (2.8s,  8.1 MB)

  Data used: 44.9 MB

speeder vs Ookla Speedtest

Both tools measure internet speed — they just make different trade-offs.

	speeder	Ookla Speedtest
Server network	~800 M-Lab servers (nonprofit)	~15,000 community servers
Open source	Yes (MIT)	Client is proprietary
Data per test	~30–50 MB (adaptive)	~150–300 MB
Test data	Published openly by M-Lab	Collected by Ookla
API key	Not required	Required for CLI/automation
JSON output	Built-in	Available
Game ping	Built-in (CS2, Dota 2)	Not available

M-Lab (Measurement Lab) is a nonprofit research project backed by Google, Princeton University, and New America. Its infrastructure is designed specifically for open, reproducible internet measurement — the same backend used by Google's built-in speed test. All test results are published as open data.

Ookla has a much larger server network and is the industry-standard reference that most ISPs and users recognise.

Neither is objectively "better" — they measure different things against different server networks, so results will naturally differ. speeder is a good fit if you want a lightweight, scriptable, open-source tool with no account required. Ookla is the right choice when you need a result that's widely recognised or when comparing against an ISP's advertised speeds using their preferred benchmark.

Desktop App (Windows)

Speeder ships a native Windows desktop app — a dark-mode GUI built for gamers.

Download: grab speeder-desktop-windows-amd64.exe from the Releases page and run it — no install required.

What's in the app:

• Speed Test — large live gauge, phase stepper (Connect → Ping → Download → Upload), hero download/upload numbers on completion
• Game Check — pick CS2 or Dota 2, see every server's latency/jitter/packet loss on a world map, then launch the game directly from the best-server card
• History — chart and table of all past speed tests
• Dashboard — at-a-glance last result with latency colour coding (green < 20 ms, amber < 60 ms, red ≥ 60 ms)

Build from source (requires Wails v2 and Node 24):

cd ui
wails build
# → build/bin/Speeder.exe

---

Features

• Speed test — adaptive early stopping (CV < 3%), minimal data usage
• Game ping — check CS2 and Dota 2 server latency, jitter, packet loss, and gaming score before queuing
• ISP + public IP — automatically detected and shown alongside results
• History — every result saved to ~/.speeder/history.jsonl; view with speeder history
• --ping-only — latency/jitter only, no download/upload, uses ~0 data
• --watch 5m — repeat test on an interval, great for monitoring unstable connections
• --fail-if-below 50mbps — exit code 1 if download is below threshold, scriptable for health checks
• --quick preset: 4 s max, typically < 35 MB total
• JSON output for scripting
• Zero config, no account, no API key
• Pure Go, no CGO — any OS, any architecture

Installation

With Go (any OS, any architecture)

go install github.com/mhdiiilham/speeder@latest

The binary lands in $(go env GOPATH)/bin/. Make sure that directory is on your PATH.

Pre-built binaries

Download the latest binary for your platform from the Releases page:

Platform	Binary
Linux amd64	speeder-linux-amd64
Linux arm64	speeder-linux-arm64
macOS (Apple Silicon)	speeder-darwin-arm64
macOS (Intel)	speeder-darwin-amd64
Windows amd64	speeder-windows-amd64.exe

Windows (PowerShell one-liner)

irm https://raw.githubusercontent.com/mhdiiilham/speeder/main/install.ps1 | iex

Downloads the correct binary for your architecture, installs it to %LOCALAPPDATA%\speeder\, and adds it to your user PATH — no admin rights required. Open a new terminal after installing, then run speeder.

macOS / Linux (curl one-liner)

curl -Lo speeder \
  https://github.com/mhdiiilham/speeder/releases/latest/download/speeder-linux-amd64
chmod +x speeder && sudo mv speeder /usr/local/bin/

Usage

speeder [flags]

  --list              list nearby M-Lab servers and exit
  --server string     use a specific server hostname
  --json              output results as JSON to stdout
  --no-progress       disable live progress updates
  --duration int      max seconds per test phase (default 8)
  --quick             quick preset: 4 s max, minimal data usage
  --ping-only         measure latency/jitter only, skip download/upload
  --fail-if-below N   exit 1 if download < N Mbps (e.g. 50 or 50mbps)
  --watch duration    repeat on an interval (e.g. 5m, 30s, 1h)
  --game string       check game server latency: cs2, dota2
  --version           print version and exit

speeder history [flags]

  --last int          number of results to show (default 10)
  --json              output raw JSONL

Speed test

speeder                        # full test, auto-selects nearest server
speeder --quick                # less data, faster result
speeder --ping-only            # latency/jitter only, ~0 data
speeder --json | jq .download_mbps
speeder --fail-if-below 50     # exits 1 if download < 50 Mbps
speeder --watch 5m             # repeat every 5 minutes until Ctrl-C
speeder --no-progress --json >> speedlog.jsonl

Example output:

  Server:    ndt-mlab1-sin01.mlab-oti.measurement-lab.org
  Location:  Singapore SG
  ISP:       Maxis Broadband Sdn Bhd  (203.115.x.x)

  Latency:   14.2 ms  jitter: 0.9 ms
  Download:  94.71 Mbps  (3.1s, 36.8 MB)
  Upload:    23.10 Mbps  (2.8s,  8.1 MB)

  Data used: 44.9 MB

History

Results are automatically saved to ~/.speeder/history.jsonl after every run.

speeder history           # show last 10 results
speeder history --last 30
speeder history --json    # raw JSONL for scripting

  Speed Test History

  TIME              SERVER                   DOWNLOAD    UPLOAD    LATENCY
  ─────────────────────────────────────────────────────────────────────────
  Jun 12 10:00     ndt-mlab1-sin01...        94.7 Mbps  23.1 Mbps  14.2 ms
  Jun 11 22:30     ndt-mlab1-sin01...        88.3 Mbps  21.4 Mbps  15.1 ms
  Jun 11 18:15     ndt-mlab1-sin01...       102.1 Mbps  24.9 Mbps  13.8 ms
  ─────────────────────────────────────────────────────────────────────────
  3 result(s) total.

Game server check

Know your connection quality before queuing into a ranked match:

speeder --game cs2
speeder --game dota2

  CS2 Server Latency

  SERVER                     PING   JITTER   LOSS  SCR  STATUS
  ────────────────────────────────────────────────────────────
  Singapore [AP]            12 ms     1 ms     0%   97  Excellent ✓
  Tokyo [AP]                47 ms     4 ms     0%   72  Good
  Hong Kong [AP]            55 ms     6 ms     0%   64  Playable
  Frankfurt [EU]           198 ms    15 ms     5%    8  Very Poor
  Virginia [NA]            220 ms    20 ms     3%    5  Very Poor
  ────────────────────────────────────────────────────────────

  Verdict: Ready to play! Your connection to Singapore is excellent.

  Note: Steam SDR adds ~2–5 ms overhead between the relay and the actual
  game server, so your real in-game ping will be slightly higher than
  shown here. The relative ranking between servers is accurate.

Shows the 5 best servers, sorted by gaming score.

Gaming score (0–100)

Metric	Weight	Best value
Latency	50 pts	≤ 20 ms
Jitter	30 pts	≤ 2 ms
Packet loss	20 pts	0%

Score	Verdict
85–100	Ready to play — excellent
70–84	Good — slight disadvantage in close duels
50–69	Playable — consider playing off-peak
30–49	High latency — avoid ranked
0–29	Very poor — not recommended for competitive

How servers are measured

CS2 and Dota 2 use Valve's CM (Connection Manager) server hostnames (cmp1-*.steamserver.net:27018). These are TCP/WebSocket servers that accept direct connections and share datacenters with game servers, giving accurate latency readings. 10 TCP probes per server measure ping, jitter, and packet loss concurrently.

Aliases

speeder --game cs            # same as --game cs2
speeder --game counter-strike
speeder --game dota          # same as --game dota2

JSON output format (speed test)

{
  "server": { "hostname": "...", "city": "Singapore", "country": "SG" },
  "latency_ms": 14.2,
  "jitter_ms": 0.9,
  "download_mbps": 94.71,
  "upload_mbps": 23.10,
  "data_used_mb": 44.9
}

Privacy

speeder makes outbound connections to three services:

Service	What it's used for	Data collected
M-Lab (measurementlab.net)	Server discovery and speed test	Your IP, test results — published as open data
ipinfo.io	ISP name and public IP lookup	Your IP address, timestamp, User-Agent
Valve (steamserver.net)	CS2/Dota 2 game ping only	TCP connection metadata

On ipinfo.io: it is a commercial service that logs requests and may use them for analytics. The ISP lookup is a best-effort convenience feature — no account or API key is required, and speeder sends only a standard HTTP request with no personal data beyond your IP. If you prefer not to contact ipinfo.io, the feature still works as expected; ISP and IP fields will just be empty in the output.

M-Lab's data collection is worth knowing about: all ndt7 test results (your IP, speed, location) are published publicly as open research data. This is by design — it's how M-Lab tracks global internet health. If you need private results, use --no-progress --json and pipe the output locally without the data reaching M-Lab's archives... though the test itself still runs against their servers.

Data usage (speed test)

speeder stops each phase as soon as the speed measurement stabilises, minimising data usage without sacrificing accuracy.

Connection	Default	--quick
50 Mbps	~25 MB	~15 MB
100 Mbps	~40 MB	~25 MB
500 Mbps	~100 MB	~60 MB

Compare: Ookla's official client typically uses 150–300 MB on a fast connection.

Building from source

git clone https://github.com/mhdiiilham/speeder.git
cd speeder
go mod tidy
make build          # → bin/speeder
make test           # run tests with race detector
make coverage       # test + HTML coverage report
make release        # cross-compile all platforms to bin/

Integration tests (hit real servers)

go test -tags integration ./internal/game/ -v -timeout 60s

Pings real CS2 and Dota 2 servers and prints a full latency table.

Requires Go 1.21+.

License

MIT — see LICENSE.