yaog6700-bit/swell-box — explained in plain English
Analysis updated 2026-05-18
Manage a sing-box proxy connection from a tray icon instead of the command line.
Import proxy nodes or subscription links and switch between multiple saved configurations.
Route traffic so local destinations go direct and everything else goes through the proxy.
Build platform-specific offline installer packages for Windows, macOS, and Linux via GitHub Actions.
Linux builds need libgtk-3-dev and libayatana-appindicator3-dev for the tray icon to work.
Swell-Box is a lightweight desktop application that sits in your system tray and controls sing-box, a separate proxy engine. Rather than reimplementing that engine, Swell-Box runs the official sing-box program as a background process and gives it a small, easy to use tray menu plus the official web dashboard for viewing connections. From the tray you can start, stop, or restart the proxy, and import a node using a share link, a subscription URL, or a full configuration file, covering formats like ss, vmess, vless, trojan, and several others. You can switch between multiple saved configurations, edit them, and update the sing-box core to a stable or pre-release version. By default it routes traffic in China directly and sends everything else through the proxy, using local rule files to make that decision. There is also a TUN mode you can toggle from the tray, Chinese and English interface languages, and options to launch at login and set the system proxy automatically. Swell-Box runs on Windows 10 and later, on Apple Silicon Macs running macOS 12 or newer, and on modern Linux desktops, though Linux needs a couple of tray and app indicator libraries installed to display its icon. If the sing-box core is missing it downloads the official binary automatically the first time it needs network access. Its data and logs live in a hidden folder in your home directory. Building it yourself requires Go 1.22 or later, and the README gives both local build commands and cross compile examples for each supported platform, along with a recommended GitHub Actions setup that produces full offline zip packages for every target on a tagged release. The README also walks through fixing a common macOS problem where the system proxy setting is left pointing at the core after it has stopped. Swell-Box itself is released under the MIT license, while the sing-box engine it wraps is GPL-3.0 and distributed separately. The README notes it is meant for technical and educational use and that users should follow local laws and their network provider's terms.
A system tray app for Windows, macOS, and Linux that runs and controls the sing-box proxy engine through a simple menu and dashboard.
Mainly Go. The stack also includes Go, sing-box.
Swell-Box itself is MIT licensed, free to use and modify, the sing-box engine it wraps is separately licensed under GPL-3.0.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.