https://github.com/yudakusumaid/multi-isp-proxy
Venn ⚡ — Lightweight CLI tool to bond multiple internet connections (Wi-Fi + Ethernet + Cellular) into one proxy on Windows. Supports HTTP CONNECT & SOCKS5.
https://github.com/yudakusumaid/multi-isp-proxy
failover golang internet-bonding link-aggregation load-balancer multi-isp multi-wan network-tools networking proxy socks5 windows
Last synced: 2 months ago
JSON representation
Venn ⚡ — Lightweight CLI tool to bond multiple internet connections (Wi-Fi + Ethernet + Cellular) into one proxy on Windows. Supports HTTP CONNECT & SOCKS5.
- Host: GitHub
- URL: https://github.com/yudakusumaid/multi-isp-proxy
- Owner: YudaKusumaID
- License: mit
- Created: 2026-03-19T23:55:20.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-20T00:31:29.000Z (3 months ago)
- Last Synced: 2026-03-20T15:56:33.150Z (3 months ago)
- Topics: failover, golang, internet-bonding, link-aggregation, load-balancer, multi-isp, multi-wan, network-tools, networking, proxy, socks5, windows
- Language: Go
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Venn Combine Connection ⚡ - Multi-ISP Proxy Tool
**Venn Combine Connection** is a lightweight, interactive CLI tool for Windows and Linux that empowers you to aggregate multiple internet connections into a single, high-performance proxy — effectively enabling **internet bonding** and **link aggregation** at the application level.
Acting as both an **HTTP CONNECT** and **SOCKS5 proxy**, Venn intelligently distributes network traffic across all your active interfaces (Wi-Fi, Ethernet, Tethering, Cellular) to maximize bandwidth and ensure network redundancy. Think of it as a **multi-WAN load balancer** that runs entirely from your terminal.
## 🎯 Use Cases (Why use Venn?)
- **Bandwidth Aggregation / Internet Bonding:** Combine your Wi-Fi and mobile tethering to speed up heavy downloads and achieve higher throughput via connection pooling.
- **Connection Reliability & Failover:** Stream or game without interruption using the Failover mode; if your Wi-Fi drops, Ethernet/Cellular takes over instantly — true **multi-WAN redundancy**.
- **Network Engineering & Testing:** Easily test and route packets across multiple ISPs simultaneously without complex OS-level routing tables or dedicated hardware.
## 🚀 Core Features
- **Multi-Interface Load Balancing**: Seamlessly combine 2 or more active internet adapters into a unified proxy endpoint.
- **Smart Routing Strategies**:
- **Round-Robin**: Distributes connections evenly across all selected interfaces. Ideal for load balancing and heavy browsing.
- **Failover**: Assigns a primary interface and automatically routes traffic to secondary ones if the primary goes offline.
- **Interactive TUI (Terminal User Interface)**: A beautiful, responsive terminal dashboard built with Bubbletea for real-time monitoring and easy interface selection.
- **System Proxy Integration**:
- **Auto-Config (Windows)**: Automatically injects proxy settings into the Windows system. (For Linux, manual configuration in browser/app is required).
- **Magic Restore (Windows)**: Safely backs up and restores your original Windows proxy settings upon exit.
- **Dual Protocol Support**:
- `HTTP CONNECT` Proxy (Default: port 1080) - Universal compatibility.
- `SOCKS5` Proxy (Default: port 1081) - For raw TCP/UDP packet routing.
- **Live Telemetry**: Track bytes sent/received and active connection counts per interface in real-time.
## ⚙️ How It Works
```mermaid
graph LR
A[Your Browser / App] -->|HTTP or SOCKS5| B(Venn Proxy)
B -->|Round-Robin / Failover| C[Wi-Fi Adapter]
B -->|Round-Robin / Failover| D[Ethernet Adapter]
B -->|Round-Robin / Failover| E[Cellular / Tethering]
C --> F((Internet))
D --> F
E --> F
```
Venn sits between your applications and the internet as a local proxy server. When a connection request comes in, the **routing engine** selects which network adapter to use based on your chosen strategy:
1. **Round-Robin** cycles through all active interfaces, distributing load evenly.
2. **Failover** sends all traffic through your primary adapter and only switches when it detects the primary is down.
On Windows, proxy settings are automatically configured, so every app that respects system proxy settings will benefit. On Linux, simply configure your specific applications (e.g. Firefox, Curl) to point to the proxy address.
## 🛠 Installation
### Prerequisites
- Windows OS (Windows 10/11) or Linux
- [Go](https://go.dev/dl/) 1.25 or later (Only if building from source)
### Quick Start (Windows)
1. Download the latest `venn.exe` from the [Releases](https://github.com/YudaKusumaID/multi-isp-proxy/releases) page.
2. Run the executable in your terminal (PowerShell or CMD).
### Build From Source
```sh
# Clone the repository
git clone https://github.com/YudaKusumaID/multi-isp-proxy.git
cd multi-isp-proxy
# Build the binary
go build -o venn.exe ./cmd/ # On Windows
go build -o venn ./cmd/ # On Linux
# Run the tool
.\venn.exe # On Windows
./venn # On Linux
```
## 📖 Usage Guide
1. **Launch**: Start `venn.exe`. *(Tip: Run with `-addr :8080` to assign a custom port).*
2. **Select Interfaces**: Use `↑/↓` arrow keys to navigate and `Space` to toggle the network adapters you want to combine. Press `a` to select all, then `Enter` to confirm.
3. **Choose Strategy**: Select between `Round-Robin` or `Failover` mode.
4. **System Auto-Proxy (Windows)**: When prompted, press `Y` to automatically configure Windows to route traffic through Venn. Your original settings will be magically restored when you quit. (Linux users can skip this and manually configure `127.0.0.1:1080` in their browsers).
5. **Dashboard Controls**: Monitor traffic in real-time. Press `r` to reset statistics or `q` to safely exit the application.
## ❓ FAQ & Troubleshooting
How do I combine Wi-Fi and Ethernet on Windows?
Simply run `venn.exe`, select both your Wi-Fi and Ethernet adapters from the list, choose **Round-Robin** mode, and enable Auto-Proxy. All your internet traffic will now be distributed across both connections.
Does Venn actually increase my download speed?
Yes, but with a caveat. Venn distributes **connections** (not individual packets) across interfaces. This means multi-threaded downloads (like those from download managers or torrents) will see a real speed boost. A single-threaded download will still use one interface at a time.
Will Venn work with any application?
Venn works with any application that respects Windows system proxy settings (browsers, most download managers, etc.). For apps that don't, you can manually configure them to use `127.0.0.1:1080` (HTTP) or `127.0.0.1:1081` (SOCKS5).
My proxy settings weren't restored after a crash. How do I fix this?
Venn automatically backs up your proxy settings. If the application crashes unexpectedly, simply run `venn.exe` again and exit it gracefully with `q` — your original settings will be restored.
Can I use Venn as a SOCKS5 proxy for gaming or specific apps?
Yes! Venn exposes a SOCKS5 proxy on port `1081` by default. Configure your game or application to use `127.0.0.1:1081` as a SOCKS5 proxy to route its traffic through your combined connections.
## 🤝 Contributing
Contributions are welcome! Whether it's bug reports, feature requests, or pull requests — every bit helps.
1. **Fork** the repository.
2. **Create** your feature branch: `git checkout -b feature/amazing-feature`
3. **Commit** your changes: `git commit -m 'Add amazing feature'`
4. **Push** to the branch: `git push origin feature/amazing-feature`
5. **Open** a Pull Request.
Please check the [Issues](https://github.com/YudaKusumaID/multi-isp-proxy/issues) page for open tasks and bug reports.
## 🛡 License
This project is open-sourced software licensed under the [MIT License](LICENSE).
## 🙏 Credits & Acknowledgements
Venn is built on the shoulders of giants:
- [Bubbletea](https://github.com/charmbracelet/bubbletea) & [Lipgloss](https://github.com/charmbracelet/lipgloss) for the stunning TUI.
- [go-socks5](https://github.com/things-go/go-socks5) for the robust SOCKS5 implementation.
- [golang/sys](https://github.com/golang/sys) for low-level OS interactions.
---