Metadata-Version: 2.4
Name: tgup
Version: 0.2.2
Summary: Upload files to Telegram using your account
Author-email: John Toniutti <john.toniutti@gmail.com>
License-Expression: GPL-3.0-or-later
Project-URL: repository, https://github.com/jotonedev/tgup
Keywords: telegram-upload,telethon,telegram,upload
Classifier: Topic :: Multimedia
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptg>=0.6.0
Requires-Dist: hachoir>=3.3.0
Requires-Dist: python-ffmpeg>=2.0.12
Requires-Dist: telethon>=1.39.0
Requires-Dist: tqdm>=4.67.1
Dynamic: license-file

# tgup

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tgup?link=https%3A%2F%2Fpypi.org%2Fproject%2Ftgup%2F)
![PyPI - Status](https://img.shields.io/pypi/status/tgup?link=https%3A%2F%2Fpypi.org%2Fproject%2Ftgup%2F)
![PyPI - Version](https://img.shields.io/pypi/v/tgup?link=https%3A%2F%2Fpypi.org%2Fproject%2Ftgup%2F)

Upload files to Telegram using your account.

This project is partially based on [telegram-upload](https://github.com/Nekmo/telegram-upload) by [Nekmo](https://github.com/Nekmo),
it was recreated because the original project seems abandoned.

[PyPI page](https://pypi.org/project/tgup/)

## Installation

With uv:
```bash
uvx tgup
```

With pipx:
```bash
pipx install tgup
```

With pip:
```bash
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](https://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:
```bash
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:
```bash
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](https://github.com/Nekmo/telegram-upload)

## License

This project is released under the [GPL 3.0 or later](LICENSE) license.
