https://github.com/sb0y/warp_beacon
A Telegram bot to download from YouTube and Instagram
https://github.com/sb0y/warp_beacon
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
Last synced: 8 months ago
JSON representation
A Telegram bot to download from YouTube and Instagram
- Host: GitHub
- URL: https://github.com/sb0y/warp_beacon
- Owner: sb0y
- License: apache-2.0
- Created: 2023-09-24T00:13:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-16T01:29:49.000Z (almost 2 years ago)
- Last Synced: 2024-09-28T03:21:04.776Z (over 1 year ago)
- 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
- Language: Python
- Homepage: https://bagrintsev.me
- Size: 550 KB
- Stars: 5
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# warp_beacon [](https://github.com/sb0y/warp_beacon/actions/workflows/python-publish.yml) [](https://github.com/sb0y/warp_beacon/actions/workflows/docker-image.yml) [](https://github.com/sb0y/warp_beacon/actions/workflows/build-deb.yml)
> because content should travel freely
Telegram bot that expands media links from external social networks.
Works with links sent in private messages or group chats.
Just send a media link to the bot, and it will reply with a video or audio file.
| | | |
|:-------------------------:|:-------------------------:|:-------------------------:|
|
Yotube Video usage example |
Youtube Music usage example|
Instagram Reels usage example |
|
Instagram Photo post usage example|
Instagram Photo Carousel usage example|
Instagram Photo bulk Strories download usage example|
|
Instagram specific Story download usage example|
Group chat usage example|
### **Warp Beacon manifesto**
> Once, the Internet was built as a borderless network — a space where knowledge, culture, and ideas could flow freely across the globe.
> But over time, freedom gave way to artificial walls, anti-bot shields, and region locks.
>
> **warp_beacon** is our answer to that shift.
>
> This is a tool for those who refuse to accept "access denied by geolocation" or "content unavailable in your region."
> It is a bridge over ML filters, CAPTCHAs, and man-made barriers.
>
> We don’t break the rules — we restore the original spirit of the Internet:
> 📡 **free exchange of information**,
> 🌍 **unrestricted access to global content**,
> 🤖 **tools that serve the user**, not the platform.
>
> **warp_beacon** — the freedom to deliver content where it’s needed most.
## Configuration example ##
In order to setup your own instance, you will need:
1. Obtain your own brand new `TG_TOKEN`. To do that, write to [@BotFather](https://t.me/BotFather).
2. Obtain `TG_API_ID`, `TG_API_HASH`, `TG_BOT_NAME`. Learn more [here](https://core.telegram.org/api/obtaining_api_id).
All bot configuration stored in [warp_beacon.conf](https://github.com/sb0y/warp_beacon/blob/main/etc/warp_beacon.conf) file.
```env
TG_TOKEN="you telegram token received from @BotFather"
# these 3 settings should be obtained at https://my.telegram.org/apps
# learn more: https://core.telegram.org/api/obtaining_api_id
###
TG_API_ID=""
TG_API_HASH=""
TG_BOT_NAME=""
# bot admin username, e.g.: @BelisariusCawl
# Used for communication between the bot and the administrator.
# For example, if authorization is required for YouTube, bot can send an authorization code via message to this address.
TG_BOT_ADMIN_USERNAME=""
###
INSTAGRAM_LOGIN="instagram login (email or cell phone)"
INSTAGRAM_PASSWORD="instgram password"
MONGODB_HOST="mongodb"
MONGODB_PORT="27017"
MONGODB_USER="root"
MONGODB_PASSWORD="changeme"
# more information about accounts.json and proxies.json
# can be found in project wiki
# https://github.com/sb0y/warp_beacon/wiki/Introduction-in-account.json-file
SERVICE_ACCOUNTS_FILE=/var/warp_beacon/accounts.json
PROXY_FILE=/var/warp_beacon/proxies.json
# workers settings
# default: min(32, os.cpu_count() + 4)
#TG_WORKERS_POOL_SIZE=3
#UPLOAD_POOL_SIZE=3
#WORKERS_POOL_SIZE=3
ENABLE_DONATES=true
DONATE_LINK="your donate link which will be shown if ENABLE_DONATES where set"
```
## Deployed example bot ##
[Try it 🚀](https://t.me/anus_sebe_zablokiruy_bot)
## How to run ##
Any Linux machine will suit in.
Install docker and git
```bash
sudo apt update
# uninstall old docker packages
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done
sudo apt install ca-certificates curl git
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# Add the repository to Apt sources:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin git
```
Download sources
```bash
git clone https://github.com/sb0y/warp_beacon.git
```
Go to sources directory
```bash
cd warp_beacon
```
Run app
```bash
sudo docker compose up -d
```
Check logs
```bash
sudo docker compose logs warp_beacon -f
```
## Upgrading ##
If you are using `image-prod` (set in `docker-compose.yml` by default), just rebuild your image:
```bash
cd your_warp_beacon_sources_directory/
sudo docker compose build --no-cache
```
Recreate existing container:
```bash
sudo docker compose up -d
```
## How to install from PIP ##
```bash
sudo apt update
sudo apt install python3-pip
sudo pip install warp-beacon
```
Your configuration file will be located at `/usr/local/lib/python3.10/dist-packages/etc/warp_beacon/warp_beacon.conf`.
For convenience, we will copy it to a common directory:
```bash
mkdir /etc/warp_beacon
cp /usr/local/lib/python3.10/dist-packages/etc/warp_beacon/warp_beacon.conf /etc/warp_beacon/warp_beacon.conf
```
Run the app
```bash
source /etc/warp_beacon/warp_beacon.conf && /usr/local/bin/warp_beacon
```
Most 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.
```bash
cp /usr/local/lib/python3.10/dist-packages/lib/systemd/system/warp_beacon.service /lib/systemd/system
systemctl unmask warp_beacon.service
systemctl enable warp_beacon.service
# start the service app
systemctl start warp_beacon.service
```
## How to build Python whl package ##
```bash
sudo apt install python3-pip python3-build python3-virtualenv dh-virtualenv
# If you are getting build errors you probably need the latest version of python3-build
sudo python3 -m pip install --upgrade build
python3 -m build
```
## How to build Ubuntu deb package ##
```bash
sudo apt update
sudo apt install debhelper python3-pip python3-build python3-virtualenv dh-virtualenv dh-python
# If you are getting build errors you probably need the latest version of python3-build
sudo python3 -m pip install --upgrade build
```
build deb file
```bash
dpkg-buildpackage -us -uc -b
```
# Wiki
* [MongoDB backup and restore](https://github.com/sb0y/warp_beacon/wiki/MongoDB-backup-and-restore)
* [Introduction in account.json file](https://github.com/sb0y/warp_beacon/wiki/Introduction-in-account.json-file)
# Support Warp Beacon project
[
](https://opencollective.com/warp_beacon) [
](https://pay.cryptocloud.plus/pos/W5BMtNQt5bJFoW2E)