gitwtfhub

wtf is swell-box?

yaog6700-bit/swell-box — explained in plain English

Analysis updated 2026-05-18

15GoAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A system tray app for Windows, macOS, and Linux that runs and controls the sing-box proxy engine through a simple menu and dashboard.

Mindmap

mindmap
  root((repo))
    What it does
      Tray control for sing-box
      Node and config import
      Split routing
    Tech stack
      Go
      sing-box
    Use cases
      Manage proxy from tray
      Switch configs
      Build offline installers
    Audience
      Developers
      Power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Manage a sing-box proxy connection from a tray icon instead of the command line.

REASON 2

Import proxy nodes or subscription links and switch between multiple saved configurations.

REASON 3

Route traffic so local destinations go direct and everything else goes through the proxy.

REASON 4

Build platform-specific offline installer packages for Windows, macOS, and Linux via GitHub Actions.

What's in the stack?

Gosing-box

How it stacks up

yaog6700-bit/swell-box15515151/noblackbunnymq/bunnymq
Stars151515
LanguageGoGoGo
Setup difficultymoderateeasyhard
Complexity3/53/55/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Linux builds need libgtk-3-dev and libayatana-appindicator3-dev for the tray icon to work.

Swell-Box itself is MIT licensed, free to use and modify, the sing-box engine it wraps is separately licensed under GPL-3.0.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Help me cross compile Swell-Box for macOS arm64 using the build commands in this README.
Prompt 2
Explain what TUN mode does in Swell-Box and how to enable it safely.
Prompt 3
Walk me through fixing the macOS 'opened but no internet' issue described in this repo.
Prompt 4
Show me how the GitHub Actions release workflow packages the full offline zips for each platform.

Frequently asked questions

wtf is swell-box?

A system tray app for Windows, macOS, and Linux that runs and controls the sing-box proxy engine through a simple menu and dashboard.

What language is swell-box written in?

Mainly Go. The stack also includes Go, sing-box.

What license does swell-box use?

Swell-Box itself is MIT licensed, free to use and modify, the sing-box engine it wraps is separately licensed under GPL-3.0.

How hard is swell-box to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is swell-box for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.