{"id":15201666,"url":"https://github.com/sb0y/warp_beacon","last_synced_at":"2025-10-28T19:31:35.117Z","repository":{"id":219747481,"uuid":"695701482","full_name":"sb0y/warp_beacon","owner":"sb0y","description":"A Telegram bot to download from YouTube and Instagram","archived":false,"fork":false,"pushed_at":"2024-09-16T01:29:49.000Z","size":563,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-09-28T03:21:04.776Z","etag":null,"topics":["bot","bots","instagram","media","music","music-bot","scraping","shorts","social-network","telegram","telegram-bot","youtube","youtube-bot","youtube-music","youtube-shorts","youtube-shorts-bot","youtube-video"],"latest_commit_sha":null,"homepage":"https://bagrintsev.me","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sb0y.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-09-24T00:13:01.000Z","updated_at":"2024-08-18T02:14:21.000Z","dependencies_parsed_at":"2024-02-03T21:32:57.924Z","dependency_job_id":"337c9cbc-6f32-4461-8f92-38482080420d","html_url":"https://github.com/sb0y/warp_beacon","commit_stats":null,"previous_names":["sb0y/warp_beacon"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sb0y%2Fwarp_beacon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sb0y%2Fwarp_beacon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sb0y%2Fwarp_beacon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sb0y%2Fwarp_beacon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sb0y","download_url":"https://codeload.github.com/sb0y/warp_beacon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219858900,"owners_count":16556039,"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","bots","instagram","media","music","music-bot","scraping","shorts","social-network","telegram","telegram-bot","youtube","youtube-bot","youtube-music","youtube-shorts","youtube-shorts-bot","youtube-video"],"created_at":"2024-09-28T03:20:39.935Z","updated_at":"2025-10-28T19:31:35.110Z","avatar_url":"https://github.com/sb0y.png","language":"Python","funding_links":["https://opencollective.com/warp_beacon"],"categories":[],"sub_categories":[],"readme":"# warp_beacon [![Upload Python Package](https://github.com/sb0y/warp_beacon/actions/workflows/python-publish.yml/badge.svg)](https://github.com/sb0y/warp_beacon/actions/workflows/python-publish.yml) [![Docker Image CI](https://github.com/sb0y/warp_beacon/actions/workflows/docker-image.yml/badge.svg)](https://github.com/sb0y/warp_beacon/actions/workflows/docker-image.yml) [![Build DEB package](https://github.com/sb0y/warp_beacon/actions/workflows/build-deb.yml/badge.svg)](https://github.com/sb0y/warp_beacon/actions/workflows/build-deb.yml)\n\u003e because content should travel freely\n\nTelegram bot that expands media links from external social networks.\nWorks with links sent in private messages or group chats.\n\nJust send a media link to the bot, and it will reply with a video or audio file.\n\n| | | |\n|:-------------------------:|:-------------------------:|:-------------------------:|\n|\u003cimg width=\"700\" alt=\"Yotube Video usage example\" src=\"https://github.com/user-attachments/assets/280b058f-325b-4386-9556-f145f6db9cfa\"\u003e Yotube Video usage example |\u003cimg width=\"700\" alt=\"Youtube Music usage example\" src=\"https://github.com/user-attachments/assets/3a462a3b-8c80-460f-aa66-c39db24f7a24\"\u003e Youtube Music usage example|\u003cimg width=\"703\" alt=\"image\" src=\"https://github.com/user-attachments/assets/384206ea-1371-48d5-a717-92aff06fa339\"\u003e Instagram Reels usage example |\n|\u003cimg width=\"700\" alt=\"Instagram Photo post usage example\" src=\"https://github.com/user-attachments/assets/29324b94-7314-4a38-8790-3483011d355d\"\u003e Instagram Photo post usage example|\u003cimg width=\"700\" alt=\"Instagram Photo Carousel usage\" src=\"https://github.com/user-attachments/assets/2598e329-e16e-455e-91e9-a027e8994283\"\u003e Instagram Photo Carousel usage example|\u003cimg width=\"757\" alt=\"Instagram Photo bulk Strories download usage example\" src=\"https://github.com/user-attachments/assets/2c8c91ac-6ade-4d1d-a677-2b36bb40ff39\"\u003e Instagram Photo bulk Strories download usage example|\n|\u003cimg width=\"700\" alt=\"Instagram specific Story download usage example\" src=\"https://github.com/user-attachments/assets/03dc70c5-6933-4122-9c7c-5f7d734d117b\"\u003e Instagram specific Story download usage example|\u003cimg width=\"700\" alt=\"Group chat usage example\" src=\"https://github.com/user-attachments/assets/649fcb1e-785b-4efd-9153-69644c6d898b\"\u003e Group chat usage example|\n\n### **Warp Beacon manifesto**\n\n\u003e Once, the Internet was built as a borderless network — a space where knowledge, culture, and ideas could flow freely across the globe.  \n\u003e But over time, freedom gave way to artificial walls, anti-bot shields, and region locks.\n\u003e\n\u003e **warp_beacon** is our answer to that shift.\n\u003e\n\u003e This is a tool for those who refuse to accept \"access denied by geolocation\" or \"content unavailable in your region.\"  \n\u003e It is a bridge over ML filters, CAPTCHAs, and man-made barriers.\n\u003e\n\u003e We don’t break the rules — we restore the original spirit of the Internet:  \n\u003e 📡 **free exchange of information**,  \n\u003e 🌍 **unrestricted access to global content**,  \n\u003e 🤖 **tools that serve the user**, not the platform.\n\u003e\n\u003e **warp_beacon** — the freedom to deliver content where it’s needed most.\n\n## Configuration example ##\n\nIn order to setup your own instance, you will need:\n\n1. Obtain your own brand new `TG_TOKEN`. To do that, write to [@BotFather](https://t.me/BotFather).\n2. Obtain `TG_API_ID`, `TG_API_HASH`, `TG_BOT_NAME`. Learn more [here](https://core.telegram.org/api/obtaining_api_id).\n\nAll bot configuration stored in [warp_beacon.conf](https://github.com/sb0y/warp_beacon/blob/main/etc/warp_beacon.conf) file.\n\n```env\nTG_TOKEN=\"you telegram token received from @BotFather\"\n# these 3 settings should be obtained at https://my.telegram.org/apps\n# learn more: https://core.telegram.org/api/obtaining_api_id\n###\nTG_API_ID=\"\"\nTG_API_HASH=\"\"\nTG_BOT_NAME=\"\"\n# bot admin username, e.g.: @BelisariusCawl\n# Used for communication between the bot and the administrator.\n# For example, if authorization is required for YouTube, bot can send an authorization code via message to this address.\nTG_BOT_ADMIN_USERNAME=\"\"\n###\nINSTAGRAM_LOGIN=\"instagram login (email or cell phone)\"\nINSTAGRAM_PASSWORD=\"instgram password\"\nMONGODB_HOST=\"mongodb\"\nMONGODB_PORT=\"27017\"\nMONGODB_USER=\"root\"\nMONGODB_PASSWORD=\"changeme\"\n# more information about accounts.json and proxies.json\n# can be found in project wiki\n# https://github.com/sb0y/warp_beacon/wiki/Introduction-in-account.json-file\nSERVICE_ACCOUNTS_FILE=/var/warp_beacon/accounts.json\nPROXY_FILE=/var/warp_beacon/proxies.json\n\n# workers settings\n# default: min(32, os.cpu_count() + 4)\n#TG_WORKERS_POOL_SIZE=3\n#UPLOAD_POOL_SIZE=3\n#WORKERS_POOL_SIZE=3\nENABLE_DONATES=true\nDONATE_LINK=\"your donate link which will be shown if ENABLE_DONATES where set\"\n```\n## Deployed example bot ##\n[Try it 🚀](https://t.me/anus_sebe_zablokiruy_bot)\n\n## How to run ##\nAny Linux machine will suit in.\n\nInstall docker and git\n```bash\nsudo apt update\n# uninstall old docker packages\nfor pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done\nsudo apt install ca-certificates curl git\nsudo install -m 0755 -d /etc/apt/keyrings\nsudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc\nsudo chmod a+r /etc/apt/keyrings/docker.asc\n# Add the repository to Apt sources:\necho \\\n  \"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \\\n  $(. /etc/os-release \u0026\u0026 echo \"$VERSION_CODENAME\") stable\" | \\\n  sudo tee /etc/apt/sources.list.d/docker.list \u003e /dev/null\nsudo apt update\nsudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin git\n```\n\nDownload sources\n```bash\ngit clone https://github.com/sb0y/warp_beacon.git\n```\nGo to sources directory\n```bash\ncd warp_beacon\n```\n\nRun app\n```bash\nsudo docker compose up -d\n```\n\nCheck logs\n```bash\nsudo docker compose logs warp_beacon -f\n```\n## Upgrading ##\nIf you are using `image-prod` (set in `docker-compose.yml` by default), just rebuild your image:\n```bash\ncd your_warp_beacon_sources_directory/\nsudo docker compose build --no-cache\n```\nRecreate existing container:\n```bash\nsudo docker compose up -d\n```\n\n## How to install from PIP ##\n\n```bash\nsudo apt update\nsudo apt install python3-pip\nsudo pip install warp-beacon\n```\n\nYour configuration file will be located at `/usr/local/lib/python3.10/dist-packages/etc/warp_beacon/warp_beacon.conf`.\nFor convenience, we will copy it to a common directory:\n\n```bash\nmkdir /etc/warp_beacon\ncp /usr/local/lib/python3.10/dist-packages/etc/warp_beacon/warp_beacon.conf /etc/warp_beacon/warp_beacon.conf\n```\n\nRun the app\n\n```bash\nsource /etc/warp_beacon/warp_beacon.conf \u0026\u0026 /usr/local/bin/warp_beacon\n```\n\nMost likely you will need a systemd service so that you don't have to start the service manually and don't have to worry about service start on server reboot.\n\n```bash\ncp /usr/local/lib/python3.10/dist-packages/lib/systemd/system/warp_beacon.service /lib/systemd/system\nsystemctl unmask warp_beacon.service\nsystemctl enable warp_beacon.service\n# start the service app\nsystemctl start warp_beacon.service\n```\n\n## How to build Python whl package ##\n```bash\nsudo apt install python3-pip python3-build python3-virtualenv dh-virtualenv\n# If you are getting build errors you probably need the latest version of python3-build\nsudo python3 -m pip install --upgrade build\npython3 -m build\n```\n\n## How to build Ubuntu deb package ##\n\n```bash\nsudo apt update\nsudo apt install debhelper python3-pip python3-build python3-virtualenv dh-virtualenv dh-python\n# If you are getting build errors you probably need the latest version of python3-build\nsudo python3 -m pip install --upgrade build\n```\n\nbuild deb file\n\n```bash\ndpkg-buildpackage -us -uc -b\n```\n\n# Wiki\n* [MongoDB backup and restore](https://github.com/sb0y/warp_beacon/wiki/MongoDB-backup-and-restore)\n* [Introduction in account.json file](https://github.com/sb0y/warp_beacon/wiki/Introduction-in-account.json-file)\n\n# Support Warp Beacon project\n\n[\u003cimg src=\"https://opencollective.com/webpack/donate/button@2x.png?color=blue\" alt=\"Donate\" width=\"300px\"\u003e](https://opencollective.com/warp_beacon) [\u003cimg src=\"https://raw.githubusercontent.com/sb0y/warp_beacon/refs/heads/main/assets/cc-group-black.png?raw=true\" alt=\"CryptoCloud Accepted\" width=\"250px\"\u003e](https://pay.cryptocloud.plus/pos/W5BMtNQt5bJFoW2E)\n\n\u003c!-- [![Backers on Open Collective](https://opencollective.com/warp_beacon/backers/badge.svg)](https://opencollective.com/warp_beacon) --\u003e\n\u003c!-- #[![Sponsors on Open Collective](https://opencollective.com/warp_beacon/sponsors/badge.svg)](https://opencollective.com/warp_beacon) --\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsb0y%2Fwarp_beacon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsb0y%2Fwarp_beacon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsb0y%2Fwarp_beacon/lists"}