tdlib

td: Build Cross-Platform Telegram Clients with TDLib

TDLib is Telegram's cross-platform C++ library for building Telegram clients, with interfaces usable from many programming languages. It handles networking, encryption, and local data storage across desktop, mobile, and other platforms.

Stars
9.2k
Forks
2.2k
Stars, last 30 days
+111
Last commit
3 days ago
Contributors
87

Our take

Activeregular commits

Health score

58/100

How it is scored
Activity
52
Community
46
Issues
91
Pull requests
41

+111 stars in the last 30 days

  • Closes issues faster than 81% of the projects we track
  • More contributors than 75% of the projects we track

TDLib is an actively maintained, broadly usable client library, though its recent contribution history is highly concentrated and it has had no release in over a year.

Good fit if

  • You are building a Telegram client and want TDLib to handle networking, encryption, and local storage.
  • Your target environment can build its C++17 code and provide OpenSSL and zlib.
  • You can work with its JSON, C++, Java, or .NET interfaces and validate changes against your target platforms.

Look elsewhere if

  • You need a general-purpose messaging library rather than a library for Telegram clients.
  • Your project cannot accommodate a C++17 build and the listed dependencies.
  • You require frequent published releases or a project whose development is not concentrated around one contributor.
All health signals
Last commit2026-10-27 (3 days ago)
Commits, last 90 days100+
Releases, last 12 months0
Contributors87 (top contributor: 96% of commits)
Issues closed, last 90 days33 (typically closed in 0 days)
Pull requests merged, last 90 days17 (typically merged in 2 days)
Project age8 years

Checked on 2026-10-31 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

9,297

Forks

2,243

Change since Nov 17, 2026: +3 stars·+3 forks

Overview

TDLib (Telegram Database library) is Telegram's cross-platform library for building Telegram clients. It handles networking, encryption, and local data storage so client developers can focus on application behavior rather than implementing those systems themselves. Its interfaces support C++, Java, .NET, and a C-based JSON interface usable from many other languages.

The project targets Android, iOS, Windows, macOS, Linux, BSD variants, and other listed platforms. It is intended for developers building Telegram clients who need asynchronous requests and ordered updates across platforms.

Key Features

  • Handles Telegram client networking, encryption, and local data storage.
  • Provides asynchronous requests and delivers updates in order.
  • Offers a C++ interface, Java bindings through JNI, and .NET bindings.
  • Includes a JSON interface that can be called from languages able to execute C functions.
  • Supports a broad range of desktop, mobile, and other platforms, including WebAssembly.
  • Encrypts local data using a user-provided encryption key.
  • Documents API methods and public interfaces, with generated API documentation and examples.

Use Cases

  • A team building a Telegram client for multiple operating systems can use TDLib to share core messaging functionality across platforms.
  • A C++ application that needs direct access to Telegram client methods can use the native C++ interface.
  • Java or .NET developers building Telegram applications can use the provided language bindings.
  • A project written in another language that can call C functions can integrate the JSON interface instead of writing a native binding.

What you need

Detected in the repository

  • C++ (main language on GitHub)
  • A test suite

License in plain words

BSL-1.0

Read the LICENSE file before using it in a product.

Getting Started

Install the dependencies, then build from the repository root:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

See the README and build instructions generator for platform-specific setup and language examples.

Considerations

The project is active, with regular recent commits and ongoing issue and pull-request handling, but its contributor activity is highly concentrated in one person. There have been no releases in over a year, so teams should check the current API and pin or validate the version they adopt. Building requires a C++17-compatible compiler, OpenSSL, zlib, and CMake; Java and .NET integrations have additional platform-specific constraints. The repository identifies its license as BSL-1.0, so review the license terms for your intended use.

Found this useful?

Share it with someone who would like td.