English
TG WS Proxy icon

TG WS Proxy

Telegram MTProto WebSocket Bridge Proxy

Promotes non-free network services

Developer
Ivan Utenkov
License
MIT
Package
io.github.valnesfjord.tgwsproxyrs
Category
Connectivity, Internet, VPN & Proxy
Latest version
2.7.0 · Nov 9, 2026
Minimum Android
Android 8.0

Download 2.7.0

Screenshots

TG WS Proxy screenshot 1

Description

Telegram MTProto WebSocket Bridge Proxy — a Rust vibecoded port of
Flowseal/tg-ws-proxy.

Listens for Telegram Desktop's MTProto connections on a local port and
tunnels them through WebSocket (TLS) connections to Telegram's DC servers.

Telegram channel: @tgwsproxy_rs.

Telegram Desktop → MTProto (TCP 1443) → tg-ws-proxy-rs → WS (TLS 443) → Telegram DC
↘ CF proxy (kws{N}.{cf-domain}) → Telegram DC (WS via Cloudflare)
↘ CF Worker (*.workers.dev) → Telegram DC (TCP tunnel via Cloudflare)
↘ upstream MTProto proxy → Telegram DC (WS fallback)
↘ direct TCP :443 → Telegram DC (last resort)

Android app

A minimal Jetpack Compose wrapper around the same core the CLI runs. Type the
flags you would pass to tg-ws-proxy, tap Start, and when the tg://proxy
link appears tap it (or let the app open it) to add the proxy in Telegram.

The listen address should be 127.0.0.1 so Telegram on the same phone can
connect.

Add --secret <32 hex chars> if you want the link to stay the same across
restarts. --log-file is ignored; logs go to the on-screen view and logcat
(tg-ws-proxy).

The default arguments carry --quiet, so the on-screen Log panel stays
empty until you remove it. That is the default and not a failed start: drop
--quiet (or swap it for --verbose) before tapping Start to see log
lines. The tg:// link appears either way — it reaches the UI from the listen
callback rather than by scraping the log, so --quiet never hides it.

All versions

VersionReleasedMinimum AndroidSize
2.7.0 (3 builds) Nov 9, 2026 Android 8.0 6.3 MB
2.6.0 (3 builds) Nov 6, 2026 Android 8.0 5.7 MB
2.5.12 (3 builds) Nov 4, 2026 Android 8.0 5.6 MB
2.5.8 (3 builds) Oct 29, 2026 Android 8.0 5.6 MB
2.5.6 (3 builds) Oct 22, 2026 Android 8.0 5.5 MB
2.5.4 (3 builds) Oct 14, 2026 Android 8.0 5.5 MB
2.5.2 (3 builds) Oct 8, 2026 Android 8.0 5.5 MB
2.5.1 (3 builds) Oct 5, 2026 Android 8.0 5.5 MB
2.5.0 (3 builds) Oct 2, 2026 Android 8.0 5.5 MB

From the developer (GitHub)

APK files published by the developer on GitHub. They are signed by the developer and may not install over the other builds on this page (different signature). Links open github.com.

Similar apps