____  _____ _         _ __   __
|  _ \| ____| |      / \\ \ / /
| |_) |  _| | |     / _ \\ V / 
|  _ <| |___| |___ / ___ \| |  
|_| \_\_____|_____/_/   \_\_|  

A blazing-fast, themeable TUI download manager for your terminal.

---

What is Relay?

Relay is a terminal-native download manager that runs entirely in your terminal. It uses parallel chunked HTTP downloads, supports resuming interrupted transfers, verifies SHA-256 checksums, and presents everything in a beautiful live TUI — all driven by a single binary.

Built on the Charm ecosystem — Bubble Tea, Bubbles, and Lip Gloss.

---

Features

• Parallel chunked downloads — splits files into chunks and downloads them simultaneously across multiple workers
• Auto-resume — interrupted downloads pick up exactly where they left off using .part state files
• Queue management — add as many URLs as you want; Relay schedules them based on your concurrency limit
• Pause & Resume — stop any active download and bring it back on demand
• SHA-256 verification — optionally validate every download against an expected checksum
• Three beautiful themes — ocean, sunset, and mono, plus full per-color overrides via CLI flags
• Persistent state — your download queue survives restarts via a JSON state file
• Fully keyboard-driven — every action is a single keypress

---

Installation

git clone https://github.com/Paraspandey-debugs/Relay.git
cd Relay
bash installer.sh

This installs relayd into your terminal, typically at /usr/local/bin/relayd or ~/.local/bin/relayd.

If you want a custom install location:

INSTALL_DIR=~/.local/bin bash installer.sh

If you only want a local binary without installing to your PATH:

go build -o relayd ./cmd/dm

---

Usage

# Launch after installing with installer.sh
relayd

# Use the sunset theme with 5 concurrent downloads
relayd --theme sunset --concurrency 5

# Point to a custom state file
relayd --state ~/my-downloads.state.json

# Override individual colors
relayd --color-accent "#FF00FF" --color-background "#0D0D0D"

# If you built locally instead of installing
./relayd

All Flags

Flag	Default	Description
--state	relay-downloads.state.json	Path to the persistent state file
--concurrency	3	Max number of simultaneous downloads
--theme	ocean	TUI color theme (ocean | sunset | mono)
--refresh-ms	250	UI refresh interval in milliseconds
--workers	0	Default parallel chunk workers per download (0 = auto)
--cleanup	true	Remove partial files when a download is deleted
--color-background		Override background color (hex or ANSI)
--color-foreground		Override foreground color
--color-accent		Override accent color
--color-secondary		Override secondary color
--color-success		Override success color
--color-warning		Override warning color
--color-error		Override error color
--color-muted		Override muted color
--color-header		Override header color
--color-card		Override card background color
--color-selected-card		Override selected card color

---

Keybindings

Key	Action
1	Show queued/paused/errored tab
2	Show active downloads tab
3	Show completed downloads tab
Tab	Cycle between tabs
f	Start/clear list filter search
l	Toggle event log panel
g / G	Jump log view to top/bottom
a	Add a new download
p	Pause the selected download
r	Resume the selected download
x	Prompt to remove selected download
y / n	Confirm/cancel destructive prompts
s	Open the download settings panel
K	Move selected item up in the queue
J	Move selected item down in the queue
R	Force refresh the view
j / ↓	Move cursor down
k / ↑	Move cursor up
? / h	Toggle help overlay
Ctrl+Q / Ctrl+C	Quit

---

Themes

Relay ships with three handcrafted themes. Switch with --theme <name>.

🌊 Ocean	🌅 Sunset	⬜ Mono
Deep navy background with cool cyan accents and soft blue cards. The default experience. --theme ocean	Warm dark background with amber and coral highlights — easy on the eyes at night. --theme sunset	Minimal greyscale palette. Clean, distraction-free, works everywhere. --theme mono

---

Download Options

Each download inherits from a set of defaults that can be overridden per-job:

Option	Default	Description
Workers	12	Number of parallel chunk workers
MinChunkSize	1 MB	Minimum size for each chunk
MaxChunkSize	8 MB	Maximum size for each chunk
Timeout	30s	Per-request HTTP timeout
MaxRetries	10	Max retry attempts on failure
BaseBackoff	500ms	Initial backoff delay between retries
MaxBackoff	20s	Maximum backoff delay
ExpectedSHA256Hex	—	Optional SHA-256 hex checksum to verify
ForceSingle	false	Force single-stream download (no chunking)
NoResume	false	Disable resume, re-download from scratch

---

Architecture

cmd/dm/          → entry point & CLI flags
internal/
  core/
    download/    → chunked HTTP downloader, state & progress
    checksum/    → SHA-256 verification
    httpclient/  → HTTP client with probe (HEAD) support
  manager/       → queue, concurrency scheduling, state persistence
  tui/           → Bubble Tea model, views, themes, keybindings

---

License

Released under the MIT License.

---

_{Made with ♥ and Bubble Tea}