Our take
Activeregular commits- 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 commit | 2026-10-27 (3 days ago) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 0 |
| Contributors | 87 (top contributor: 96% of commits) |
| Issues closed, last 90 days | 33 (typically closed in 0 days) |
| Pull requests merged, last 90 days | 17 (typically merged in 2 days) |
| Project age | 8 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.
Stars
9,297Forks
2,243Change 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.