https://github.com/iskoldt-x/savebot
Save everything you throw to the telegram bot. Run this bot with Docker!
https://github.com/iskoldt-x/savebot
bot docker telegram telegram-bot telegram-bot-api
Last synced: 11 months ago
JSON representation
Save everything you throw to the telegram bot. Run this bot with Docker!
- Host: GitHub
- URL: https://github.com/iskoldt-x/savebot
- Owner: iskoldt-X
- License: mit
- Created: 2023-02-17T15:37:37.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-04T10:04:03.000Z (over 3 years ago)
- Last Synced: 2025-03-19T23:51:27.921Z (over 1 year ago)
- Topics: bot, docker, telegram, telegram-bot, telegram-bot-api
- Language: Python
- Homepage:
- Size: 65.4 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**English** | [δΈζ](https://icecoland.com/2023/02/19/savebot/)
# Savebot
Text, photos, videos... Save everything you throw to the telegram bot!
## Features
* Supported platforms: `amd64`, `arm64`.
* Save text messages into txt files with message id and the time as label.
* Save Photos and Videos into corresponding folders, and the caption into txt files.
* Nailed files larger than 20MB by using [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi#advantages-of-the-mtproto-api).
## Requirements
We need at least a telegram Bot and a Python3 environment to run this project.
Don't worry, you can easily get a telegram bot from [@BotFather](https://core.telegram.org/bots#how-do-i-create-a-bot).
Python3 environment is not a big deal. If you can use Docker, you are basicly a savebot master!
## Run savebot in Docker
If you got your `BOT_TOKEN`, your can use savebot to get your `TARGET_CHAT_ID`:
```
docker run -d \
--rm \
--name savebot \
-e MY_TOKEN= \
iskoldt/savebot:latest
```
Then send anything to your bot, you will get your `TARGET_CHAT_ID`
Run this:
```
docker run -d \
--name savebot \
--restart unless-stopped \
-e MY_TOKEN= \
-e TARGET_CHAT_ID= \
-v :/savebot/messages \
iskoldt/savebot:latest
```
Telegram bot API is limited on file size, so we need [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi#advantages-of-the-mtproto-api), get it here [Obtaining api_id](https://core.telegram.org/api/obtaining_api_id#obtaining-api-id)
Now you have `API_ID` and `API_HASH`, congrats!π
You can use savebot to save any file!
```
docker run -d \
--name savebot \
--restart unless-stopped \
-e MY_API_ID= \
-e MY_API_HASH= \
-e MY_TOKEN= \
-e TARGET_CHAT_ID= \
-v :/savebot/messages \
iskoldt/savebot:latest
```
## Run savebot in Python3 environment
Download savebot from github and Get your `TARGET_CHAT_ID`:
```
git clone https://github.com/iskoldt-X/savebot.git
cd savebot
pip3 install -r requirements.txt
#keep the word empty if you don't have it
export TARGET_CHAT_ID=empty
export MY_TOKEN=
export MY_API_ID=empty
export MY_API_HASH=empty
python3 savebot.py
```
Then send anything to your bot, you will get your `TARGET_CHAT_ID`
```
export TARGET_CHAT_ID=
python3 savebot.py
```
## Acknowledgments
We are grateful to Telethon and Pyrogram for providing such great APIs that enable us to create telegram bots like this one.
## Statement
Savebot is just a tool for locally saving your Telegram content. If you decide to save the content to public cloud storage, please make sure that you comply with the relevant laws and regulations on privacy and data protection.
## License
This project is licensed under the terms of the MIT license.