# t-bot
Upload files to your Telegram channel or group with your telegram bot
[](https://pypi.org/project/tl-bot/)
[](https://pepy.tech/project/tl-bot)
[](https://pepy.tech/project/tl-bot)
## Features
- Progress bar
- You can change file name before upload on telegram
Note : Bot can upload only 50 MB file (with default telegram bot api server url).
## Installation
```sh
pip3 install tl-bot
```
## Usage
```sh
t-bot setup # setup your telegram credentials
t-bot setup --cahtid -1001234567890 --token 1234:asdfgjkl --server http://127.0.0.1:8081 # setup your telegram credentials
t-bot reset # reset to default your telegram credentials
t-bot test # test telegram bot token
t-bot getid # get chat id of your connected group or channel
t-bot up {file_name} -c file_caption # upload Telegram channel or group
t-bot d {url} -c caption # download and upload file to your Telegram channel or group
```
# API
The anonfile-upload client is also usable through an API (for test integration, automation, etc)
### tl_bot.test_token(bot_token)
```py
from tl_bot import test_token
test_token(bot_token) # bot_token type str
```
### tl_bot.uploader(bot_token: str, chat_id: str, file_name: str, server_url: str, caption: str)
```py
from tl_bot import uploader
uploader(bot_token, chat_id, file_name, server_url, caption) # all arguments must be str
```
### tl_bot.download(url:str, bot_token:str, chat_id:str, caption:str)
```py
from tl_bot import download
download(url, bot_token, chat_id, caption) # all arguments must be str
```
Raw data
{
"_id": null,
"home_page": "https://github.com/jakbin/t-bot",
"name": "tl-bot",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "telegram, t-bot, telegram-api, telegram-api-bot, telegram-file-upload, telegram-upload",
"author": "Jak Bin",
"author_email": "jakbin4747@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/7b/ae/d0e171c3589051d9c73ea0c45f0ba9c88d5ef84e38d1d94ee2bad6fef620/tl_bot-0.1.4.tar.gz",
"platform": null,
"description": "# t-bot\n\nUpload files to your Telegram channel or group with your telegram bot\n\n [](https://pypi.org/project/tl-bot/)\n [](https://pepy.tech/project/tl-bot)\n [](https://pepy.tech/project/tl-bot)\n \n \n \n \n\n\n## Features\n- Progress bar\n- You can change file name before upload on telegram\n\nNote : Bot can upload only 50 MB file (with default telegram bot api server url).\n\n\n## Installation\n\n```sh\npip3 install tl-bot\n```\n\n## Usage \n```sh\nt-bot setup # setup your telegram credentials\nt-bot setup --cahtid -1001234567890 --token 1234:asdfgjkl --server http://127.0.0.1:8081 # setup your telegram credentials\nt-bot reset # reset to default your telegram credentials\nt-bot test # test telegram bot token\nt-bot getid # get chat id of your connected group or channel\nt-bot up {file_name} -c file_caption # upload Telegram channel or group\nt-bot d {url} -c caption # download and upload file to your Telegram channel or group\n```\n\n# API\n\nThe anonfile-upload client is also usable through an API (for test integration, automation, etc)\n\n### tl_bot.test_token(bot_token)\n\n```py\nfrom tl_bot import test_token\n\ntest_token(bot_token) # bot_token type str\n```\n\n### tl_bot.uploader(bot_token: str, chat_id: str, file_name: str, server_url: str, caption: str)\n\n```py\nfrom tl_bot import uploader\n\nuploader(bot_token, chat_id, file_name, server_url, caption) # all arguments must be str\n```\n\n### tl_bot.download(url:str, bot_token:str, chat_id:str, caption:str)\n\n```py\nfrom tl_bot import download\n\ndownload(url, bot_token, chat_id, caption) # all arguments must be str\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "upload files to your telegram channel or group with your telegram bot",
"version": "0.1.4",
"project_urls": {
"Bug Tracker": "https://github.com/jakbin/t-bot/issues",
"Homepage": "https://github.com/jakbin/t-bot"
},
"split_keywords": [
"telegram",
" t-bot",
" telegram-api",
" telegram-api-bot",
" telegram-file-upload",
" telegram-upload"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4531560dd25181cb44b901c17a6b7876f6f3cbfd7b51cd36d44b48d53f1c4b03",
"md5": "b78d5e577ea2ec5b5016a51ea60e04c2",
"sha256": "6295c1a1d8047f5211e38b6625eae34c631fb7ef3ee480fd53668e773cb298e4"
},
"downloads": -1,
"filename": "tl_bot-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b78d5e577ea2ec5b5016a51ea60e04c2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 8985,
"upload_time": "2025-07-28T14:38:04",
"upload_time_iso_8601": "2025-07-28T14:38:04.327856Z",
"url": "https://files.pythonhosted.org/packages/45/31/560dd25181cb44b901c17a6b7876f6f3cbfd7b51cd36d44b48d53f1c4b03/tl_bot-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7baed0e171c3589051d9c73ea0c45f0ba9c88d5ef84e38d1d94ee2bad6fef620",
"md5": "65154e05b73918b99ec403ef0a714cb5",
"sha256": "c37752ffe8e058754f785d5122e075bba139658739dd965db1fea57af3d8c319"
},
"downloads": -1,
"filename": "tl_bot-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "65154e05b73918b99ec403ef0a714cb5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 8421,
"upload_time": "2025-07-28T14:38:05",
"upload_time_iso_8601": "2025-07-28T14:38:05.523256Z",
"url": "https://files.pythonhosted.org/packages/7b/ae/d0e171c3589051d9c73ea0c45f0ba9c88d5ef84e38d1d94ee2bad6fef620/tl_bot-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 14:38:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jakbin",
"github_project": "t-bot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "tqdm",
"specs": []
},
{
"name": "appdirs",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "requests-toolbelt",
"specs": []
}
],
"lcname": "tl-bot"
}
JSON
