{"id":48795093,"url":"https://github.com/tdlight-team/tdlight-java","last_synced_at":"2026-04-13T23:00:51.829Z","repository":{"id":37460230,"uuid":"282856358","full_name":"tdlight-team/tdlight-java","owner":"tdlight-team","description":"Complete Bot and Userbot Telegram library based on TDLib","archived":false,"fork":false,"pushed_at":"2025-09-06T19:50:29.000Z","size":4148,"stargazers_count":296,"open_issues_count":15,"forks_count":48,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-09-07T17:32:37.581Z","etag":null,"topics":["java","mtproto","tdlib","tdlib-java","telegram","telegram-api","telegram-bot","telegram-bot-api","telegram-bot-example","telegram-bot-framework","telegram-bots","telegram-bots-api","telegram-java-api","telegram-userbot","telegrambot"],"latest_commit_sha":null,"homepage":"https://t.me/TDLight","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tdlight-team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-07-27T09:50:41.000Z","updated_at":"2025-09-06T19:46:34.000Z","dependencies_parsed_at":"2023-02-17T20:46:00.902Z","dependency_job_id":"856cf7ee-1067-423e-82f3-d3699fa7c113","html_url":"https://github.com/tdlight-team/tdlight-java","commit_stats":null,"previous_names":[],"tags_count":131,"template":false,"template_full_name":null,"purl":"pkg:github/tdlight-team/tdlight-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdlight-team%2Ftdlight-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdlight-team%2Ftdlight-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdlight-team%2Ftdlight-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdlight-team%2Ftdlight-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tdlight-team","download_url":"https://codeload.github.com/tdlight-team/tdlight-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdlight-team%2Ftdlight-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31774547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","mtproto","tdlib","tdlib-java","telegram","telegram-api","telegram-bot","telegram-bot-api","telegram-bot-example","telegram-bot-framework","telegram-bots","telegram-bots-api","telegram-java-api","telegram-userbot","telegrambot"],"created_at":"2026-04-13T23:00:24.888Z","updated_at":"2026-04-13T23:00:51.823Z","avatar_url":"https://github.com/tdlight-team.png","language":"Java","readme":"\u003cdiv style=\"text-align: center\" align=\"center\"\u003e\n    \u003ca href=\"https://github.com/tdlight-team/tdlight-java\"\u003e\u003cimg src=\"./.media/tdlight-logo.png\" alt=\"TDLight logo\" style=\"width: 5rem; height: 5rem\"\u003e\u003c/a\u003e\n    \u003ch1\u003eTDLight Java\u003c/h1\u003e\n    \u003cp\u003eComplete Bot and Userbot Telegram library written in Java, based on \u003ca href=\"https://github.com/tdlib/td\"\u003eTDLib\u003c/a\u003e\u003c/p\u003e\n    \u003ca href=\"https://github.com/tdlight-team/tdlight-java/actions/workflows/maven-publish.yml\"\u003e\n\u003cimg alt=\"Maven package\" src=\"https://github.com/tdlight-team/tdlight-java/actions/workflows/maven-publish.yml/badge.svg?branch=master\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/tdlight-team/tdlight-java/releases\"\u003e\n        \u003cimg alt=\"Release\" src=\"https://img.shields.io/github/v/release/tdlight-team/tdlight-java.svg?include_prereleases\u0026style=flat-square\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.ej-technologies.com/products/jprofiler/overview.html\"\u003e\n        \u003cimg alt=\"JProfiler\" src=\"https://local.cavallium.it/mirrors/jprofiler-logo/jprofiler-logo-badge.svg\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n## 💻 Supported platforms\n\n**Java versions**: from Java 17 to Java 21+ (Java 8 to 16 is supported if you use the following dependency classifier: `jdk8`)\n\n**Operating systems**: Linux, Windows, MacOS\n\n**CPU architectures**:\n\n- amd64 (Linux, Windows)\n- armhf (Linux)\n- arm64 (Linux, MacOS)\n- ppc64el (Linux)\n- riscv64 (linux)\n\n## 📚 Required libraries\n- **Linux: OpenSSL1/OpenSSL3, zlib, (libc++ if you use clang)**\n- **MacOS: OpenSSL**\n- **Windows: [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)**\n\n### Install OpenSSL on macOS\n\nYou must install `openssl@3` using the \u003ca href=\"https://brew.sh\"\u003ebrew package manager \u003c/a\u003e, then link openssl\nto `/usr/local/opt/openssl`\n\nIf you don't know how to do this, type the following commands in your terminal:\n\n```bash\nbrew install openssl@3\nln -sf /usr/local/Cellar/openssl@3/3.0.0 /usr/local/opt/openssl\n```\n\n## 📚 How to use the library\n\n### Setting up the library using Maven\n\nIf you are using Maven, edit your `pom.xml` file as below:\n\n```xml\n\n\u003cproject\u003e\n\t\u003crepositories\u003e\n\n\t\t\u003c!-- Add the following repository --\u003e\n\t\t\u003crepository\u003e\n\t\t\t\u003cid\u003emchv\u003c/id\u003e\n\t\t\t\u003cname\u003eMCHV Apache Maven Packages\u003c/name\u003e\n\t\t\t\u003curl\u003ehttps://mvn.mchv.eu/repository/mchv/\u003c/url\u003e\n\t\t\u003c/repository\u003e\n\n\t\u003c/repositories\u003e\n\n\t\u003cdependencyManagement\u003e\n\t\t\u003cdependencies\u003e\n\t\t\t\n\t\t\t\u003c!-- Add the following dependency --\u003e\n\t\t\t\u003cdependency\u003e\n\t\t\t\t\u003cgroupId\u003eit.tdlight\u003c/groupId\u003e\n\t\t\t\t\u003cartifactId\u003etdlight-java-bom\u003c/artifactId\u003e\n\t\t\t\t\u003cversion\u003eVERSION\u003c/version\u003e\n\t\t\t\t\u003ctype\u003epom\u003c/type\u003e\n\t\t\t\t\u003cscope\u003eimport\u003c/scope\u003e\n\t\t\t\u003c/dependency\u003e\n\t\t\u003c/dependencies\u003e\n\t\u003c/dependencyManagement\u003e\n\n\t\u003cdependencies\u003e\n\n\t\t\u003c!-- Add the following dependencies --\u003e\n\t\t\u003cdependency\u003e\n\t\t\t\u003cgroupId\u003eit.tdlight\u003c/groupId\u003e\n\t\t\t\u003cartifactId\u003etdlight-java\u003c/artifactId\u003e\n\t\t\t\u003c!-- Java 8 is supported if you use the following dependency classifier: \u003cclassifier\u003ejdk8\u003c/classifier\u003e --\u003e\n\t\t\t\u003c!-- don't specify the version here --\u003e\n\t\t\u003c/dependency\u003e\n\t\t\u003c!-- Example linux amd64 (GNU GCC) ssl1 natives --\u003e\n\t\t\u003cdependency\u003e\n\t\t\t\u003cgroupId\u003eit.tdlight\u003c/groupId\u003e\n\t\t\t\u003cartifactId\u003etdlight-natives\u003c/artifactId\u003e\n\t\t\t\u003cclassifier\u003elinux_amd64_gnu_ssl1\u003c/classifier\u003e\n\t\t\t\u003c!-- don't specify the version here --\u003e\n\t\t\u003c/dependency\u003e\n\t\t\u003c!-- Example windows amd64 natives --\u003e\n\t\t\u003cdependency\u003e\n\t\t\t\u003cgroupId\u003eit.tdlight\u003c/groupId\u003e\n\t\t\t\u003cartifactId\u003etdlight-natives\u003c/artifactId\u003e\n\t\t\t\u003cclassifier\u003ewindows_amd64\u003c/classifier\u003e\n\t\t\t\u003c!-- don't specify the version here --\u003e\n\t\t\u003c/dependency\u003e\n\t\t\u003c!-- ... --\u003e\n\t\t\u003c!-- Include other native classifiers, for example linux_amd64_ssl3, macos_arm64, ... --\u003e\n\n\t\u003c/dependencies\u003e\n\u003c/project\u003e\n```\n\nReplace `VERSION` with the latest release version, you can find\nit [here](https://github.com/tdlight-team/tdlight-java/releases).\n\n## Setting up the library using Gradle\n\nIf you are using Gradle, add the following lines into your `build.gradle` file\n\n```groovy\nrepositories {\n\tmaven { url \"https://mvn.mchv.eu/repository/mchv/\" }\n}\ndependencies {\n\t// import the BOM\n\timplementation platform('it.tdlight:tdlight-java-bom:VERSION')\n\n\t// do not specify the versions on the dependencies below!\n\timplementation group: 'it.tdlight', name: 'tdlight-java' // Java 8 is supported if you use the following dependency classifier: `jdk8`\n\timplementation group: 'it.tdlight', name: 'tdlight-natives', classifier: 'linux_amd64_gnu_ssl1'\n\t// Include other native classifiers, for example linux_amd64_clang_ssl3, macos_arm64, ... --\u003e\n}\n```\n\nReplace `VERSION` with the latest release version, you can find\nit [here](https://github.com/tdlight-team/tdlight-java/releases).\n\n## ⚒ Native dependencies\n\nTo use TDLight Java you need to include the native libraries, by specifying one of the following classifier for each tdlight-natives dependency:\n\n- `linux_amd64_clang_ssl3`\n- `linux_amd64_gnu_ssl1`\n- `linux_amd64_gnu_ssl3`\n- `linux_arm64_clang_ssl3`\n- `linux_arm64_gnu_ssl1`\n- `linux_arm64_gnu_ssl3`\n- `linux_armhf_gnu_ssl1`\n- `linux_armhf_gnu_ssl3`\n- `linux_ppc64el_gnu_ssl3`\n- `linux_riscv64_gnu_ssl3`\n- `windows_amd64`\n- `macos_arm64`\n\nAdvanced: If you want to use a different precompiled native, please set the java property `it.tdlight.native.workdir`. (Please note that you must build [this](https://github.com/tdlight-team/tdlight-java-natives), you can't put random precompiled tdlib binaries found on the internet)\n\n## Usage\n\nAn example on how to use TDLight Java can be found\nhere: [Example.java](https://github.com/tdlight-team/tdlight-java/blob/master/example/src/main/java/it/tdlight/example/Example.java)\n\n### Advanced usage\n\nIf you want to disable the automatic runtime shutdown hook, you should set the property `it.tdlight.enableShutdownHooks`\nto `false`\n\n### TDLight methods documentation\n\n[TdApi JavaDoc](https://tdlight-team.github.io/tdlight-docs)\n\n### TDLight extended features\n\nTDLight has some extended features compared to TDLib, that you can see on\nthe [TDLight official repository](https://github.com/tdlight-team/tdlight#tdlight-extra-features).\n\n## About\n\n### **License**\n\nTDLight is licensed by Andrea Cavalli \u003candrea@cavallium.it\u003e under the terms of the GNU Lesser General Public License 3\n\n### **Libraries licenses**\n\nJTDLib is licensed by Emily Castellotti \u003cinfo@emy.sh\u003e under the terms of the GNU Lesser General Public\nLicense 3\n\nTDLib is licensed by Aliaksei Levin \u003clevlam@telegram.org\u003e and Arseny Smirnov \u003carseny30@gmail.com\u003e under the terms of the\nBoost Software License\n\nOpenSSL is licensed under the terms of Apache License v2\n\nZlib is licensed under the terms of Zlib license\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdlight-team%2Ftdlight-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftdlight-team%2Ftdlight-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdlight-team%2Ftdlight-java/lists"}