gust

module

v1.1.0 Latest Latest Go to latest Published: Jul 10, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/Tsunami43/gust

Links

Open Source Insights

README ¶

 ██████╗ ██╗   ██╗███████╗████████╗
██╔════╝ ██║   ██║██╔════╝╚══██╔══╝
██║  ███╗██║   ██║███████╗   ██║
██║   ██║██║   ██║╚════██║   ██║
╚██████╔╝╚██████╔╝███████║   ██║
 ╚═════╝  ╚═════╝ ╚══════╝   ╚═╝

Fast, dependency-free internet speed test & public-IP checker for your terminal.

gust shows your public IP, provider and location, then measures latency, download and upload speed — with an animated, colourful interface that gracefully degrades to plain text or JSON when piped.

Written in pure Go: no third-party dependencies, just the standard library.

Install

Requires Go 1.22+.

go install github.com/Tsunami43/gust/cmd/gust@latest

Usage

gust

  ⚡ gust  v1.1.0  ·  internet speed test

  ╭─ Network ───────────────────────────────────╮
  │ IP         203.0.113.7                       │
  │ Location   Berlin, Germany                   │
  │ Provider   AS3320 Deutsche Telekom AG        │
  │ Server     TXL · HTTP/2.0 · cloudflare       │
  ╰──────────────────────────────────────────────╯

  ✔ Latency   12.34 ms   · jitter 0.70 ms
  ✔ Download  ██████████████████████  94.21 Mbps
  ✔ Upload    ██████████████████████  18.44 Mbps

gust -ip-only   # only show public IP / network info
gust -json      # machine-readable output
gust -no-color  # disable colour / animation

Options

Flag	Default	Description
`-ip-only`	`false`	Only show public IP / network info.
`-json`	`false`	Output results as JSON.
`-no-download`	`false`	Skip the download test.
`-no-upload`	`false`	Skip the upload test.
`-no-color`	`false`	Disable coloured / animated output.
`-size`	`25`	Data to transfer per test, in MiB.
`-streams`	`4`	Parallel connections per test.
`-pings`	`6`	Number of latency samples.
`-timeout`	`60s`	Overall timeout.
`-version`	`false`	Print version and exit.

License

MIT

Directories ¶

Path	Synopsis
cmd
gust command Command gust is a small, dependency-free CLI that reports your public IP address and measures internet connection speed (latency, download and upload) using the public Cloudflare speed test endpoints.	Command gust is a small, dependency-free CLI that reports your public IP address and measures internet connection speed (latency, download and upload) using the public Cloudflare speed test endpoints.
internal
netinfo Package netinfo resolves public network information (IP address, ASN and approximate geographic location).	Package netinfo resolves public network information (IP address, ASN and approximate geographic location).
speed Package speed measures internet connection performance — round-trip latency together with download and upload throughput — using the public Cloudflare speed test endpoints (https://speed.cloudflare.com).	Package speed measures internet connection performance — round-trip latency together with download and upload throughput — using the public Cloudflare speed test endpoints (https://speed.cloudflare.com).
ui Package ui renders network information and speed results for humans (aligned plain text) and for machines (indented JSON).	Package ui renders network information and speed results for humans (aligned plain text) and for machines (indented JSON).

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL