Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Flowseal/tg-ws-proxy/llms.txt

Use this file to discover all available pages before exploring further.

TG WS Proxy is a local MTProto proxy that routes Telegram Desktop traffic over WebSocket connections. On Windows, it ships as a self-contained executable that lives in the system tray, so no installation wizard or admin rights are required — just download and run.

​
Downloads

Grab the build that matches your Windows version from the releases page:
FileTarget
TgWsProxy_windows.exeWindows 10 and later
TgWsProxy_windows_7_64bit.exeWindows 7 (64-bit)
TgWsProxy_windows_7_32bit.exeWindows 7 (32-bit)
All binaries are built automatically from the public source code via GitHub Actions.
Some antivirus engines flag PyInstaller-bundled executables as suspicious. If Windows Defender or another AV quarantines the file, you can verify the binary on VirusTotal, add it to your AV exclusions, or switch to the Windows 7 build, which is compiled with an older toolchain that tends to trigger fewer heuristic warnings. The full source code is publicly available for review.

​
First Launch

When you run the executable for the first time, a window opens showing the connection details (server, port, and secret) along with instructions for setting up Telegram Desktop. After you close that window, the application minimises to the system tray and continues running in the background. If a newer version is available on GitHub, you may see a prompt asking whether you would like to open the release page. This check can be disabled at any time in Settings.

​
Tray Menu

Right-click the tray icon to access all proxy controls:
ItemDescription
Open in TelegramLaunches Telegram Desktop and automatically applies the proxy via a tg://proxy link
Copy LinkCopies the tg://proxy connection link to the clipboard
Restart ProxyRestarts the proxy process without quitting the tray app
Settings…Opens the GUI configuration editor — manage the secret, port, autostart, and update checks
Open LogsOpens the log file in your default text editor
ExitStops the proxy and closes the application

​
Connect Telegram Desktop

​
Automatic

Click Open in Telegram in the tray menu. Telegram Desktop will open a dialog asking you to confirm the proxy configuration — click Enable and you are done. If Telegram does not open automatically, use the fallback:
1

Copy the link

Right-click the tray icon and choose Copy Link.
2

Send to Saved Messages

In Telegram Desktop, open your Saved Messages chat and paste the link there, then send it.
3

Activate the proxy

Click the link inside Saved Messages. Telegram will prompt you to enable the proxy — confirm to connect.

​
Manual

1

Open Telegram proxy settings

In Telegram Desktop go to Settings → Advanced → Connection type, then select Use custom proxy.
2

Add a new proxy

Click Add proxy and fill in the fields:
  • Type: MTProto
  • Server: 127.0.0.1
  • Port: 1443
  • Secret: copy from the first-launch window, the Settings dialog, or the log file
3

Save and connect

Click Save, then select the newly added proxy and click Enable.
If you changed the default host or port in Settings, use those values instead of 127.0.0.1 and 1443.

​
Autostart

Windows builds support launching TG WS Proxy automatically when you log in. Enable or disable autostart from Settings — the app writes a registry entry under HKCU\Software\Microsoft\Windows\CurrentVersion\Run so it starts with your user session without requiring admin privileges.

Build docs developers (and LLMs) love

Get started for freeTalk to us