FPTG
GitHub

Unofficial Telegram client

Telegram that gets through.

FPTG is an unofficial Telegram client built on the Telegram API, split in two: a small server on your VPS talks to Telegram, and your computer talks only to your server β€” over a single encrypted WebSocket that looks like any other HTTPS site.

Get startedHow it works
  • TLS, always
  • One port
  • No VPN, no proxy apps

FPTG uses the Telegram API and is not affiliated with or endorsed by Telegram.

Why it works

Filters block Telegram. Not the whole web.

Network filters recognise Telegram by where it connects and how its traffic looks. FPTG never lets your computer touch Telegram at all.

The official app

Connects straight to Telegram's servers with its own protocol. Known addresses, recognisable traffic β€” easy to throttle or cut off.

VPNs and proxies

Work until their protocols are fingerprinted, and they reroute everything you do β€” often through someone else's server.

FPTG

One wss:// connection to a server you own. Standard TLS, a single port, nothing Telegram-shaped on the wire.

How it works

Two programs, one quiet connection

The heavy lifting runs on your VPS outside the filtered network. Your desktop only draws the interface and talks to that server.

  1. 01

    Server on a VPS

    The FPTG server runs the official TDLib library, keeps your chats in sync and serves them over HTTPS and WebSocket. Console version for a headless VPS, or one with a small control window.

  2. 02

    Client on your desktop

    The FPTG client is a native window with a tray icon, desktop notifications, a call window and bot mini apps. It holds no Telegram data β€” just the address of your server and a sign-in token.

  3. 03

    One encrypted pipe

    Everything goes through one TLS connection to one port. The client pins the server's certificate fingerprint, so nobody in between can pose as your server.

Features

A full Telegram client, not a workaround

Built on TDLib, Telegram's own library β€” the same one official apps use. Your account, chats and contacts behave exactly as you expect.

Chats, groups and channels

Folders, replies, albums, polls, file transfer by drag and drop, link previews, a media viewer and a jump-to-date in history.

Stickers, emoji, GIFs

Your sets, recents and saved GIFs, loaded only when you open the panel.

Calls

Incoming calls pop up in their own small window.

Bots and mini apps

Inline keyboards, bot commands and Telegram mini apps in a separate window.

Several accounts

Keep personal and work numbers side by side on one server.

Desktop notifications

Message cards on your desktop and a tray icon. Close the window β€” it keeps watching.

Themes and accents

Dark and light themes, your accent colour, window frames to match.

Any browser, too

Away from your desk? The server serves the same interface to a normal browser.

Traffic and storage

See how much you send and receive, and clean the server's cache in one click.

The name

Why β€œFPTG”?

FP is for Free Pascal, TG is for Telegram: FPTG is an unofficial Telegram client written in Free Pascal. Both programs β€” the server on your VPS and the client on your desktop β€” are Free Pascal code, built with the Lazarus IDE.

FP Free Pascal the open-source Object Pascal compiler both programs are written in
TG Telegram the service it connects you to β€” as an unofficial client, through the Telegram API

  • Native code, nothing to install

    Free Pascal compiles straight to machine code. There is no .NET, Java, Node.js or Python runtime to put on your VPS: the server is one executable next to TDLib.

  • Pascal around TDLib

    The Telegram protocol itself is handled by TDLib, Telegram's official library. Everything around it is Free Pascal: the server, the bridge to the interface, HTTPS and WebSocket, sign-in, the desktop window, tray and notifications.

  • Lazarus and a web interface

    The desktop parts use Lazarus, the open-source IDE and component library for Free Pascal. The chat interface itself is a web page shown in WebView2 β€” which is why the same interface also opens in any browser.

  • One codebase, many systems

    Free Pascal targets Windows, Linux and macOS from the same source. FPTG runs on Windows today; a Linux version is in development and will be available soon.

Setup

Up and running in ten minutes

You need a small VPS somewhere Telegram isn't blocked, and a computer with 64-bit Windows 10 or 11.

  1. Copy the server to your VPS

    Unpack fptg-server.exe together with tdjson.dll and its companion libraries into one folder.

  2. Create your user

    The server belongs to one person. Pick a login; it will ask for a password.

    > fptg-server.exe --set-user=alice

  3. Start it

    It prints the address, port and certificate fingerprint β€” keep them for the next step. Port 443 makes it blend in best.

    > fptg-server.exe --server-port=443

    Have a domain? Bring your own certificate with --cert and --key. Prefer a window to a console? Run fptg-server-gui.exe β€” same server, with start/stop and a tray icon.

Your server, your rules

No middleman you didn't choose

There is no FPTG cloud. The only machines involved are your computer, your VPS and Telegram itself.

  • Encrypted on the wire

    TLS on every connection, no plain-HTTP fallback. Your provider sees one encrypted session to one address.

  • Pinned certificate

    The desktop client remembers your server's fingerprint and refuses an impostor.

  • One owner, revocable sessions

    A single user per server. Short-lived tokens; sign out everywhere with one command.

  • Settings encrypted at rest

    Configuration files on both machines are encrypted with a key protected by Windows.

FAQ

Questions, answered

Is FPTG an official Telegram app?

No. FPTG is an unofficial Telegram client. It works through the Telegram API using TDLib, the library Telegram publishes for third-party apps, and it is not affiliated with, endorsed or sponsored by Telegram. You sign in with your usual Telegram account.

What does FPTG stand for?

Free Pascal + Telegram. FPTG is an unofficial Telegram client, and both of its programs are written in Free Pascal. More about the name.

Why does it work when Telegram itself is blocked?

Blocking targets Telegram’s addresses and the shape of its traffic. Your computer never connects to Telegram β€” only to your VPS, over a standard encrypted WebSocket, the same technology countless websites use. The VPS sits outside the filtered network and does the talking to Telegram.

Do I still need a VPN?

No. Only Telegram goes through your server; the rest of your traffic stays as it is.

What kind of VPS do I need?

A small one is enough: the server is a single executable with TDLib next to it. What matters most is location β€” pick a provider in a country where Telegram is reachable.

The client can't reach my server. Do I need to open a port?

Probably. The server listens on one TCP port β€” the one you chose with --server-port, or 7654 by default β€” and incoming connections to it may be blocked by a firewall. Allow that port in Windows Firewall on the VPS:

> netsh advfirewall firewall add rule name="FPTG" dir=in action=allow protocol=TCP localport=443

Replace 443 with your port. Many providers also have their own firewall or security group in the control panel β€” open the same port there.

Can my family share one server?

A server holds one person’s Telegram data, so it has exactly one user. That user can add several Telegram accounts.

The free version runs one server per computer. Running several server instances on one machine β€” one for each family member β€” will be part of a paid version. We’ll announce it separately when it’s released. Until then, another person needs their own VPS.

Does it work on a phone?

The desktop app is for Windows. On any other device, open your server’s address in a browser β€” you get the same interface.

A Linux version is in development and will be available soon.

Stay in touch, wherever you are.

Free to use. Get the server and the client, and keep your chats flowing.

DownloadSource on GitHub