Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
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.
| Speed Test | One-shot download, upload, and ping. Parallel connections, peak rates, timed phases. Auto-saves runs; average + "Good for" insight; compare the latest 10. |
| Bandwidth Monitor | Live view of real PC traffic (OS counters only — no test load). Peaks, uptime, pause, and an Apps panel showing what's using bandwidth now. |
| Settings | Searchable settings: 20 color themes, About & Support, database reset, uninstall instructions. |
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
- 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
- Average & record insight — Your usual average block summarizes mean ↓/↑/ping across all saved runs
- "Good for" verdict — grades your connection Perfect/Good/Fair/Bad for Gaming, 4K, 2K, 1080p and Video calls, plus real transfer-time estimates ("100 GB game ≈ 53m")
- Copy result — press y to copy ↓248 ↑19 12ms to the clipboard
- 20 themes — default, ocean, midnight, sunset, forest, rose, nord, dracula, cyber, ember, arctic, gruvbox, tokyo, catppuccin, solarized, rosepine, monokai, onedark, github, everforest (Settings or --theme)
- Settings search — filter themes & sections; enter jumps to the best match
- About & Support — new Settings section with version, GitHub ★, and Buy me a coffee
- Update checker — main menu shows an Up to date / Update available chip (click or g opens GitHub)
- Apps using bandwidth — Bandwidth monitor can list which apps are active on the network right now (a)
- 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
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
riptideUninstall:
curl -fsSL https://raw.githubusercontent.com/Foxemsx/riptide/main/uninstall.sh | shOn macOS the same curl | sh commands work (the script detects Darwin).
You can also open Settings → Uninstall inside the app for the same instructions.
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
git clone https://github.com/Foxemsx/riptide
cd riptide
go build -o riptide ./cmd/riptide # Windows: go build -o riptide.exe ./cmd/riptide
./riptidePut $(go env GOPATH)/bin on your PATH if riptide is not found after go install.
riptide # main menu
riptide --compact # skip the large logo
riptide --theme ocean # start with a palette (also saved as preference)| Flag | Default | Description |
|---|---|---|
| --compact | false | Tagline only (no large logo) |
| --theme | saved / default | Color palette (see Themes below) |
| Key | Action |
|---|---|
| ← → ↑ ↓ / h j k l | Move in the menu |
| 1 2 3 4 | Jump to Speed Test / Bandwidth / Settings / Exit |
| enter | Select |
| s | Speed Test — save / rename the current run |
| y | Speed Test — copy result as ↓248 ↑19 12ms |
| c | Cycle units |
| r | Restart test / monitor |
| p | Pause / resume (Bandwidth only) |
| a | Bandwidth — toggle the Apps using bandwidth panel |
| t | Toggle compact logo |
| g | Open the project on GitHub (menu & settings) |
| ? | Help overlay |
| esc / m | Back to main menu |
| q / ctrl+c | Quit |
| Key | Action |
|---|---|
| type | Filter themes & sections live |
| enter | Jump to best match (or apply a matched theme) |
| tab | Next section |
| 1–4 | Jump to Themes / Reset / Uninstall / About |
| ← → / j k | Browse themes |
| enter on theme | Apply & save theme |
| enter on About | Open Buy me a coffee (or b) |
| enter on Reset | Confirm wipe of saved runs |
| Name | Vibe |
|---|---|
| default | Teal & amber on charcoal |
| ocean | Deep sea · cyan foam |
| midnight | Electric blue · violet night |
| sunset | Coral dusk · warm gold |
| forest | Moss · gold canopy |
| rose | Blush · soft magenta |
| nord | Frost · polar aurora |
| dracula | Purple night · neon pink |
| cyber | Neon green · hot magenta |
| ember | Charcoal fire · molten gold |
| arctic | Ice blue · clean slate |
| gruvbox | Warm retro · earth tones |
| tokyo | Tokyo Night · neon anime dusk |
| catppuccin | Soft pastel mocha |
| solarized | Classic dark precision |
| rosepine | Dusty dawn calm |
| monokai | Vivid code-editor heat |
| onedark | Editor default comfort |
| github | Exactly like the site |
| everforest | Calm muted woodland |
Theme preference is stored in the local database (overridden by --theme for that launch).
Speed tests are stored in SQLite as riptide.db:
| OS | Location |
|---|---|
| Linux | ~/.config/riptide/riptide.db |
| macOS | ~/Library/Application Support/riptide/riptide.db (via os.UserConfigDir()) |
| Windows | %AppData%\riptide\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
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/Foxemsx/riptide/main/uninstall.sh | shManual
# Linux or macOS
rm -f "$(command -v riptide)"
# Windows (go install)
del %USERPROFILE%\go\bin\riptide.exeUninstall removes the binary only — not Go, not your PATH entries, and not riptide.db. To wipe history first, use Settings → Reset database.
MIT — free to use, modify, and redistribute with the license notice.