Skip to content

tg-ws-proxy

A local proxy that helps Telegram load when it is partly blocked.

Stars
10.9k
Forks
588
Licence
MIT
Language
Python
Last update
5 days ago
Type
App

What it is

TG WS Proxy is a small program that runs on your own computer as a local MTProto proxy for Telegram. Based on its description, it aims to partially bypass blocks so Telegram loads, and it ships as ready-made downloads for Windows, macOS and Linux. The README was not included in the material provided, so details beyond this are unverified.

  • Run it locally and point Telegram's proxy settings at it to try to load Telegram
  • Download a prebuilt executable for your operating system instead of building from source

Great for

  • Telegram users on networks where Telegram loading is partly blocked
  • People who want a downloadable program rather than setting up a server
  • Users on Windows, macOS or Linux who need a local proxy option

Not ideal for

  • Anyone looking for a full VPN covering all traffic, since the description only mentions partial bypassing of Telegram loading
  • Users who need verified security guarantees, because the README was not available to confirm how traffic is handled
  • People who want a fully documented setup guide, since no install steps could be checked
Step-by-step guide: how to use tg-ws-proxyInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Download the app

    Clone the repository

    git clone https://github.com/Flowseal/tg-ws-proxy
  2. 2

    Run it

    • Download the file for your system from the latest release page
    • Run the program and follow any on-screen instructions
    • Configure Telegram to use the local proxy as described in the project's documentation
  3. 3

    Get the most out of it

    • Check the project README for the exact proxy address and port to enter in Telegram
    • Use the release builds matching your operating system to avoid compiling from source

Downloads

Strengths

  • Released under the MIT license, which permits free use and modification
  • Provides prebuilt downloads for several operating systems
  • Has a large community following with over 10,000 stars on GitHub

Trade-offs

  • The README was truncated, so the setup and behavior are not fully documented here
  • It only addresses partial Telegram blocking, not general internet access
  • Security and privacy properties could not be verified from the material provided

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.