Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kodjunkie/beetube-bot
🤖 A telegram bot for music, movies, anime, torrent, EDM tracks, series downloads, files, and more...
https://github.com/kodjunkie/beetube-bot
bot docker download downloader event-listener heroku javascript links magnet-link media-bot media-downloader movies music music-bot nodejs series telegram telegram-bot torrent torrent-downloader
Last synced: about 1 month ago
JSON representation
🤖 A telegram bot for music, movies, anime, torrent, EDM tracks, series downloads, files, and more...
- Host: GitHub
- URL: https://github.com/kodjunkie/beetube-bot
- Owner: kodjunkie
- License: mit
- Created: 2020-02-29T17:30:37.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-06T13:24:25.000Z (almost 2 years ago)
- Last Synced: 2024-11-26T05:51:57.406Z (about 2 months ago)
- Topics: bot, docker, download, downloader, event-listener, heroku, javascript, links, magnet-link, media-bot, media-downloader, movies, music, music-bot, nodejs, series, telegram, telegram-bot, torrent, torrent-downloader
- Language: JavaScript
- Homepage: https://t.me/Beetube_bot
- Size: 47.7 MB
- Stars: 139
- Watchers: 4
- Forks: 65
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
A telegram 🤖 bot for music, videos, movies, EDM tracks, torrent downloads, files and more.
[](https://t.me/beetube_bot) [](https://t.me/beetubers) [](https://github.com/kodjunkie/beetube-bot/actions) 
Table of Content
- [Demo](#demo)
- [Features](#features)
- [Installation](#installation)
- [Telegram setup](#telegram+setup)
- [Install on system](#install+system)
- [Install via docker](#install+docker)
- [Install via docker compose](#install+docker+compose)
- [Liked it?](#liked+it)
- [Tests](#tests)
- [License (MIT)](#license)
## Demo
The deployed version can be found on telegram as @beetube_bot
- [View Demo 1](https://github.com/kodjunkie/beetube-bot/blob/master/assets/demo-one.gif)
- [View Demo 2](https://github.com/kodjunkie/beetube-bot/blob/master/assets/demo-two.gif)
## 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 heroku
### Requirements
- Nodejs >= `v14.x`
- MongoDB (database)
- Have node-raspar deployed and note the server `address`
### Telegram Setup (required)
1. Create a new bot via @BotFather 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
```
### Install on Local Machine
```bash
$ 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
```
### Installation via Docker
```bash
$ 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
```
### Installation via Docker Compose
```bash
$ 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
```
## Liked it?
Hope you liked this project, don't forget to give it a star ⭐
## Tests
```bash
$ npm test
# via docker
$ docker exec -it beetube npm test
```
## License
This project is opened under the MIT 2.0 License which allows very broad use for both academic and commercial purposes.