nugget/cowgod repository overview

⁠cowgod Turntable.fm bot

Nugget's Turntable.fm alter-ego. This bot has existed in one form or another for both Turntable.fm as well as Plug.DJ. Originally written in Node/JS it has now been ported to Go. This bot was created for all the shameless DJs who hang out in the Follow the Leader Shamelessly⁠ room on Turntable.fm⁠.

⁠DJ Bot Commands

• /jump up Jump up to a DJ spot if available
• /jump down Go back to the pit
• /bop Vote up the current song
• /lame Vote down the current song
• /skip Skip the currently playing song
• /snag Adds the current playing song to the bottom of the current playlist
• /random <n> Randomize the top n items in the current playlist
• /search <searchspec> Search for a song and add the first hit to the top of the current playlist.

⁠Admin Bot Commands

• /loglevel <level> Adjust the logging level on the console
• /available Set the bot to available status
• /unavailable Set the bot to unavailable status
• /away Set the bot to away status
• /version Report the bot's version and build information

⁠Using

You can build and run this bot locally if you have golang installed. Alternatively, you can run it via the Docker image⁠:

docker run nugget/cowgod:latest

The bot expects to pull its needed configuration from environment variables. For the TTAPI items, you can use the Auth Capture Bookmarklet⁠ to find out what the three values need to be.

• TTAPI_AUTH : Your bot's turntable.fm authentication token
• TTAPI_USER_ID Your bot's user ID
• TTAPI_ROOM_ID Your default room ID
• COWGOD_LOGLEVEL The initial loglevel (trace, debug, info, warn, error)

⁠Useful Links

• ttapi⁠ : New Golang API
• Turntable-API⁠ : Original Node/Javascript API