About this project

Throne is a cross-platform desktop GUI proxy utility built with Qt and powered by sing-box. It runs on Windows 11/10/8/7, Linux and macOS, and is distributed as portable ZIP archives plus Linux packages, including a CLI installer script and an RPM repository for Fedora/RHEL and openSUSE/SLE. The project positions itself as a continuation of the original Nekoray client, which was archived after its developer partially abandoned it in December 2023. Throne keeps the general approach while adding features, removing obsolete parts and simplifying where possible. Protocol support is broad: SOCKS, HTTP(S), Shadowsocks, Trojan, VMess, VLESS, TUIC, Hysteria, Hysteria2, AnyTLS, Mieru, Snell, NaïveProxy, Juicity, TrustTunnel, ShadowTLS, Wireguard, AmneziaWG, MASQUE, SSH, Xray VLESS, OpenVPN/OpenConnect, custom outbounds and custom configs for both sing-box and Xray, outbound chaining, and an extra core option. Subscriptions can be imported from share links, various JSON representations of sing-box configs, the v2rayN link format, and with limited support for Shadowsocks and Clash formats. Deeplinks are also supported and documented on the project site. Operationally, Throne can manage a system TUN interface, which requires root privileges on Linux. The app offers built-in privilege escalation that sets the core setuid-root; this can be disabled in Basic Settings under Security, at the cost of losing root-dependent features unless permissions are granted manually. On macOS, releases are unsigned, so users must remove the quarantine attribute with xattr and move the app to /Applications before first launch, because the privilege escalation step opens Terminal and can fail from ~/Downloads. The README also addresses common concerns: antivirus false positives are attributed to the self-update mechanism replacing files and to the System DNS feature changing system DNS settings. If the app is force-quit while System proxy is enabled, the proxy settings may remain applied; the documented fix is to reopen Throne, enable System proxy, then disable it. Downloadable route profiles and rulesets come from a separate routeprofiles repository. Two Debian package variants exist: one relies on host-installed Qt libraries and is smaller, while the other bundles Qt and is roughly three times larger. The system-Qt variant is intended for legacy systems whose provided Qt libraries use unsupported features. Credits include sing-box, Xray-core, Qv2ray, Qt, simple-protobuf, fkYAML, quirc, QHotkey and sqlitecpp.