https://github.com/mgerb/mgdiscord
The discord bot that plays everything
https://github.com/mgerb/mgdiscord
Last synced: over 1 year ago
JSON representation
The discord bot that plays everything
- Host: GitHub
- URL: https://github.com/mgerb/mgdiscord
- Owner: mgerb
- Created: 2019-08-04T17:52:39.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-24T03:04:26.000Z (over 3 years ago)
- Last Synced: 2025-05-07T21:11:27.425Z (over 1 year ago)
- Language: Go
- Homepage: https://cloud.docker.com/repository/docker/mgerb/mgdiscord
- Size: 28.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# MGDiscord
https://cloud.docker.com/repository/docker/mgerb/mgdiscord
The discord bot that plays everything. This bot is similar to other music bots, but it uses yt-dlp.
## Features
- queue up audio from a wide variety of sites
- start audio track from specific timestamp (see Commands)
- support for timestamp in Youtube URL
- skip/pause/resume tracks
- set volume
## Commands
- play \ \ | \ - add a valid URL or youtube search to the play queue
- timestamp - start an audio track at a specific timestamp
- e.g. !play https://www.youtube.com/watch?v=oHg5SJYRHA0 1m13s
- NOTE: a Youtube URL with timestamp in the query string will start playing at that time
- skip - skip to the next in queue
- pause - pause current playing track
- resume - resume playing current track
- volume \<1 - 100\> - set the volume 1 through 100
## Run with Docker Compose
I highly suggest running this with Docker as I am not currently compiling binaries.
This bot depends on yt-dlp, which must be provided by the host. This was previously
provided by the container, but yt-dlp needs to be updated too much for this now.
```
version: "3"
services:
mgdiscord:
image: mgerb/mgdiscord:latest
volumes:
- /usr/local/bin/yt-dlp:/usr/local/bin/yt-dlp:ro
env_file:
- .env
environment:
- BOT_PREFIX=${BOT_PREFIX}
- TOKEN=${TOKEN}
- TIMEOUT=${TIMEOUT}
```
### Config
- BOT_PREFIX - the prefix to your bot commands e.g. "!play rick roll"
- TOKEN - [How to get your bot token](https://github.com/reactiflux/discord-irc/wiki/Creating-a-discord-bot-&-getting-a-token)
- TIMEOUT - how many seconds before the bot times out downloading a media file