Skip to content

rapjul/surge

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

196 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Surge

Release License: MIT Go Version

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.

demo

Installation

Prebuilt Binaries

Get it on GitHub

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.

About

Surge is an open-source download manager

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Go 86.4%
  • Python 11.2%
  • JavaScript 1.5%
  • HTML 0.9%