Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Upload (and download) files to Telegram up to 1.5 GiB using your account

Project description

Latest Travis CI build status Latest PyPI version Python versions Code Climate Test coverage Requirements Status


Upload (and download) large files to Telegram using your account

To install telegram-upload, run this command in your terminal:

$ sudo pip install telegram-upload

This is the preferred method to install telegram-upload, as it will always install the most recent stable release.

To use this program you need an Telegram account and your App api_id/api_hash (get it in The first time you use telegram-upload it requests your telephone, api_id and api_hash. Bot tokens can not be used with this program (bot uploads are limited to 50MB). To send files:

$ telegram-upload file1.mp4 /path/to/file2.mkv

Credentials are saved in ~/.config/telegram-upload.json and telegram-upload.session (in the current directory). You must make sure that these files are secured. You can copy these files to authenticate telegram-upload on more machines, but it is advisable to create a session file for each machine.

You can download the files again from your saved messages (by default) or from a channel. All files will be downloaded until the last text message.

$ telegram-download

The --delete-on-success option allows you to delete the Telegram message after downloading the file. This is useful to send files to download to your saved messages and avoid downloading them again. You can use this option to download files on your computer away from home.


  • Upload multiples files (up to 1.5GiB per file)
  • Download files.
  • Add video thumbs.
  • Delete local or remote file on success.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for telegram-upload, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size telegram-upload-0.2.1.tar.gz (18.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page