{"id":13823997,"url":"https://github.com/kodjunkie/beetube-bot","last_synced_at":"2025-10-29T22:09:51.885Z","repository":{"id":37015841,"uuid":"244011600","full_name":"kodjunkie/beetube-bot","owner":"kodjunkie","description":"🤖 A telegram bot for music, movies, anime, torrent, EDM tracks, series downloads, files, and more...","archived":false,"fork":false,"pushed_at":"2023-04-06T13:24:25.000Z","size":50036,"stargazers_count":143,"open_issues_count":0,"forks_count":67,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-07T20:49:30.733Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://t.me/Beetube_bot","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kodjunkie.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}},"created_at":"2020-02-29T17:30:37.000Z","updated_at":"2025-03-19T19:44:54.000Z","dependencies_parsed_at":"2023-10-21T13:00:51.569Z","dependency_job_id":null,"html_url":"https://github.com/kodjunkie/beetube-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kodjunkie/beetube-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodjunkie%2Fbeetube-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodjunkie%2Fbeetube-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodjunkie%2Fbeetube-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodjunkie%2Fbeetube-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kodjunkie","download_url":"https://codeload.github.com/kodjunkie/beetube-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodjunkie%2Fbeetube-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271314372,"owners_count":24738161,"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","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","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"],"created_at":"2024-08-04T09:00:52.548Z","updated_at":"2025-10-29T22:09:46.850Z","avatar_url":"https://github.com/kodjunkie.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/logo-coloured.png\" alt=\"Beetube\" height=\"200\" width=\"auto\" /\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nA telegram 🤖 bot for music, videos, movies, EDM tracks, torrent downloads, files and more.\n\n[![https://t.me/beetube_bot](https://img.shields.io/badge/🤖%20Telegram-Bot-neon.svg)](https://t.me/beetube_bot) [![https://t.me/beetubers](https://img.shields.io/badge/💬%20Telegram-Channel-blue.svg)](https://t.me/beetubers) [![Beetube CI](https://github.com/kodjunkie/beetube-bot/workflows/Beetube%20CI/badge.svg)](https://github.com/kodjunkie/beetube-bot/actions) \u003ca href=\"https://github.com/kodjunkie/beetube-bot/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\" height=\"20\"\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003cb\u003eTable of Content\u003c/b\u003e\u003c/summary\u003e\n\n- [Demo](#demo)\n- [Features](#features)\n- [Installation](#installation)\n  - [Telegram setup](#telegram+setup)\n  - [Install on system](#install+system)\n  - [Install via docker](#install+docker)\n  - [Install via docker compose](#install+docker+compose)\n- [Liked it?](#liked+it)\n- [Tests](#tests)\n- [License (MIT)](#license)\n\n\u003c/details\u003e\n\n## Demo\n\nThe deployed version can be found on telegram as \u003ca href=\"https://t.me/beetube_bot\" target=\"_blank\"\u003e@beetube_bot\u003c/a\u003e\n\n- [View Demo 1](https://github.com/kodjunkie/beetube-bot/blob/master/assets/demo-one.gif)\n- [View Demo 2](https://github.com/kodjunkie/beetube-bot/blob/master/assets/demo-two.gif)\n\n## Features\n\n- Browse, search and download `movies`, `music`, `anime` and `torrent`\n- Ability to browse `music` sorted by genre\n- Ability to download `music` directly from chat\n- Ability to paginate all returned results\n- Supports personalized configurations\n\n## Installation\n\n\u003e Beetube by default have been setup for easy deployment on \u003ca href=\"https://heroku.com/\" target=\"_blank\"\u003eheroku\u003c/a\u003e\n\n### Requirements\n\n- Nodejs \u003e= `v14.x`\n- MongoDB (database)\n- Have \u003ca href=\"https://github.com/kodjunkie/node-raspar\" target=\"_blank\"\u003enode-raspar\u003c/a\u003e deployed and note the server `address`\n\n\u003ca name=\"telegram+setup\"\u003e\u003c/a\u003e\n\n### Telegram Setup (required)\n\n1.  Create a new bot via \u003ca href=\"https://telegram.me/BotFather\" target=\"_blank\"\u003e@BotFather\u003c/a\u003e and note the `token`\n2.  Type `/setcommands`\n3.  Select the bot you just created\n4.  Copy and paste the texts below as the bot's commands\n\n```\n  start - start a conversation with the bot\n  search - search through any category\n  keyboard - show custom keyboard\n  about - about this bot\n```\n\n\u003ca name=\"install+system\"\u003e\u003c/a\u003e\n\n### Install on Local Machine\n\n```bash\n$ git clone https://github.com/kodjunkie/beetube-bot.git\n$ cd beetube-bot\n$ cp .env.example .env # update .env accordingly\n# install dependencies\n$ npm install\n# have mongodb daemon running\n# start the bot\n$ npm start\n```\n\n\u003ca name=\"install+docker\"\u003e\u003c/a\u003e\n\n### Installation via Docker\n\n```bash\n$ git clone https://github.com/kodjunkie/beetube-bot.git\n$ cd beetube-bot\n$ cp .env.example .env # update .env accordingly\n#\n# build the container\n$ docker build -t beetube-bot .\n# run the container\n$ docker run --name beetube --env-file=.env -it beetube-bot\n```\n\n\u003ca name=\"install+docker+compose\"\u003e\u003c/a\u003e\n\n### Installation via Docker Compose\n\n```bash\n$ git clone https://github.com/kodjunkie/beetube-bot.git\n$ cd beetube-bot\n$ cp .env.example .env # update .env accordingly\n#\n# To boot-up first time only\n# Or whenever docker file is modified (builds the container)\n$ docker compose up --build\n# To boot-up without building the container (regular use)\n$ docker compose up\n# To shut-down\n$ docker compose down\n```\n\n\u003ca name=\"liked+it\"\u003e\u003c/a\u003e\n\n## Liked it?\n\nHope you liked this project, don't forget to give it a star ⭐\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://starchart.cc/kodjunkie/beetube-bot\"\u003e\n    \u003cimg src=\"https://starchart.cc/kodjunkie/beetube-bot.svg\" width=\"600px\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## Tests\n\n```bash\n$ npm test\n\n# via docker\n$ docker exec -it beetube npm test\n```\n\n## License\n\nThis project is opened under the \u003ca href=\"https://github.com/kodjunkie/beetube-bot/blob/master/LICENSE\" target=\"_blank\"\u003eMIT 2.0 License\u003c/a\u003e which allows very broad use for both academic and commercial purposes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodjunkie%2Fbeetube-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkodjunkie%2Fbeetube-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodjunkie%2Fbeetube-bot/lists"}