Socksicle
Install

A proxy client for Windows and Linux.

Desktop GUI built on PySide6 with native Material 3. Supports Shadowsocks, VLESS, VMess, Hysteria 2, TUIC and system TUN. Connects directly to your own nodes without accounts or third-party servers.

Terminal Install Download GitHub

Open source under MIT license.

Socksicle main window, connected, with the server list below

Supported protocols

Links are parsed, validated and dispatched to the engine best suited for them.

Protocol Engine Notes
Shadowsocks sing-box, Xray SIP003 plugins are parsed but not forwarded to cores
VLESS sing-box, Xray XHTTP transport requires Xray
VMess sing-box, Xray TCP, WebSocket and gRPC
Hysteria 2 sing-box Obfs needs both the type and the password
Trojan sing-box Standard TLS transport
TUIC sing-box TUIC v5

Accepted links ss:// vless:// vmess:// hysteria2:// hy2:// trojan:// trojan-go:// tuic:// tws3://

The app

Home, settings and about.

Home screen with the power button, routing filter and server list
Home Power, mode and the active server.
Settings screen with connection, tunnel, ping and appearance options
Settings Grouped by what you are trying to change.
About screen with version, core version and the TwinSock key
About Version, core and your TwinSock key.

How to install

Fast and simple setup across Linux and Windows.

One-line automated installer

Downloads the binary, sets up desktop integration, and configures permissions automatically:

curl -fsSL https://iwtsd.online/socksicle/get | bash
or download standalone AppImage:
Download AppImage chmod +x Socksicle-*-x86_64.AppImage && ./Socksicle-*-x86_64.AppImage

Download

Version 0.1.1 for Windows x64 and Linux x86_64. Prebuilt releases bundle sing-box.

TUN mode needs Administrator on Windows (wintun.dll ships with the build) and pkexec on Linux. Xray is optional: put it in bin/xray/ or your PATH.

Frequently Asked Questions

Everything you need to know about Socksicle.

Is it free?

Yes. Socksicle is MIT licensed and the source is on GitHub. There is no paid tier and no account. sing-box and Xray are separate projects with their own licences.

Does it work with my subscription?

If your provider gives you an HTTPS URL that returns plain text, Base64 or SIP008 JSON, yes. Import it once and Socksicle refreshes nodes on a schedule with SSRF protection.

Do I have to install sing-box or Xray?

No. Release builds bundle sing-box. Xray is optional: install it into bin/xray/ or your PATH if you need XHTTP or want to compare engines.

What does TUN mode require?

Administrator privileges on Windows and pkexec on Linux, because the app has to create a virtual network adapter. SOCKS5 mode needs neither.

Where is my data stored?

Locally. %APPDATA%\socksicle\ on Windows and ~/.config/socksicle/ on Linux. Nothing is uploaded. The privacy policy ships with the app and lives in the repository.

Is there a macOS build?

Not yet. macOS is explicitly unsupported in this repository, and there is no build for it.