TG WS Proxy
Android app for the local Telegram SOCKS5 proxy.
Foreground service
Starting
Running
Stopped
Configure the proxy settings, then start the foreground service.
Starting embedded Python proxy for %1$s:%2$d.
Foreground service active for %1$s:%2$d.
Android background limits
Ready
Needs attention
Battery optimization: disabled for this app.
Battery optimization: still enabled, Android may stop the proxy in background.
Background restriction: not detected.
Background restriction: enabled, Android may block long-running work.
Some phones also require manual vendor settings such as Autostart, Lock in recents, or Unrestricted battery mode.
Proxy endpoint
Advanced
Actions
Updates
v%1$s
Check for updates on launch
Checking GitHub release…
Not checked yet
Automatic update checks are disabled.
Installed version %1$s matches the latest GitHub release.
Installed version %1$s is newer than the latest GitHub release.
Version %1$s is available on GitHub (installed: %2$s).
Update check failed: %1$s
Open Release Page
Proxy host
Proxy port
DC to IP mappings (one DC:IP per line)
Max log size before rotation (MB)
Socket buffer size (KB)
WS pool size per DC
Verbose logging
Save Settings
Start Service
Stop Service
Restart Proxy
Open in Telegram
Open Logs
Disable Battery Optimization
Open App Settings
Last service error
Failed to open release page.
Settings saved
Foreground service start requested
Foreground service restart requested
Telegram app was not found for tg://socks.
TG WS Proxy
Proxy service
Keeps the Telegram proxy service alive in the foreground.
SOCKS5 %1$s:%2$d • starting embedded Python
SOCKS5 %1$s:%2$d • proxy active
%1$s:%2$d
DC mappings: %1$d\nTraffic: ↑ %2$s/s ↓ %3$s/s\nTransferred: ↑ %4$s ↓ %5$s
Stop
Saved proxy settings are invalid.
Failed to start embedded Python proxy.
Proxy runtime stopped unexpectedly.
Proxy Logs
Shows the latest lines from the embedded Python proxy log.
Log file
Refresh Logs
Close
The log file is empty or has not been created yet.
Failed to read log file: %1$s
Showing the last part of the log file.