A lightweight Discord music bot written in go with minimal dependencies. Optimized for low CPU (not RAM) usage and responsive playback. Directly uses youtube-dl and ffmpeg for downloading media.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
r4 2e7dd71bad fix ID out of bounds detection; less unnecessary code 4 months ago
dca0 add code 4 months ago
util add code 4 months ago
ytdl gofmt 4 months ago
LICENSE Initial commit 4 months ago
README.md Update readme 4 months ago
TODO.md Fix formatting. 4 months ago
args.go add code 4 months ago
commands.go fix ID out of bounds detection; less unnecessary code 4 months ago
config.go add code 4 months ago
go.mod add code 4 months ago
go.sum add code 4 months ago
main.go fix ID out of bounds detection; less unnecessary code 4 months ago

README.md

go-musicbot

A lightweight Discord music bot written in go with minimal dependencies.

Optimized for low CPU (not RAM) usage and responsive playback.

Directly uses youtube-dl and ffmpeg for downloading media.

Building from source

  • Make sure to have Go (Golang) installed.

  • Clone the repo: git clone 'https://git.nobrain.org/r4/go-musicbot.git' && cd go-musicbot.

  • Let Go install all library dependencies: go mod tidy.

  • Build the program: go build.

Running the binary

  • Run the binary once to generate config.json: ./dcbot.

  • Make sure to have ffmpeg installed (basically every Linux/BSD distro should have a package for it).

  • Make sure to have a RECENT version of youtube-dl. If your distro doesn't package a recent version, see the section titled "Obtaining a recent youtube-dl binary".

  • In config.json, find the line that says "token". In that line, change the text that says "insert your discord bot token here" to whatever your bot token is (just look it up if you don't know how to get one). Remember to keep the "" sorrounding the token.

Notes

  • youtube-dl might cause some problems with certain Unicode characters if the locale isn't configured correctly (messages like "Adding 0 tracks to queue." may arise). Quick fix: sudo sh -c "echo 'LC_ALL=\"en_US.UTF-8\"' >> /etc/environment".

Setup

Obtaining a recent youtube-dl binary

Some distributions like Debian don't ship a very recent version of youtube-dl, but there is a simple solution for running this bot nonetheless.

  • Locally download the latest youtube-dl version into the cloned repo: wget https://yt-dl.org/downloads/latest/youtube-dl.

  • Make youtube-dl executable chmod +x ./youtube-dl.

  • In config.json, look for the line that says "youtube-dl_path". In that line, change the value that says "youtube-dl" to "./youtube-dl".

  • Save and you're done. The bot should now look for youtube-dl locally instead of system-wide.