Swiftpack.co - Swiftgram/TDLibFramework as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by Swiftgram.
Swiftgram/TDLibFramework 1.8.11-5ed1d22d
TDLib for iOS, macOS, watchOS and tvOS packed in XCFramework and SPM.
⭐️ 7
🕓 2 days ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/Swiftgram/TDLibFramework.git", from: "1.8.11-5ed1d22d")



Project contains pre-compiled TDLib binary for iOS, macOS, watchOS, tvOS and simulators in .xcframework bundle.

If you're looking for pure Swift library, check out TDLibKit


Xcode (SPM)

  1. Install latest Xcode
  2. Add https://github.com/Swiftgram/TDLibFramework as SPM dependency in Project > Swift Packages. This could take a while cause it downloads ~300mb zip file with xcframework.
  3. Add TDLibFramework as your target dependency.
  4. Code!

Cocoapods & Flutter

See Wiki page


Create client

let client: UnsafeMutableRawPointer! = td_json_client_create()

Make request object

let request = ["@type": "getTextEntities", "text": "@telegram /test_command https://telegram.org telegram.me", "@extra": ["5", 7.0, "\\u00e4"]] as [String: Any]

JSON Serialization and Deserialization

Small example for helper functions you will need to talk with TDLib

func dictToJSONString(_ dictionary: [String: Any]) -> String {
    let dictionaryData = try! JSONSerialization.data(withJSONObject: dictionary)
    return String(data: dictionaryData, encoding: .utf8)!

func JSONStringToDict(_ string: String) -> [String: Any] {
    let responseData = string.data(using: .utf8)!
    return try! JSONSerialization.jsonObject(with: responseData, options: .allowFragments) as! [String: Any]

Synchronious requests

Only for methods with "Can be called synchronously" in docs

if let res = td_json_client_execute(client, dictToJSONString(request)) {
    let responseString = String(cString: res)
    let responseDict = JSONStringToDict(responseString)
    print("Response from TDLib \(responseDict)")

Async requests

let request = ["@type": "setTdlibParameters",
                "parameters": [
                    "database_directory": "tdlib",
                    "use_message_database": true,
                    "use_secret_chats": true,
                    "api_id": 94575,
                    "api_hash": "a3406de8d171bb422bb6ddf3bbd800e2",
                    "system_language_code": "en",
                    "device_model": "Desktop",
                    "application_version": "1.0",
                    "enable_storage_optimizer": true
                ] as [String : Any]

// Send request
td_json_client_send(client, dictToJSONString(request))

// Block thread and wait for response (not more 5.0 seconds)
if let response = td_json_client_receive(client, 5.0) {
   let responseString = String(cString: res)
   let responseDict = JSONStringToDict(responseString)
   print("Async response from TDLib \(responseDict)")

Destroy client on exit



You can find latest releases at Releases page.


You can find more about build process in Github Actions file.


  • ☐ Lib tests on watchOS simulator


  • Anton Glezman for Build Guide and basic implementation
  • Telegram Team for TDLib




Stars: 7
Last commit: 5 hours ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

5 hours ago

XCFramework based on TDLib-1.8.11 commit a08b1f91

ZIP Checksum 016702b2eae96bda54b212bdc11381924922fda82a18be92c5cf932674c195a5

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics