{"id":26475895,"url":"https://github.com/iskoldt-x/savebot","last_synced_at":"2025-07-18T16:38:02.554Z","repository":{"id":101183004,"uuid":"603087446","full_name":"iskoldt-X/savebot","owner":"iskoldt-X","description":"Save everything you throw to the telegram bot. Run this bot with Docker!","archived":false,"fork":false,"pushed_at":"2023-03-04T10:04:03.000Z","size":67,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T23:51:27.921Z","etag":null,"topics":["bot","docker","telegram","telegram-bot","telegram-bot-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iskoldt-X.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-17T15:37:37.000Z","updated_at":"2024-07-11T02:55:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"6140ed9f-5773-4af1-b35a-ea0bcabfe930","html_url":"https://github.com/iskoldt-X/savebot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iskoldt-X/savebot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskoldt-X%2Fsavebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskoldt-X%2Fsavebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskoldt-X%2Fsavebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskoldt-X%2Fsavebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iskoldt-X","download_url":"https://codeload.github.com/iskoldt-X/savebot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskoldt-X%2Fsavebot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265793684,"owners_count":23829180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","docker","telegram","telegram-bot","telegram-bot-api"],"created_at":"2025-03-19T23:50:27.849Z","updated_at":"2025-07-18T16:38:02.546Z","avatar_url":"https://github.com/iskoldt-X.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"**English** | [中文](https://icecoland.com/2023/02/19/savebot/)\n\n# Savebot\nText, photos, videos... Save everything you throw to the telegram bot!\n\n\u003cimg src=\"https://img.shields.io/github/license/iskoldt-X/savebot.svg\"/\u003e \u003cimg src=\"https://img.shields.io/docker/pulls/iskoldt/savebot.svg\"/\u003e\n\n![iphone13pro](https://user-images.githubusercontent.com/99703980/220041852-02a39783-4851-49a1-a1ab-f7dcf1fb8fc5.png)\n\n## Features\n\n* Supported platforms: `amd64`, `arm64`.\n* Save text messages into txt files with message id and the time as label.\n* Save Photos and Videos into corresponding folders, and the caption into txt files.\n* Nailed files larger than 20MB by using [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi#advantages-of-the-mtproto-api).\n\n\n## Requirements\n\nWe need at least a telegram Bot and a Python3 environment to run this project.\n\nDon't worry, you can easily get a telegram bot from [@BotFather](https://core.telegram.org/bots#how-do-i-create-a-bot).\n\nPython3 environment is not a big deal. If you can use Docker, you are basicly a savebot master!\n\n\n## Run savebot in Docker\n\nIf you got your `BOT_TOKEN`, your can use savebot to get your `TARGET_CHAT_ID`:\n\n```\ndocker run -d \\\n  --rm \\\n  --name savebot \\\n  -e MY_TOKEN=\u003cBOT_TOKEN\u003e \\\n  iskoldt/savebot:latest\n```\nThen send anything to your bot, you will get your `TARGET_CHAT_ID`\n\nRun this:\n```\ndocker run -d \\\n  --name savebot \\\n  --restart unless-stopped \\\n  -e MY_TOKEN=\u003cBOT_TOKEN\u003e \\\n  -e TARGET_CHAT_ID=\u003cTARGET_CHAT_ID\u003e \\\n  -v \u003cyourdir\u003e:/savebot/messages \\\n  iskoldt/savebot:latest\n```\n\nTelegram 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)\n\nNow you have `API_ID` and `API_HASH`, congrats!🎉\n\nYou can use savebot to save any file!\n\n```\ndocker run -d \\\n  --name savebot \\\n  --restart unless-stopped \\\n  -e MY_API_ID=\u003cAPI_ID\u003e \\\n  -e MY_API_HASH=\u003cAPI_HASH\u003e \\\n  -e MY_TOKEN=\u003cBOT_TOKEN\u003e \\\n  -e TARGET_CHAT_ID=\u003cTARGET_CHAT_ID\u003e \\\n  -v \u003cyourdir\u003e:/savebot/messages \\\n  iskoldt/savebot:latest\n```\n\n\n## Run savebot in Python3 environment\n\nDownload savebot from github and Get your `TARGET_CHAT_ID`:\n\n```\ngit clone https://github.com/iskoldt-X/savebot.git\ncd savebot\npip3 install -r requirements.txt\n\n#keep the word empty if you don't have it\nexport TARGET_CHAT_ID=empty\nexport MY_TOKEN=\u003cBOT_TOKEN\u003e\nexport MY_API_ID=empty\nexport MY_API_HASH=empty\n\npython3 savebot.py\n```\n\nThen send anything to your bot, you will get your `TARGET_CHAT_ID`\n\n```\nexport TARGET_CHAT_ID=\u003cyour TARGET_CHAT_ID\u003e\npython3 savebot.py\n```\n\n## Acknowledgments\n\nWe are grateful to Telethon and Pyrogram for providing such great APIs that enable us to create telegram bots like this one.\n\n## Statement\n\nSavebot 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.\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiskoldt-x%2Fsavebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiskoldt-x%2Fsavebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiskoldt-x%2Fsavebot/lists"}