Uploader, Downloader, Crawler, Bot 50MB limitation bypasser. (Maybe can wash the dishes someday)
You can also:
It's a python package for Telegram messenger, which can give you an ability to download, upload, and more options to do with your Telegram account on CLI.
telegram-cloud requires Python3 and Telethon as requirment.
$ pip3 install telegram-cloud
Also can be found on pypi
tglogin on your terminalBefore working with Telegram’s API, you need to get your own API ID and hash: Login to your Telegram account with the phone number of the developer account to use. Click under API Development tools. A Create new application window will appear. Fill in your application details. There is no need to enter any URL, and only the first two fields (App title and Short name) can currently be changed later. Click on Create application at the end. Remember that your API hash is secret and Telegram won’t let you revoke it. Don’t post it anywhere!
tgcloud on your terminal.telegram-cloud is currently working with the following commands.
| args | help |
|---|---|
| --mode / -m | Two modes for specify what you want, Available modes: download - upload |
| --name / -n | A Name you choose while tglogin-ing and use for specify the current user you work on it |
| --username / -u | Target username that you want to send file, type me if you want to get it on your saved messages |
| --path / -p | For download mode: pass simple directory path like "/Users/nima/Desktop/Iwanttoescapefrom/" |
| --path / -p | For upload mode: pass file path like "/Users/nima/Desktop/Iwanttoescapefrom/Iran.zip" |
| --caption / -c | For download mode: pass the name of file or caption to crawl and download |
| --caption / -c | For upload mode: write the caption to see it under your file |
tgutil accepts these arguments:
| args | help |
|---|---|
| --name / -n | A Name you choose while tglogin-ing and use for specify the current user you work on it |
| --username / -u | Target username's chat that you want to edit/delete message on it, type me if you want to get it on your saved messages |
| --mode { edit, editall, delete, deleteall } | Choose what you need to do, delete/edit last message or deleteall/editall |
| --text | the text that you are looking for to do operation on it |
| --newtext | the new text that you want to be replaced with current text, can be used for edit and editall |
tgsend accepts these arguments:
| args | help |
|---|---|
| --name / -n | A Name you choose while tglogin-ing and use for specify the current user you work on it |
| --username / -u | Target username that you want to send file, type me if you want to get it on your saved messages |
| --format { text, markdown, html } | How to parse message body. Default is text |
| --no-link-preview | Disable web link preview card for this message |
| --silent | Disable audible notification |
| --stdin | Read message text from stdin |
tginfo accepts these arguments:
| args | help |
|---|---|
| --name / -n | A Name you choose while tglogin-ing and use for specify the current user you work on it |
| --username / -u | Target username that you want to fetch info, type me if you want to get it on your saved messages |
| --search / -s | search specific extension or text |
Are you done with tglogin? so come with me.
Download a music from my saved messages and save it on /Users/nima/Desktop/:
$ tgcloud -m download -n nima -u me -p "/Users/nima/Desktop/" -c "sad but true"
$ tgcloud --mode download --name nima --username me --path "/Users/nima/Desktop/" --caption "sad but true"
Upload a banner with caption to my saved messages:
$ tgcloud -m upload -n nima -u me -p "/Users/nima/Desktop/banner.png" -c "Help me"
$ tgcloud --mode upload --name nima --username me --path "/Users/nima/Desktop/banner.png" --caption "Help me"
Upload a pdf to an telegram ID:
$ tgcloud -m upload -n nima -u @autisticbruh -p "/Users/nima/Desktop/file.pdf" -c "Help me"
Search and download a zip from telegram chat_id group:
$ tgcloud -m download -n nima -u -1001240213443 -p "/Users/nima/Desktop/" -c "best memes"
Send a silent text message to a chat group:
$ tgsend -n anightshade -u -1001240213443 --silent "Panda eats shoots and leaves"
Send a fortune cookie to yourself via stdin:
$ tgsend -n anightshade -u me --stdin
Search all PDFs inside a telegram conversation:
$ tginfo -n testSession -u me -s ".pdf
Edit the last hello text message on your saved message to bye:
$ tgutil -n nimnim -u me --mode edit --text "hello" --newtext "bye"
Edit all hello text messages on your saved message to bye:
$ tgutil -n nimnim -u me --mode editall --text "hello" --newtext "bye"
Delete the last hello text message on your saved message:
$ tgutil -n nimnim -u me --mode delete --text "hello"
Delete all hello text messages on your saved message:
$ tgutil -n nimnim -u me --mode deleteall --text "hello"
Get info for all Media inside a telegram conversation:
$ tginfo -n testSession -u me
Just like unix but CAREFUL about paths, your path must not end with \ !!
Download all PDFs from your saved messages and save it on C:\Users\Nima\Desktop:
$ tgcloud -m download -n nima -u me -p "C:\Users\Nima\Desktop" -c ".pdf"
from Telegram Doc:
When working with the API, it is sometimes necessary to send a relatively large file to the server. For example, when sending a message with a photo/video attachment or when setting the current user’s profile picture.
You can upload a file to Telegram once, and send it again to others or do things with file_id. So when you upload a file, you can see the file_id. So now what? If you have a Telegram bot and you have 50MB limitation for uploading and send to users, you can bypass this limitation by this trick and upload files upto 2 GB and pass it by file_id or message_id or...
The config file can be found on ~/.telegram-cloud/ (Also ~\.telegram-cloud\ in windows)
Each login make *.session file which is located there and it cause script for logged-in user works globally.
Inside telegram-cloud-config.ini, you can find api_hash and api_id and name you've entered by tglogin
tgsend)tgutil)tgutil)Feel free to submit issues and enhancement requests.
Please refer to each project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.
NOTE: Be sure to merge the latest from "upstream" before making a pull request!
See Telethon
Special thanks to Contributors
@anightshade: For adding tgsend and fixing bugs!
@anightshade: For adding Command line option to select format for the file caption.
@rany2: For fixing uploading path and files
@anightshade: For adding option to disable weblink preview in message
FAQs
Download and upload files via telegram up to 2 GB, CLI
We found that telegram-cloud demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.
Security News
vlt introduced its new package manager and a serverless registry this week, innovating in a space where npm has stagnated.
Security News
Research
The Socket Research Team uncovered a malicious Python package typosquatting the popular 'fabric' SSH library, silently exfiltrating AWS credentials from unsuspecting developers.