hertzg / jukebox

Just a simple Discord music bot.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Jukebox

Just a simple Discord music bot

CI Status Deploy

Usage

[⚠] Requires Node.JS version 12.9.0 or above.

  1. Install Node.JS
  2. Rename .env.schema to .env and fill out the values (example on .env.example)
  3. Install dependencies as stated here
  4. Run npm run build
  5. (Optional) Prune dev dependencies (This is good to save disk spaces):
$ npm prune --production
  1. Start it with npm start. And you're done!

Notes:

  1. You only need to configure .env file when you're using the Docker image
  2. If you're using "Deploy to Heroku" button, you don't need to do this.

Install

Without optional packages

$ npm install --no-optional

With optional packages (Recommended)

$ npm install

For optional packages, you need to install build tools as stated here and you also need to install Git

Docker

Want to use Dockerized version of jukebox? sure! we provide them on the Docker Hub and also in GitHub Container Registry

Volumes

Docker Volumes are needed to store cache and logs persistently

Example:

$ docker run --env-file .env --volume cache:/app/cache --volume logs:/app/logs --restart unless-stopped hazmi35/jukebox

We also provide docker-compose.yml if you want to go that way

Compose Example

$ docker-compose up

Features

  • A production-ready music bot, suitable for you that dislike hassling with the code.
  • Basic Commands (Help, Ping, Invite & Eval [for advanced bot owners])
  • Basic Music Commands (Play, Skip, Stop, Pause & Resume, Now Playing, Queue, Repeat, Volume)
  • Caching! (cache youtube downloads)
  • Configurable
  • Docker-friendly
  • Lightweight (only around 120MB with dev dependencies pruned)

Based on discord-music-bot

About

Just a simple Discord music bot.

License:GNU Affero General Public License v3.0


Languages

Language:TypeScript 96.3%Language:Shell 2.6%Language:Dockerfile 1.1%