[github-license-mit]: https://github.com/FedericoBruzzone/tdlib-rs/blob/main/LICENSE-MIT
[github-license-apache]: https://github.com/FedericoBruzzone/tdlib-rs/blob/main/LICENSE-APACHE
# tdlib-rs
[](https://crates.io/crates/tdlib_rs)
[](https://docs.rs/tdlib-rs/latest/tdlib_rs/)
[](https://github.com/FedericoBruzzone/tdlib-rs/actions/workflows/ci-linux.yml)
[](https://github.com/FedericoBruzzone/tdlib-rs/actions/workflows/ci-windows.yml)
[](https://github.com/FedericoBruzzone/tdlib-rs/actions/workflows/ci-macos.yml)
[](https://crates.io/crates/tdlib_rs)
A Rust wrapper around the Telegram Database library. It includes a generator to automatically generate the types and functions from the TDLib's [Type Language](https://core.telegram.org/mtproto/TL) file.
## Why this fork?
This is an improved version of the [tdlib-rs](https://github.com/paper-plane-developers/tdlib-rs) library, with the following additional features:
1. It is cross-platform, it works on Windows, Linux and MacOS.
2. Not required `tdlib` to be compiled and installed on the system.
3. Not required `pkg-config` to build the library and associated exported variables.
4. Four different ways to build the library:
- `download-tdlib`: download the precompiled library from the GitHub releases.
- `local-tdlib`: use the `tdlib` installed on the system.
- `pkg-config`: use the `pkg-config` to build the library.
- `static`: statically link `tdjson` (to be used with `download-tdlib` or `local-tdlib`).
5. It is possible to download the `tdlib` library from the GitHub releases.
## Information
We provide a precompiled version of the library for the supported platforms:
- Linux (x86_64)
- Linux (arm64)
- macOS Intel (x86_64)
- macOS Apple Silicon (arm64)
- Windows (x86_64)
- Windows (arm64)
We compile it in the CI and we upload the artifacts to the GitHub releases, so we can download it and use to build this library.
It's mainly created for using it in the [tgt](https://github.com/FedericoBruzzone/tgt) client, but it should work also for any other Rust project.
Current supported TDLib version: [1.8.61](https://github.com/tdlib/td/commit/11e254af695060d8890024dd7faa1cc2d6685ef8).
## Cargo features
Please see the documentation of the module `build` for more information about the features [here](https://docs.rs/tdlib-rs/latest/tdlib_rs/build/index.html).
It functions that you can use to build the library in different ways.
### download-tdlib
If you don't want to compile and intall the `tdlib` on your system manually, you should enable the `download-tdlib` feature in the `Cargo.toml` file:
```toml
[dependencies]
tdlib = { version = "...", features = [ "download-tdlib" ] }
[build-dependencies]
tdlib = { version = "...", features = [ "download-tdlib" ] }
```
```rust
// build.rs
fn main() {
tdlib_rs::build::build(None);
}
```
### local-tdlib
`local-tdlib` require you to have the `tdlib` (version 1.8.61) compiled and installed on your system, and the following variables exported, for example in the `.bashrc` file:
```sh
# The path to the tdlib folder
export LOCAL_TDLIB_PATH=$HOME/lib/tdlib
```
Then you can enable the `local-tdlib` feature in the `Cargo.toml` file:
```toml
[dependencies]
tdlib = { version = "...", features = [ "local-tdlib" ] }
[build-dependencies]
tdlib = { version = "...", features = [ "local-tdlib" ] }
```
```rust
// build.rs
fn main() {
tdlib_rs::build::build(None);
}
```
### pkg-config
If you want to use the `pkg-config` to build this library, you should enable the `pkg-config` feature in the `Cargo.toml` file:
```toml
[dependencies]
tdlib = { version = "...", features = [ "pkg-config" ] }
[build-dependencies]
tdlib = { version = "...", features = [ "pkg-config" ] }
```
```rust
// build.rs
fn main() {
tdlib_rs::build::build(None);
}
```
remember to have the `tdlib` (version 1.8.61) compiled on your system, and the following variables exported, for example in the `.bashrc` file:
```sh
# pkg-config configuration
export PKG_CONFIG_PATH=$HOME/lib/tdlib/lib/pkgconfig/:$PKG_CONFIG_PATH
# dynmic linker configuration
export LD_LIBRARY_PATH=$HOME/lib/tdlib/lib/:$LD_LIBRARY_PATH
```
### docs
This feature skip the linking of the library and only generate the code of `generated.rs`.
Is used only for testing.
### static
This feature enables static linking for `tdjson`, so the final binary does not require `tdjson` to be installed in the target system runtime.
Use it together with `download-tdlib` or `local-tdlib`:
```toml
[dependencies]
tdlib-rs = { version = "...", features = ["download-tdlib", "static"] }
```
### bots-only-api
This feature enable the generation of the functions only used by Telegram bots.
## License
This repository are licensed under either of
- Apache License, Version 2.0 ([LICENSE-APACHE][github-license-apache] or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license ([LICENSE-MIT][github-license-mit] or <http://opensource.org/licenses/MIT>)
at your option.
Please review the license file provided in the repository for more information regarding the terms and conditions of the license.
## Contact
If you have any questions, suggestions, or feedback, do not hesitate to [contact me](https://federicobruzzone.github.io/).
Mantainers:
- [FedericoBruzzone](https://github.com/FedericoBruzzone)
- [Andreal2000](https://github.com/Andreal2000)
## Credits
- [grammers](https://github.com/Lonami/grammers): the `tdlib-tl-gen` and `tdlib-tl-parser` projects are forks of the `grammers-tl-gen` and `grammers-tl-parser` projects.
- [rust-tdlib](https://github.com/aCLr/rust-tdlib): for inspiration about some client code.
- [tdlib-rs](https://github.com/paper-plane-developers/tdlib-rs): for inspiration about the generator code.