Download · Install · Add a second connection · Troubleshooting · How it works
net-merge (rohit267/net-merge)
Searching Database…
net-merge README
The project's README from github.com/rohit267/net-merge. As one markdown file: README.md.
net-merge
Use all your internet connections at the same time.
Combine Wi-Fi, Ethernet and phone hotspots, so downloads, games and browsers get the speed of every connection added up.
Download · Install · Add a second connection · Troubleshooting · How it works
A Mac with Wi-Fi + an Android phone. The menu shows both connections working at once. Watch the full 45-second video.
net-merge uses all your network adapters together. It works on Windows, macOS and Linux. It is free. There is no account, no server and no VPN.
A real test with Wi-Fi + an Android USB tether + an iPhone hotspot, 9 downloads at once: 232-303 Mbit/s. The fastest connection alone gave about 121 Mbit/s.
| Windows: hover the icon | Windows: the menu | macOS: the menu bar |
|---|---|---|
 |
 |
 |
How it helps
net-merge gives every new connection to one of your links. When an app opens many connections, they spread over all your links.
- Good for: Steam and game downloads, browsers, system updates, cloud uploads (Google Drive), download managers like IDM, torrents.
- Not for: one single connection. One connection always uses one link, so one big file from one connection does not get faster.
- Works for every app, TCP and UDP, IPv4 and IPv6. You do not set up a proxy.
- Smart: faster links get more connections. A link with no internet gets none until it works again.
- Safe: if net-merge crashes, your internet keeps working.
- Light: about 0.18 CPU cores per 100 Mbit/s.
Install
macOS and Linux: paste this into a terminal.
curl -fsSL https://raw.githubusercontent.com/rohit267/net-merge/main/install.sh | sh
Windows: paste this into PowerShell.
irm https://raw.githubusercontent.com/rohit267/net-merge/main/install.ps1 | iex
That's it: net-merge is installed and its icon appears in the menu bar or tray. On Linux the script
uses your package manager (apt, dnf, zypper, apk or pacman) and on macOS Homebrew when you have it, so
net-merge updates with the rest of your system. To start it at sign-in: net-merge autostart on.
Rather type the commands yourself? One block per system, each ready to paste.
Homebrew (macOS):
brew install rohit267/tap/net-merge && sudo "$(brew --prefix)/bin/net-merge" install && net-merge tray
macOS without Homebrew:
curl -fsSL https://github.com/rohit267/net-merge/releases/latest/download/net-merge-macos-universal.tar.gz | tar -xz -C /tmp net-merge && sudo /tmp/net-merge install && net-merge tray
Debian, Ubuntu, Linux Mint, Pop!_OS, Raspberry Pi OS (apt):
curl -fsSL https://rohit267.github.io/net-merge/apt/key.gpg | sudo tee /usr/share/keyrings/net-merge.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/net-merge.gpg] https://rohit267.github.io/net-merge/apt stable main" | sudo tee /etc/apt/sources.list.d/net-merge.list
sudo apt update && sudo apt install -y net-merge
Fedora, RHEL, Rocky, Alma (dnf):
sudo curl -fsSL -o /etc/yum.repos.d/net-merge.repo https://rohit267.github.io/net-merge/rpm/net-merge.repo && sudo dnf install -y net-merge
openSUSE (zypper):
sudo zypper addrepo https://rohit267.github.io/net-merge/rpm/net-merge.repo && sudo zypper --gpg-auto-import-keys install -y net-merge
Arch, Manjaro, EndeavourOS (pacman):
curl -fsSL https://rohit267.github.io/net-merge/apt/key.asc | sudo pacman-key --add - && sudo pacman-key --lsign-key 0168C7AB77721656904811AE904F61E7F4F1C2A1
printf '\n[net-merge]\nSigLevel = Required\nServer = https://rohit267.github.io/net-merge/arch/$arch\n' | sudo tee -a /etc/pacman.conf
sudo pacman -Sy --noconfirm net-merge
Alpine (apk):
sudo wget -O /etc/apk/keys/net-merge.rsa.pub https://rohit267.github.io/net-merge/apk/net-merge.rsa.pub
echo https://rohit267.github.io/net-merge/apk | sudo tee -a /etc/apk/repositories && sudo apk add net-merge
Homebrew (Linux):
brew install rohit267/tap/net-merge && sudo setcap cap_net_admin,cap_net_raw+ep "$(readlink -f "$(brew --prefix)/bin/net-merge")"
Any other Linux (any CPU):
curl -fsSL https://github.com/rohit267/net-merge/releases/latest/download/net-merge-linux-$(uname -m).tar.gz | tar -xz -C /tmp net-merge && sudo install -m 755 /tmp/net-merge /usr/local/bin/ && sudo setcap cap_net_admin,cap_net_raw+ep /usr/local/bin/net-merge
Windows by hand: download net-merge-setup.exe and run it. Windows may warn because the app is not signed yet: click More info, then Run anyway. There is also a portable zip.
Then start it with net-merge tray (Linux, macOS) or from the Start menu (Windows).
Good to know
- Which CPUs: x86-64, ARM64 and Apple Silicon, ARMv7, ARMv6 (Raspberry Pi), x86 32-bit, RISC-V, PowerPC (ppc64le), s390x and LoongArch.
- No password prompts: the Linux packages give net-merge the network rights it needs (
setcap), and on macOSnet-merge installadds one rule so that onlynet-merge traycan run as root without a password. - Linux tray icon: needs a desktop with StatusNotifierItem support: KDE, XFCE, Cinnamon, LXQt, Budgie, or GNOME with the AppIndicator and KStatusNotifierItem Support extension (Ubuntu already has it).
- Firewall: if it blocks unknown traffic, trust the
net-mergeinterface (for examplefirewall-cmd --zone=trusted --add-interface=net-merge). - Signed repositories: apt, dnf, zypper and pacman use the key in
packaging/apt-signing-key.asc, fingerprint0168 C7AB 7772 1656 9048 11AE 904F 61E7 F4F1 C2A1. - Uninstall: your package manager (
sudo apt remove net-merge,brew uninstall net-merge, ...) or Windows' Installed apps. On macOS alsonet-merge autostart offandsudo net-merge uninstall.
NixOS
# flake.nix
inputs.net-merge.url = "github:rohit267/net-merge";
# configuration.nix (with `inputs` passed via specialArgs)
imports = [ inputs.net-merge.nixosModules.default ];
programs.net-merge = {
enable = true;
autostart = true; # optional: start the tray in every graphical session
};
To try it without installing: sudo nix run github:rohit267/net-merge -- run.
Add a second connection
net-merge needs two or more real connections. Use Wi-Fi plus one of these: a phone (USB tethering or hotspot), an Ethernet cable, or a second Wi-Fi. Plug it in and net-merge adds it within a few seconds. When you unplug it, its connections move to the others.
Windows and Linux: plug the phone in and turn on USB tethering (Android) or Personal Hotspot (iPhone). That is all.
Mac with an iPhone (nothing extra to install)
- Plug the iPhone in with a cable. Tap Trust on the iPhone if it asks.
- On the iPhone, open Settings > Personal Hotspot and turn on Allow Others to Join.
- An iPhone USB network appears on the Mac. net-merge adds it in a few seconds.
Mac with an Android phone (needs the app TetherKit)
macOS cannot use Android USB tethering by itself. The app TetherKit adds that support.
- Install and open TetherKit.
- Plug the phone in and turn on USB tethering in the phone's settings.
- Click Apply in TetherKit. net-merge adds the new network in a few seconds.
Start net-merge first, then connect the Android phone. macOS drops the TetherKit connection each time net-merge starts or quits. Pausing and resuming is safe: net-merge keeps its virtual adapter while paused. If the phone link disappears, click Apply in TetherKit again. The iPhone is not affected.
A phone uses its mobile data, so part of your traffic goes through it while net-merge runs. Quit net-merge when you do not want that.
Use it
- Start net-merge. A tray icon appears (menu bar on Mac).
- The icon is green when it is merging and grey when it is paused.
- It pauses by itself when fewer than two connections have internet, because there is nothing to
merge, and the menu says Paused: one connection. It starts again by itself when a second
connection works. If you pause or start it yourself, that choice wins: it will not start again after
you paused it. Untick Pause when there is only one connection in the menu to switch this off, or run
net-merge tray -auto-pause=false. - Hover the icon to see the speed of each connection and the total.
- Right-click the icon (on Mac, click it) to open the menu. It shows each connection's speed, how many connections net-merge gave it, and the buttons Pause merging / Start merging and Quit.
- To start it at sign-in: tick the box in the Windows installer, or run
net-merge autostart on.
Tips:
- Torrent clients already use every connection. Leave qBittorrent's network interface on Any interface.
- Leave Use all adapters (IPv6 only if every adapter has it) ticked. Untick it only if you must reach a site that only has IPv6.
net-merge listshows which connections are used and why others are skipped.net-merge statusshows live numbers.
Troubleshooting
A second connection does not make things faster
You only gain speed when each connection reaches the internet by its own path. Wi-Fi from your home router plus a phone on mobile data works. Wi-Fi and Ethernet plugged into the same router do not: they share one internet line, so the total stays the same.
Also remember that one connection always uses one link. Many parallel connections (Steam, browsers,
download managers) are what speed up. Run net-merge status to see how many connections each link carries.
A connection does not show up
Run net-merge list. It shows which connections are used and why the others are skipped, for example
"no default gateway" (the link has no internet yet).
- iPhone on a Mac: plug it in, tap Trust, and turn on Settings > Personal Hotspot > Allow Others to Join. If the iPhone USB network in System Settings > Network stays inactive, turn off its Disable unless needed switch.
- Android on a Mac: install TetherKit and click Apply (see above).
- Phone on Windows: if the phone does not appear in Network Settings, install your phone maker's USB driver.
The Android connection disappears on a Mac
macOS drops the TetherKit connection each time net-merge starts or quits (pausing and resuming is safe). Start net-merge first, then connect the phone. If it vanishes, click Apply in TetherKit again.
Windows uses only one network
Windows can switch Wi-Fi off when Ethernet is plugged in. Open the Group Policy Editor (gpedit.msc),
go to Computer Configuration > Administrative Templates > Network > Windows Connection Manager, and set
Minimize the number of simultaneous connections to the Internet or a Windows domain to Disabled.
macOS says it cannot open net-merge, or Windows says "protected your PC"
The apps are not code-signed yet. On macOS run xattr -d com.apple.quarantine net-merge. On Windows click
More info, then Run anyway.
The menu says "Paused: one connection"
net-merge only has something to do with two or more connections that have internet, so it waits. Plug in or connect the second one (see Add a second connection) and it starts by itself after a few seconds. To merge anyway, choose Start merging (it then stays on until a second connection has come and gone), or untick Pause when there is only one connection.
Switching merging on or off cuts the connections that are open at that moment, which is why it waits 10 seconds with nothing moving before pausing (2 minutes if a download or upload is still going) and 3 seconds before resuming, and never switches by itself more than once every 30 seconds.
I cannot find the tray icon
On Windows it may be behind the ^ arrow next to the clock. On macOS it is in the menu bar. On Linux the
desktop needs StatusNotifierItem support (KDE, XFCE, Cinnamon, LXQt, Budgie, or GNOME with the AppIndicator
and KStatusNotifierItem Support extension).
A site asks me to log in again
net-merge may use a different IP for each connection, and some sites tie your login to one IP. That is a limit of splitting connections over several links.
Commands
net-merge tray tray icon (the normal way to run it)
net-merge on | off start / pause merging in the running tray
net-merge quit pause and close the tray
net-merge status | list live numbers / which connections are used
net-merge autostart on|off|status
net-merge socks plain SOCKS5 proxy on 127.0.0.1:1080 (no admin, per app)
net-merge cleanup remove leftover routes after a crash
net-merge install macOS only: `sudo net-merge install` (see above)
More flags and details are in docs/DEVELOPING.md.
Good to know
- Needs admin (Windows),
CAP_NET_ADMIN(Linux) orsudo net-merge installonce (macOS). - Some sites tie your login to one IP. net-merge may use a different IP for each connection, so such a site can ask you to log in again.
- If your connections differ in IPv6 support, sites that only have IPv6 are not reachable while the box above is ticked.
More
- What changed in each version: CHANGELOG.md
- How it works, building from source, tests: docs/DEVELOPING.md
- Want to help? CONTRIBUTING.md. Found a security problem? SECURITY.md
- License: MIT, see
LICENSE. Third-party parts:THIRD-PARTY-NOTICES.md.
Support
net-merge is free. If it saves you time, you can buy me a coffee or donate with PayPal. Thank you!