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.
This repository has been archived on 2022-09-20. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
r4 34b9b4f630 Update 'README.md' 2022-09-20 01:23:43 +02:00
dca0 add code 2021-07-28 17:30:01 +02:00
util add code 2021-07-28 17:30:01 +02:00
ytdl gofmt 2021-07-28 18:05:06 +02:00
LICENSE Initial commit 2021-07-28 17:26:21 +02:00
README.md Update 'README.md' 2022-09-20 01:23:43 +02:00
TODO.md Fix formatting. 2021-07-28 17:37:21 +02:00
args.go add code 2021-07-28 17:30:01 +02:00
commands.go fix ID out of bounds detection; less unnecessary code 2021-07-28 19:32:28 +02:00
config.go add code 2021-07-28 17:30:01 +02:00
go.mod add code 2021-07-28 17:30:01 +02:00
go.sum add code 2021-07-28 17:30:01 +02:00
main.go fix ID out of bounds detection; less unnecessary code 2021-07-28 19:32:28 +02:00

README.md

!!! Repo archived since I have rewritten the bot: https://github.com/xypwn/dischord !!!


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.