surge

README

Surge

About

Surge is a blazing fast, open-source terminal (TUI) download manager built in Go. Designed for power users who prefer a keyboard-driven workflow and want full control over their downloads.

Installation

Prebuilt Binaries

Go Install

go install github.com/junaid2005p/surge@latest

Build from Source

git clone https://github.com/junaid2005p/surge.git
cd surge
go build -o surge .

Features

• High-speed downloads with multi-connection support
• Beautiful TUI built with Bubble Tea & Lipgloss
• Pause/Resume downloads seamlessly
• Real-time progress with speed graphs and ETA
• Auto-retry on connection failures
• Smart file detection and organization
• Browser extension integration

Usage

# Start TUI mode
surge

# Headless download (CLI only, no TUI)
surge get <URL>

# Headless download with custom output directory
surge get <URL> -o ~/Downloads

Benchmarks

Tool	Time	Speed	vs Surge
Surge	28.93s	35.40 MB/s	—
aria2c	40.04s	25.57 MB/s	1.38× slower
curl	57.57s	17.79 MB/s	1.99× slower
wget	61.81s	16.57 MB/s	2.14× slower

Test Environment

Results averaged over 5 runs

File	1GB.bin (link)
OS	Windows 11 Pro
CPU	AMD Ryzen 5 5600X
RAM	16 GB DDR4
Network	360 Mbps / 45 MB/s

Run your own: python benchmark.py -n 5

Browser Extension

Intercept downloads from your browser and send them directly to Surge.

Installation

1. Open Chrome/Edge and navigate to chrome://extensions
2. Enable Developer mode
3. Click Load unpacked and select the extension folder
4. Ensure Surge is running before downloading

The extension will automatically intercept downloads and send them to Surge via http://127.0.0.1.

Contributing

Contributions are welcome! Feel free to fork, make changes, and submit a pull request.

License

If you find Surge useful, consider giving it a ⭐ it helps others discover the project!

This project is licensed under the MIT License. See the LICENSE file for details.