riptide

module
v1.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 10, 2026 License: MIT

README

riptide

Measure and watch your internet connection — from the terminal.

A polished Go TUI with a startup menu, one-shot speed tests, and a live bandwidth monitor. Centered cards, smooth graphs, no config required.

terminal Go Linux Windows License

riptide demo


Modes

Speed Test One-shot download, upload, and ping. Parallel connections, peak rates, timed phases.
Bandwidth Monitor Live view of real PC traffic (OS counters only — no test load). Peaks, uptime, pause.

Both modes share the same card UI, accent colors (teal ↓ / amber ↑), and keyboard controls.


Screenshots

Main menu   Speed test

Main menu · pick Speed Test, Bandwidth, or Exit   |   Speed Test · live graphs mid-run

Finished summary   Bandwidth monitor

Finished · peaks + ping summary   |   Bandwidth · live DL/UL of your real connection

Help overlay

Help · press ? anytime for controls · esc / m back to menu


Features

  • Startup menu — card buttons with hotkeys 1 / 2 / 3, keyboard or mouse
  • High-res graphs — eighth-block bars, fire gradients, peak spark, age fade
  • Smooth numbers — lerped display values instead of hard snaps
  • Units on the flyc cycles Mbps · KB/s · MB/s · GB/s
  • Compact modet hides the large logo when space is tight
  • Clean chrome — VS-style #191a1b canvas, rounded cards, accent chips
  • Graceful errors — no stack traces when the network is down

Quick start

Linux (installer — no sudo):

curl -fsSL https://raw.githubusercontent.com/Foxemsx/riptide/main/install.sh | sh
riptide

Anywhere with Go 1.23+:

go install github.com/Foxemsx/riptide/cmd/riptide@latest
riptide

From source:

git clone https://github.com/Foxemsx/riptide
cd riptide
go build -o riptide ./cmd/riptide    # Windows: go build -o riptide.exe ./cmd/riptide
./riptide

Put $(go env GOPATH)/bin on your PATH if riptide is not found after go install.

Uninstall (Linux):

curl -fsSL https://raw.githubusercontent.com/Foxemsx/riptide/main/uninstall.sh | sh

Usage

riptide              # main menu → Speed Test or Bandwidth
riptide --compact    # skip the large logo
Flag Default Description
--compact false Tagline only (no large logo)
--theme default Reserved for future palettes
Controls
Key Action
/ j k Move in the menu
1 2 3 Jump to a menu option
enter Select
c Cycle units
r Restart test / monitor
p Pause / resume (Bandwidth only)
t Toggle compact logo
? Help overlay
esc / m Back to main menu
q / ctrl+c Quit

License

MIT — free to use, modify, and redistribute with the license notice.

Directories

Path Synopsis
cmd
riptide command
internal
ui

Jump to

Keyboard shortcuts

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