namuan / tele-vdo-rider

Tube Telegram Rider

Telegram Bot 🤖 to convert videos to mp3 at your service. It uses youtube-dl so videos from any supported websites can be used.

✅ Support Youtube playlists along with a number of other websites.

✅ Convert to the best possible audio track

✅ Work around Telegram size limitation by chunking large MP3 files

Clone project

git clone https://github.com/namuan/tele-vdo-rider.git

Running it locally

To run it, you'll need to create a new bot using @botfather. Note down the bot token once your bot is registered. Copy env.cfg.sample to env.cfg and set the token value for TELEGRAM_BOT_TOKEN variable.

cp env.cfg.sample env.cfg

Then we'll setup a local python virtual environment and install required dependencies. Make sure you have python3 installed before running the following command.

make setup

We also need to set up ffmpeg which is used to convert Video -> MP3. On a mac, it is a single command using brew.

brew install ffmpeg

You'll find instructions to set up on other platforms.

Next, run the bot

make run

If previous commands worked then this will start the bot. Try adding your new bot on Telegram and send a youtube video.

Here is a good one to try. The first 20 hours -- how to learn anything | Josh Kaufman | TEDxCSU

Self-Hosting

Although running locally is fine for testing, you may want to run it in background to avoid any disruptions. Here is a quick guide for setting it up on a VPS or RaspberryPi (Once you get past installing ffmpeg on it 😡).

Step 1: Setup VPS or use existing server(Raspberry Pi) Start a new VPS with Ubuntu on Vultr (Affiliate Link) or DigitalOcean (Affiliate Link).

☕️ Wait for it to come up online.

🧹 Remember: Clean up - Make sure you delete this server if not used to avoid incurring cost.

Step 2: Checking connectivity

Once you have the server running, we'll try to connect to it. It is better to set up a dedicated host entry as below. Some commands in the Makefile assumes that the host entry matches the project directory.

👉 Tip: Splitting SSH Config - I used to use poet to split ssh files but from OpenSSH 7.3 it supports the Include directive to allow multiple ssh config files. It makes it easy and manageable for working with many SSH entries

Host tele-vdo-rider
	User root
	HostName xx.xx.xx.xx
	Port 22
	IdentitiesOnly yes
	IdentityFile ~/.ssh/dfiles

So if you have the above entry under ~/.ssh, running the following command will try to connect and ssh into the server.

$ make ssh

Make sure this works before continuing, and note that you may have to enter the Password from the VPS provider (Vultr/DigitalOcean).

Step 3: Installing dependencies

We also need to install a few dependencies if they are missing from the server. The following command will take care of that.

# ssh into server
$ make server

Step 4: Starting up Bot

Again, we'll use the make command to start the bot in a screen session.

make start

The bot is running once the command finishes. Try sending another Youtube video to see it in action.

Step 5: Testing if Bot is running

If there is anything wrong, you can see what is going on the server.

# ssh
make ssh

# check screen sessions
screen -ls

# attach to existing screen session
screen -x tele-vdo-rider

# detach from a session
Ctrl + A then D

Make sure that you detach from screen session before leaving the server to keep the bot running.

Step 6: [Optional] Updating Bot

Run the following command from your local machine, and it should update the bot and restart the session automatically.

make start

Credits

• python-telegram-api
• ffmpeg
• mp3splt
• yt2audiobot
• Telegram

License

See LICENSE