mirror of
https://github.com/mgerb/go-discord-bot
synced 2026-01-10 09:02:49 +00:00
90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
# Discord Sound Bot
|
|
|
|
A soundboard bot for discord with a Go back end and React front end.
|
|
|
|
|
|
|
|
## How to use
|
|
|
|
* [Download latest release here](https://github.com/mgerb/go-discord-bot/releases)
|
|
* Install [youtube-dl](https://github.com/rg3/youtube-dl/blob/master/README.md#installation)
|
|
* Install [ffmpeg](https://www.ffmpeg.org/download.html)
|
|
* edit your config.json file
|
|
* run the executable
|
|
|
|
### Commands
|
|
|
|
* `clip` - clips the past minute of audio
|
|
* `summon` - summons the bot to your current channel
|
|
* `dismiss` - dismisses the bot from the server
|
|
* `<audio clip>` - play a named audio clip
|
|
|
|
### Uploading files
|
|
|
|
Discord oauth is used to authenticate users in order to upload files.
|
|
To get oauth working you must set up your bot client secret/id in the config.
|
|
You must also set up the redirect URI. This is needed so discord can redirect
|
|
back to your site after authentication. Discord doesn't like insecure redirects
|
|
so you will have to use a proxy for this. I prefer using [caddy](https://github.com/mholt/caddy)
|
|
with the following config.
|
|
|
|
```
|
|
https://localhost {
|
|
tls self_signed
|
|
proxy / http://localhost:8080 {
|
|
transparent
|
|
}
|
|
}
|
|
```
|
|
|
|
For public hosting you will want to use something like this.
|
|
|
|
```
|
|
https://<your domain name> {
|
|
tls <your email>
|
|
proxy / http://localhost:8080 {
|
|
transparent
|
|
}
|
|
}
|
|
```
|
|
|
|
### Clipping audio
|
|
|
|
If the bot is in a channel it listens to all audio. Use the `clip` command
|
|
to record the past minute of conversation. Access all clips in the "Clips"
|
|
section of the site.
|
|
|
|
### Stats
|
|
|
|
If logging is enabled the bot will log all messages and store in a database file. Currently the bot keeps track of
|
|
all messages that contain links in them. I added this because it's something we use in my discord.
|
|
Check it out in the "Stats" page on the site.
|
|
|
|
## Building from Source
|
|
|
|
### Dependencies
|
|
|
|
* Go
|
|
* node/npm
|
|
* make
|
|
|
|
### Compiling
|
|
|
|
* Make sure dependencies are installed
|
|
* install packr - `go get -u github.com/gobuffalo/packr/...`
|
|
* Rename the `config.template.json` to `config.json`
|
|
* add configurations to `config.json`
|
|
* `cd client && npm run dev`
|
|
* `go run main.go`
|
|
* open a browser `localhost:<config_port>`
|
|
|
|
[Packr](https://github.com/gobuffalo/packr) is used to bundle the static web assets into the binary.
|
|
Use these commands to compile the project. The client must be built first.
|
|
|
|
* `packr build`
|
|
* `packr install`
|
|
|
|
### Windows
|
|
|
|
I only run this on linux. I'm not sure if it will work on windows, but it should without too much work.
|