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

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.

• Go 1.4 or higher
• Redis Server

Once you have completed your Go installation make sure you have these variables on your system:

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Then, get the source code and install with

go get github.com/hammerandchisel/airhornbot
cd $GOPATH/src/github.com/hammerandchisel/airhornbot
make

You will need to make a new application on the Discord API with a Redirect URI of

https://airhornbot.com/callback

Then, go into your newly created application and click the Create a Bot User button and accept the prompt.

NOTE: The variables used in this command come from your application under the APP DETAILS section.

airhornweb -r "localhost:6379" -i MY_APPLICATION_ID -s 'MY_APPLICATION_SECRET"

Once the web server is running you can visit it at http://localhost:14000 to add the bot to your desired server or to view the bot's stats.

NOTE: The variables used in this command come from your application under the APP BOT USER section. Also, you can find your owner ID by running \@YOUR_USERNAME in Discord.

After adding / permitting the bot on your Discord server you can then run the bot to process requests with

airhornbot -r "localhost:6379" -t "MY_BOT_ACCOUNT_TOKEN" -o OWNER_ID

This is what will process the commands, it must be running for the bot to respond in Discord.

NOTE: if your bot is able to join channels but no audio is being sent you may be invoking this command in the wrong directory. Make sure to be in the $GOPATH/src/github.com/hammerandchisel/airhornbot directory.

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