riptide

riptide

Measure and watch your internet connection — from the terminal.

A polished Go TUI with a startup menu, one-shot speed tests, a live bandwidth monitor, themes, and saved test history. Centered cards, smooth graphs, SQLite under the hood.

Modes

Screenshots

_{Main menu · Speed Test, Bandwidth, Settings, Exit   |   Speed Test · live graphs mid-run}

_{Finished · peaks + ping + recent history   |   Bandwidth · live DL/UL of your real connection}

_{Settings · theme picker, reset DB, uninstall   |   Save · name a run after the test}

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

Features

• Startup menu — 2×2 card grid with hotkeys 1–4, keyboard or mouse
• Speed history — auto-saves completed tests; press s to name a run; latest 10 shown for comparison
• 11 themes — default, ocean, midnight, sunset, forest, rose, nord, dracula, cyber, ember, arctic (Settings or --theme)
• Settings search — filter themes & sections; enter jumps to the best match
• SQLite store — preferences + test runs in riptide.db (user config dir)
• High-res graphs — eighth-block bars, fire gradients, peak spark, age fade
• Smooth numbers — lerped display values instead of hard snaps
• Units on the fly — c cycles Mbps · KB/s · MB/s · GB/s
• Compact mode — t hides the large logo when space is tight
• Clean chrome — themed canvas, rounded cards, accent chips
• Graceful errors — no stack traces when the network is down

Quick start

Linux / macOS (installer — no sudo, bash only)

The install.sh script supports Linux and macOS. It re-execs under bash and, if no suitable Go toolchain is present, downloads one locally — it never touches your system go or needs root.

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

Uninstall:

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

On macOS the same curl | sh commands work (the script detects Darwin).

You can also open Settings → Uninstall inside the app for the same instructions.

Windows

The bash installer does not run on Windows. Pick one of:

• Prebuilt release — download riptide.exe from the Releases page and run it.

• With Go 1.23+ (no release needed):

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

From source (any OS with Go 1.23+)

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.

Usage

riptide                # main menu
riptide --compact      # skip the large logo
riptide --theme ocean  # start with a palette (also saved as preference)

Controls

Settings

Themes

Theme preference is stored in the local database (overridden by --theme for that launch).

Data & history

Speed tests are stored in SQLite as riptide.db:

• Completed speed tests auto-save with a timestamped name
• Press s during/after a speed test to save with a custom name
• The Recent tests block (latest 10) lives on the Speed Test screen only
• Settings → Reset database clears all saved runs (keeps theme); with confirmation

Uninstall

Linux / macOS

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

Manual

# Linux or macOS
rm -f "$(command -v riptide)"

# Windows (go install)
del %USERPROFILE%\go\bin\riptide.exe

Uninstall removes the binary only — not Go, not your PATH entries, and not riptide.db. To wipe history first, use Settings → Reset database.

License

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