Agent skill · software engineering · aradotso
tg-ws-proxy-telegram-socks5
Local SOCKS5 proxy server that accelerates Telegram Desktop by routing traffic through WebSocket connections to Telegram DCs
Why this skill is useful
Adds executable scripts for setting up a local SOCKS5 proxy with WebSocket connections specifically for Telegram, which are not commonly found in public documentation.
What it needs
Requires git, pip installed locally. About 4k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
TG WS Proxy Skill by ara.so — Daily 2026 Skills collection. TG WS Proxy is a local SOCKS5 proxy server for Telegram Desktop that reroutes traffic through WebSocket (WSS) connections to Telegram's Data Centers, bypassing network-level blocking without external servers. --- How It Works 1. Starts a local SOCKS5 proxy on 127.0.0.1:1080 2. Intercepts connections to Telegram IP addresses 3. Extracts DC ID from MTProto obfuscation init packet 4. Opens a WebSocket (TLS) connection to the matching DC via Telegram domains 5. Falls back to direct TCP if WebSocket returns a 302 redirect --- Installation From Source (All Platforms) Run Console Proxy (No GUI) Run with Tray GUI Linux — AUR (Arch-based) Linux — systemd CLI Linux — .deb Download TgWsProxylinuxamd64.deb from releases and install: Linux — binary --- CLI Reference Argument Default Description --- --- --- --port 1080 SOCKS5 proxy port --host 127.0.0.1 SOCKS5 proxy bind host --dc-ip 2:149.154.167.220, 4:149.154.167.220 Target IP per DC ID (repeat for multiple) -v, --verbose off Enable DEBUG logging Examples --- Configuration File The tray application stores config in a platform-specific location: Windows: %APPDATA%/TgWsProxy/config.json macOS: ~/Library/Application Support/TgWsProxy/config.json Linux: ~/.config/TgWsProxy/config.json (or $XDGCONFIGHOME/TgWsProxy/config.json) config.json structure --- pyproject.toml Script Registration CLI entry points are declared in pyproject.toml: --- Connecting Telegram Desktop Manual Setup 1. Open Telegram Desktop 2. Go to Settings → Advanced → Connection type → Use custom proxy 3. Click Add Proxy and set: Type: SOCKS5 Server: 127.0.0.1 Port: 1080 Username/Password: leave empty 4. Click Save and enable the proxy Automatic (Tray GUI) Right-click the tray icon → "Открыть в Telegram" — this opens a tg://socks deep link that auto-configures Telegram Desktop. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/tg-ws-proxy-telegram-socks5