Improve link to examples.
|6 days ago|
|CMake||4 months ago|
|benchmark||3 weeks ago|
|example||1 week ago|
|memprof||7 months ago|
|sqlite||4 months ago|
|td||1 week ago|
|tdactor||1 week ago|
|tddb||1 month ago|
|tdnet||1 week ago|
|tdtl||1 month ago|
|tdutils||1 week ago|
|test||1 week ago|
|.clang-format||11 months ago|
|.gitattributes||1 month ago|
|.gitignore||1 year ago|
|.travis.yml||1 year ago|
|CHANGELOG.md||1 week ago|
|CMakeLists.txt||1 week ago|
|Doxyfile||1 year ago|
|LICENSE_1_0.txt||1 year ago|
|README.md||6 days ago|
|SplitSource.php||1 week ago|
|TdConfig.cmake||1 year ago|
|bitbucket-pipelines.yml||5 months ago|
|build.html||1 week ago|
|format.ps1||1 year ago|
|format.sh||1 year ago|
|gen_git_commit_h.ps1||1 year ago|
|gen_git_commit_h.sh||1 year ago|
|src.ps1||8 months ago|
|src.sh||8 months ago|
|tdclientjson_export_list||1 year ago|
TDLib (Telegram Database library) is a cross-platform library for building Telegram clients. It can be easily used from almost any programming language.
TDLib has many advantages. Notably
TDLibcan be used on Android, iOS, Windows, macOS, Linux, FreeBSD, OpenBSD, NetBSD, Windows Phone, WebAssembly, watchOS, tvOS, Tizen, Cygwin. It should also work on other *nix systems with or without minimal effort.
TDLibcan be easily used with any programming language that is able to execute C functions. Additionally it already has native Java (using
JNI) bindings and .NET (using
TDLibtakes care of all network implementation details, encryption and local data storage.
TDLibinstance handles more than 24000 active bots simultaneously.
TDLibAPI methods and public interfaces are fully documented.
TDLibguarantees that all updates are delivered in the right order.
TDLibremains stable on slow and unreliable Internet connections.
TDLibdon’t block each other or anything else, responses are sent when they are available.
Take a look at our examples.
See our Getting Started tutorial for a description of basic TDLib concepts.
See a TDLib build instructions generator for detailed instructions on how to build TDLib.
TDLib depends on:
The simplest way to build
TDLib is to use our TDLib build instructions generator.
You need only to choose your programming language and target operating system to receive complete build instructions.
mkdir build cd build cmake -DCMAKE_BUILD_TYPE=Release .. cmake --build .
TDLib on low memory devices you can run SplitSource.php script
before compiling main
TDLib source code and compile only needed targets:
mkdir build cd build cmake -DCMAKE_BUILD_TYPE=Release .. cmake --build . --target prepare_cross_compiling cd .. php SplitSource.php cd build cmake --build . --target tdjson cmake --build . --target tdjson_static cd .. php SplitSource.php --undo
In our tests clang 6.0 with libc++ required less than 500 MB of RAM per file and GCC 4.9/6.3 used less than 1 GB of RAM per file.
brew install gperf cmake openssl
TDLibwith CMake as explained in building. You will likely need to manually specify path to the installed OpenSSL to CMake, e.g.,
cmake -DCMAKE_BUILD_TYPE=Release -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl/ ..
TDLibdependencies using vcpkg:
cd <path to vcpkg> .\vcpkg.exe install openssl:x64-windows openssl:x86-windows zlib:x64-windows zlib:x86-windows
TDLibwith CMake as explained in building, but instead of
cmake -DCMAKE_BUILD_TYPE=Release ..use
cmake -DCMAKE_TOOLCHAIN_FILE=<path to vcpkg>\scripts\buildsystems\vcpkg.cmake ..
To build 32-bit/64-bit
TDLib using MSVC, you will need to additionally specify parameter
-A x64 to CMake.
TDLib in Release mode using MSVC, you will need to additionally specify parameter
--config Release to the
cmake --build . command.
For C++ projects that use CMake, the best approach is to build
TDLib as part of your project or to use a prebuilt installation.
There are several libraries that you could use in your CMake project:
For example, part of your CMakeLists.txt may look like this:
add_subdirectory(td) target_link_libraries(YourTarget PRIVATE Td::TdStatic)
Or you could install
TDLib and then reference it in your CMakeLists.txt like this:
find_package(Td 1.5.0 REQUIRED) target_link_libraries(YourTarget PRIVATE Td::TdStatic)
TDLib provides native Java interface through JNI. To enable it, specify option
-DTD_ENABLE_JNI=ON to CMake.
See example/java for example of using
TDLib from Java and detailed build and usage instructions.
TDLib provides native .NET interface through
C++/CX. To enable it, specify option
-DTD_ENABLE_DOTNET=ON to CMake.
.NET Core doesn’t support
C++/CLI, so if .NET Core is used, then
TDLib JSON interface should be used through P/Invoke instead.
See example/csharp for example of using
TDLib from C# and detailed build and usage instructions.
See example/uwp for example of using
TDLib from C# UWP application and detailed build and usage instructions for Visual Studio Extension “TDLib for Universal Windows Platform”.
TDLib is built with
TD_ENABLE_DOTNET option enabled,
C++ documentation is removed from some files. You need to checkout these files to return
C++ documentation back:
git checkout td/telegram/Client.h td/telegram/Log.h td/tl/TlObject.h
TDLib provides efficient native C++, Java, and .NET interfaces.
But for most use cases we suggest to use the JSON interface, which can be easily used with any programming language that is able to execute C functions.
See td_json_client and td_log documentation for detailed JSON interface description,
the td_api.tl scheme or the automatically generated HTML documentation for a list of
TDLib methods and classes.
TDLib JSON interface adheres to semantic versioning and versions with the same major version number are binary and backward compatible, but the underlying
TDLib API can be different for different minor and even patch versions.
If you need to support different
TDLib versions then you can use a value of the
version option to find exact
TDLib version and to use appropriate API then.
See example/python/tdjson_example.py for an example of such usage.
TDLib is licensed under the terms of the Boost Software License. See LICENSE_1_0.txt for more information.