dolandrew / helping-friendly-book

Automated Twitter Bot for Phish song & show stats

Helping Friendly Book

www.twitter.com/PhishCompanion

The Helping Friendly Book is a Java Spring Boot application deployed to Heroku that runs the Helping Friendly Bot (@PhishCompanion) account on Twitter. It does 4 main things:

1. Listens to another Twitter account, @Phish_FTR, which tweets the song name as soon as Phish plays it live. When it finds a song name, it goes to phish.net to look up additional stats about the song and tweets that.

2. Posts a “Show On This Day” once per day at 11AM PT. This tweet is threaded and includes the date, location, setlist and setlist notes of the random selected show on this day.

3. Posts set start times.

4. Posts a #Pick5 on show days -- HFB uses an algorithm to find five songs that are likely to be played and tweets them out before the show starts.

All data is pulled from phish.net.

Helping Friendly Book has some other features that leverage the Twitter API:

• Favoriting a tweet (this is used to like @Phish_FTR’s tweets)
• Following users that like another users tweet
• Unfollowing users that don’t follow back
• Threaded tweets (tweets with replies)

To build and run with Gradle:

./gradlew build
./gradlew bootRun

To build and run with Docker:

docker build . -t helpingfriendlybook
docker run helpingfriendlybook