Awesome

A telegram 🤖 bot for music, videos, movies, EDM tracks, torrent downloads, files and more.

<a href="https://github.com/kodjunkie/beetube-bot/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" height="20"></a>

• Demo
• Features
• Installation
  • Telegram setup
  • Install on system
  • Install via docker
  • Install via docker compose
• Liked it?
• Tests
• License (MIT)

Demo

The deployed version can be found on telegram as <a href="https://t.me/beetube_bot" target="_blank">@beetube_bot</a>

• View Demo 1
• View Demo 2

Features

• Browse, search and download movies, music, anime and torrent
• Ability to browse music sorted by genre
• Ability to download music directly from chat
• Ability to paginate all returned results
• Supports personalized configurations

Installation

Beetube by default have been setup for easy deployment on <a href="https://heroku.com/" target="_blank">heroku</a>

Requirements

• Nodejs >= v14.x
• MongoDB (database)
• Have <a href="https://github.com/kodjunkie/node-raspar" target="_blank">node-raspar</a> deployed and note the server address

<a name="telegram+setup"></a>

Telegram Setup (required)

1. Create a new bot via <a href="https://telegram.me/BotFather" target="_blank">@BotFather</a> and note the token
2. Type /setcommands
3. Select the bot you just created
4. Copy and paste the texts below as the bot's commands

  start - start a conversation with the bot
  search - search through any category
  keyboard - show custom keyboard
  about - about this bot

<a name="install+system"></a>

Install on Local Machine

$ git clone https://github.com/kodjunkie/beetube-bot.git
$ cd beetube-bot
$ cp .env.example .env # update .env accordingly
# install dependencies
$ npm install
# have mongodb daemon running
# start the bot
$ npm start

<a name="install+docker"></a>

Installation via Docker

$ git clone https://github.com/kodjunkie/beetube-bot.git
$ cd beetube-bot
$ cp .env.example .env # update .env accordingly
#
# build the container
$ docker build -t beetube-bot .
# run the container
$ docker run --name beetube --env-file=.env -it beetube-bot

<a name="install+docker+compose"></a>

Installation via Docker Compose

$ git clone https://github.com/kodjunkie/beetube-bot.git
$ cd beetube-bot
$ cp .env.example .env # update .env accordingly
#
# To boot-up first time only
# Or whenever docker file is modified (builds the container)
$ docker compose up --build
# To boot-up without building the container (regular use)
$ docker compose up
# To shut-down
$ docker compose down

<a name="liked+it"></a>

Liked it?

Hope you liked this project, don't forget to give it a star ⭐

Tests

$ npm test

# via docker
$ docker exec -it beetube npm test

License

This project is opened under the <a href="https://github.com/kodjunkie/beetube-bot/blob/master/LICENSE" target="_blank">MIT 2.0 License</a> which allows very broad use for both academic and commercial purposes.