Package: telegram-upload
telegram-uploadTelegram-upload uses yourpersonal Telegram accounttouploadanddownloadfiles up to4 GiB(2 GiB for
free users). Turn Telegram into your personal ☁ cloud!Toinstall 🔧 telegram-upload, run this command in your terminal:$sudopip3install-Utelegram-uploadThis is the preferred method to install telegram-upload, as it will always install the most recent stable release.
🐍Python 3.7-3.11are tested and supported. There are other installation ways available likeDocker.
More info in the📕 documentation❓ UsageTo use this program you need an Telegram account and yourApp api_id & api_hash(get it inmy.telegram.org). The first time you use telegram-upload it requests your
📱telephone,api_idandapi_hash. Bot tokens can not be used with this program (bot uploads are limited to
50MB).Tosend ⬆️ files(by default it is uploaded to saved messages):$telegram-uploadfile1.mp4file2.mkvYou candownload ⤵️ the filesagain from your saved messages (by default) or from a channel. All files will be
downloaded until the last text message.$telegram-downloadRead the documentationfor more info about the
options availables.Interactive modeTheinteractive option(--interactive) allows you to choose the dialog and the files to download or upload with
aterminal 🪄 wizard. It evensupports mouse!$telegram-upload--interactive# Interactive upload$telegram-download--interactive# Interactive downloadMore info in the documentationSet group or chatBy default when using telegram-upload without specifying the recipient or sender, telegram-upload will use your personal
chat. However you can define the 👨 destination. For file upload the argument is--to<entity>. For example:$ telegram-upload --to telegram.me/joinchat/AAAAAEkk2WdoDrB4-Q8-gg video.mkvYou can download files from a specific chat using the –from <entity> parameter. For example:$ telegram-download --from usernameYou can see allthe possible values for the entity in the documentation.Split & join filesIf you try to upload a file thatexceeds the maximum supportedby Telegram by default, an error will occur. But you
can enable ✂split modeto upload multiple files:$telegram-upload--large-filessplitlarge-video.mkvFiles split using split can be rejoined on download using:$telegram-download--split-filesjoinFind more help inthe telegram-upload documentation.Delete on successThe--delete-on-successoption allows you to ❌delete the Telegram messageafter 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.ConfigurationCredentials are saved in~/.config/telegram-upload.jsonand~/.config/telegram-upload.session. You must make
sure that these files are secured. You can copy these 📁 files to authenticatetelegram-uploadon more machines, but
it is advisable to create a session file for each machine.More optionsTelegram-upload has more options available, like customizing the files thumbnail, set a caption message (including
variables) or configuring a proxy.Read the documentationfor more info.💡 FeaturesUploadanddownloadmultiples files  (up to 4 GiB per file for premium users).Interactivemode.Add videothumbs.Splitandjoinlarge files.Deletelocal or remote file on success.Usevariablesin thecaptionmessage.… Andmore.🐋 DockerRun telegram-upload without installing it on your system using Docker. Instead oftelegram-uploadandtelegram-downloadyou should useuploadanddownload. Usage:$ docker run -v <files_dir>:/files/
             -v <config_dir>:/config
             -it nekmo/telegram-upload:master
             <command> <args><files_dir>: upload or download directory.<config_dir>: Directory that will be created to store the telegram-upload configuration.
It is created automatically.<command>:uploadanddownload.<args>:telegram-uploadandtelegram-downloadarguments.For example:$ docker run -v /media/data/:/files/
             -v $PWD/config:/config
             -it nekmo/telegram-upload:master
             upload file_to_upload.txt❤️ ThanksThis project developed byNekmo&collaboratorswould not be possible withoutTelethon, the library used as a Telegram client.Telegram-upload is licensed under theMIT license.