tgup

Upload files to Telegram using your account.

This project is partially based on telegram-upload by Nekmo, it was recreated because the original project seems abandoned.

PyPI page

Installation

With uv:

uvx tgup

With pipx:

pipx install tgup

With pip:

pip install tgup

Usage

To use this program you need an Telegram account and your App api_id & api_hash (get it in my.telegram.org). The first time you use tgup it requests your telephone number, api_id and api_hash. Bot tokens can not be used with this program (bot uploads are limited to 50MB).

To send files:

tgup dir1/ file1 dir2/abc/

It will send the files to your personal chat by default.

To send files to a specific channel, chat or user:

tgup --to <channel_username> dir1/ file1
tgup --to <chat_id> dir1/ file1
tgup --to <user_username> dir1/ file1

To see all the options, run: tgup --help

Acknowledgements

• Based on telegram-upload

License

This project is released under the GPL 3.0 or later license.