Airhorn Bot

Airhorn is an example implementation of the Discord API. Airhorn bot utilizes the discordgo library, a free and open source library. Original credit of Airhorn Bot goes to these guys Airhorn Bot requires Go 1.4 or higher.

Prereqs

You need a few things from your discord client before you begin. You need to login to the discord app in the browser and enable developer mode under Appearance to enable the features you need to interact with the Discord API.

OWNER_ID (Right click yourself in a channel and "Copy ID")

You can obtain these other ones by creating an application and bot user in the "My Apps" area in the developer area

Under App Details (These are for the webserver optional)

MY_APPLICATION_ID
MY_APPLICATION_SECRET

You will need to Create a Bot User to obtain this token

MY_BOT_ACCOUNT_TOKEN

Once you set this up, you'll need to navigate to this URL to add the bot to your discord. However, it won't do anything just yet until you make the bot software and have it listening to the bot user token you created. Make sure you replace <<MY_APPLICATION_ID>> in the URL.

https://discordapp.com/api/oauth2/authorize?client_id=<<MY_APPLICATION_ID>>&scope=bot&permissions=1

Server Requirements

NPM (npm and gulp)
go
discordgo
redis
Firewall ChangeLinuxConfig.org

Install npm and gulp

sudo apt install npm

npm install gulp

Install GO and DiscordGO

#Optional this is in script in the running bot section later in this
wget https://dl.google.com/go/go1.10.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.10.2.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
go get github.com/bwmarrin/discordgo

Update Local Paths Add paths in your shell config file (.bashrc, .zsh, etc)

#Add this to the bottom of your shell config
#Adding GO PATH
export GOPATH=$HOME/go
export PATH=$PATH:/usr/local/go/bin

Installing Redis

Installing Redis from Redis.io

wget http://download.redis.io/redis-stable.tar.gz
tar xvzf redis-stable.tar.gz
cd redis-stable
make

##You need to install tcl before you run your `make test`
sudo apt-get install tcl

Next Test Redis

## Next run a test
make test

## At the end you should see something like "\o/ All tests passed without errors!"

## Get redis ready for prime time (make sure you're still in ~/redis-stable directory)
sudo make install

##Manually Start Redis
redis-server

##Daemonize Redis to run server in the background
redis-server --daemonize yes

Setting up redis to start on boot

cd ~/redis-stable
sudo cp utils/redis_init_script /etc/init.d/redis_6379
sudo vim /etc/init.d/redis_6379
#
#  - Check to make sure Port 6379 is specified
#
sudo cp redis.conf /etc/redis/6379.conf
sudo mkdir /var/redis/6379
sudo vim /etc/redis/6379.conf
#
#  - demonize = yes
#  - pdfile = /var/run/redis_6379.pid
#  - loglevel = notify
#  - logfile = /var/log/redis_6379.log
#  - dir = /var/redis/6379
#
sudo update-rc.d redis_6379 defaults
sudo /etc/init.d/redis_6379 start

redis-cli ping
#  - You should receive "PONG" as a reply if all went well, if it doesn't reply, refer to next line
tail /var/log/redis_6379.log
#  - This will show you the last few lines of the log file to see if there are any issues, you could also use 'cat' or go into a vim editor to look at the entire file.

Firewall Change from LinuxConfig.org

sudo ufw allow from any to any port 6379 proto tcp

Usage

Airhorn Bot has two components, a bot client that handles the playing of loyal airhorns, and a web server that implements OAuth2 and stats. Once added to your server, airhorn bot can be summoned by running !airhorn.

Running the Bot

BETA You can try to use the startup script located in the /cmd/bot/ folder and just modify your tokens in the script. Then easy method for auto start on boot is with crontab.

#Open Crontab file (I use vim, you can choose your own flavor of text editor)
$ crontab -e
#Add this line below all the commented text
@reboot sh $HOME/go/src/github.com/EGartin/airhornbot/cmd/bot/startairhorn.sh

First install the bot:

go get github.com/EGartin/airhornbot/cmd/bot
go install github.com/EGartin/airhornbot/cmd/bot

Then run the following command:

You may have to run it in the source folder if you run into can not find audio files: **

cd go/src/github.com/EGartin/airhornbot/
go run cmd/bot/bot.go -r "localhost:6379" -t "MY_BOT_ACCOUNT_TOKEN" -o OWNER_ID

Running the Web Server

First install the webserver:

go get github.com/EGartin/airhornbot/cmd/webserver
go install github.com/EGartin/airhornbot/cmd/webserver

Next run make static on the repo in your ~/go/src/github.com/EGartin/airhornbot repo

cd go/src/github.com/EGartin/airhornbot
make static

Run Webserver still a work in progress

go run cmd/webserver/web.go -r -r "localhost:6379" -i MY_APPLICATION_ID -s "MY_APPLICATION_SECRET"

Note, the webserver requires a redis instance to track statistics

DevOps Automation

Coming Soon. Feel free to follow along with the new Issue tracker and Github Project on this Repo

Thanks

Thanks to the awesome (one might describe them as smart... loyal... appreciative...) iopred and bwmarrin for helping code review the initial release.

ElijahGartin/airhornbot