Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hmes98318/music-disc
A Discord music bot, supports YouTube, Spotify, SoundCloud, Deezer streams and web dashboard.
https://github.com/hmes98318/music-disc
discord discord-bot discord-js discord-music discord-music-bot discord-music-bot-24-7 discordjs-v14 docker docker-compose music-bot nodejs
Last synced: 3 days ago
JSON representation
A Discord music bot, supports YouTube, Spotify, SoundCloud, Deezer streams and web dashboard.
- Host: GitHub
- URL: https://github.com/hmes98318/music-disc
- Owner: hmes98318
- License: mit
- Created: 2021-09-24T18:56:38.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-09T01:29:43.000Z (14 days ago)
- Last Synced: 2024-12-09T02:33:16.026Z (14 days ago)
- Topics: discord, discord-bot, discord-js, discord-music, discord-music-bot, discord-music-bot-24-7, discordjs-v14, docker, docker-compose, music-bot, nodejs
- Language: TypeScript
- Homepage: https://musicdisc.ggwp.tw
- Size: 1.92 MB
- Stars: 116
- Watchers: 5
- Forks: 106
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Music Disc
A discord music bot, supports **YouTube**, **Spotify**, **SoundCloud**, **Deezer** streams and web dashboard.
Developed based on [**discord.js v14**](https://discord.js.org/#/), [**LavaShark**](https://lavashark.js.org/), [**Lavalink**](https://github.com/lavalink-devs/Lavalink/).
### Features
* Stable
* Use Lavalink
* Web dashboard
* Local node
* Docker images
If you need the version of [**discord-player**](https://github.com/Androz2091/discord-player), please refer to this [**branch**](https://github.com/hmes98318/Music-Disc-discord-player).
If you encounter any issues or would like to contribute to the community, please join our [Discord server](https://discord.gg/7rQEx7SPGr).
## Deploying with node.js
### Clone the latest version of the repository
```
git clone -b v3.1.0 https://github.com/hmes98318/Music-Disc.git
```
or [**click here**](https://github.com/hmes98318/Music-Disc/releases) to download
### Install the dependencies
install all the dependencies from [**package.json**](./package.json)
```
npm ci
```
### Add Lavalink node
Edit the [`nodelist.json`](./nodelist.json) file to add a [Lavalink](https://github.com/lavalink-devs/Lavalink) node.
Only supports Lavalink **v4** nodes, **v4.0.8** or higher is recommended.
* Use [public node](https://lavalink-list.darrennathanael.com/)
* or [host your own](https://blog.darrennathanael.com/post/how-to-lavalink/)
* or enable [local node setup](https://musicdisc.ggwp.tw/docs/Environment-variables-description#local-node)
Please refer to this [**documentation**](https://lavashark.js.org/docs/server-config) for detailed information.
```json
[
{
"id": "Node 1",
"hostname": "localhost",
"port": 2333,
"password": "youshallnotpass"
}
]
```
### Configure environment
Refer to [**.env.example**](./.env.example) and edit the **.env** fileEdit the file.
```env
# Discord Bot Token
BOT_TOKEN = "your_token"
# Admin of the bot (User ID)
# For multiple admins, separate their user IDs with commas.
# OAUTH2 mode requires setting BOT_ADMIN, BOT_CLIENT_SECRET value
BOT_ADMIN = ""
BOT_CLIENT_SECRET = ""
# Bot settings
BOT_NAME = "Music Disc"
BOT_PREFIX = "+"
BOT_STATUS = "online"
BOT_PLAYING = "+help | music"
BOT_EMBEDS_COLOR = "#FFFFFF"
BOT_SLASH_COMMAND = true
# Volume settings
DEFAULT_VOLUME = 50
MAX_VOLUME = 100
# Auto leave channel settings
AUTO_LEAVE = true
AUTO_LEAVE_COOLDOWN = 5000
# Show voice channel updates
DISPLAY_VOICE_STATE = true
# Web dashboard settings
ENABLE_SITE = true
SITE_PORT = 33333
SITE_LOGIN_TYPE = "USER" # "USER" | "OAUTH2"
# USER mode settings
SITE_USERNAME = "admin"
SITE_PASSWORD = "000"
# OAUTH2 mode settings
SITE_OAUTH2_LINK = "" # Your OAuth2 authentication link
SITE_OAUTH2_REDIRECT_URI = "http://localhost:33333/login" # Redirect link after OAuth2 authentication is complete
# Local Lavalink node
ENABLE_LOCAL_NODE = false
LOCAL_NODE_AUTO_RESTART = true
# LOCAL_NODE_DOWNLOAD_LINK = ""
```
* [**Environment variables detailed description**](https://musicdisc.ggwp.tw/docs/Environment-variables-description)
### Running the script
```
npm run start
```
## Deploying with Docker
**image link** : https://hub.docker.com/r/hmes98318/music-disc
If you don't have any available nodes, you need to first start the server container using [Docker Compose](server/docker-compose.yml) in the server directory.
### Start with Docker Compose
Please put your **token** into the `BOT_TOKEN` variable.
```yml
services:
music-disc:
image: hmes98318/music-disc:latest
container_name: music-disc
restart: always
environment:
TZ: "Asia/Taipei"
BOT_TOKEN: "your_token"
# OAUTH2 mode requires setting BOT_ADMIN, BOT_CLIENT_SECRET value
BOT_ADMIN: ""
BOT_CLIENT_SECRET: ""
BOT_NAME: "Music Disc"
BOT_PREFIX: "+"
BOT_PLAYING: "+help | music"
BOT_EMBEDS_COLOR: "#FFFFFF"
BOT_SLASH_COMMAND: true
DEFAULT_VOLUME: 50
MAX_VOLUME: 100
AUTO_LEAVE: "true"
AUTO_LEAVE_COOLDOWN: 5000
DISPLAY_VOICE_STATE: "true"
# Web dashboard settings
ENABLE_SITE: true
SITE_PORT: 33333
SITE_LOGIN_TYPE: "USER" # "OAUTH2" | "USER"
# USER mode settings
SITE_USERNAME: "admin"
SITE_PASSWORD: "password"
# OAUTH2 mode settings
SITE_OAUTH2_LINK: "" # Your OAuth2 authentication link
SITE_OAUTH2_REDIRECT_URI: "http://localhost:33333/login" # Redirect link after OAuth2 authentication is complete
# Local Lavalink node
ENABLE_LOCAL_NODE: false
LOCAL_NODE_AUTO_RESTART: true
volumes:
- ./server:/bot/server # localnode configuration file
- ./nodelist.json:/bot/nodelist.json
- ./blacklist.json:/bot/blacklist.json
ports:
- 33333:33333
```
#### Start the container
```
docker compose up -d
```
### Start with Docker
Use the following command to start the container:
Please put your **token** into the `BOT_TOKEN` variable.
```
docker run -d \
--name music-disc \
--restart always \
-e TZ="Asia/Taipei" \
-e BOT_TOKEN="your_token" \
-e BOT_ADMIN="" \
-e BOT_CLIENT_SECRET="" \
-e BOT_NAME="Music Disc" \
-e BOT_PREFIX="+" \
-e BOT_PLAYING="+help | music" \
-e BOT_EMBEDS_COLOR="#FFFFFF" \
-e BOT_SLASH_COMMAND="#true" \
-e DEFAULT_VOLUME=50 \
-e MAX_VOLUME=100 \
-e AUTO_LEAVE="true" \
-e AUTO_LEAVE_COOLDOWN=5000 \
-e DISPLAY_VOICE_STATE="true" \
-e ENABLE_SITE=true \
-e SITE_PORT=33333 \
-e SITE_LOGIN_TYPE="USER" \
-e SITE_USERNAME="admin" \
-e SITE_PASSWORD="password" \
-e SITE_OAUTH2_LINK="" \
-e SITE_OAUTH2_REDIRECT_URI="http://localhost:33333/login" \
-e ENABLE_LOCAL_NODE=false \
-e LOCAL_NODE_AUTO_RESTART=true \
-v $(pwd)/server:/bot/server \
-v $(pwd)/nodelist.json:/bot/nodelist.json \
-v $(pwd)/blacklist.json:/bot/blacklist.json \
-p 33333:33333 \
hmes98318/music-disc:latest
```