SinusBot

SinusBot is a music bot for TeamSpeak and Discord that you run on your own server. The SinusBot integration connects Macro Deck to the SinusBot web interface, so you can control what a bot instance plays and see the current track on your deck. It works with any SinusBot that Macro Deck can reach over the network, on the same computer, in your local network or on a server.

What you can do

• Play, pause, toggle, skip to the next or previous track and jump to a position in the current track.
• Set the volume, raise or lower it, turn shuffle on or off and turn repeat on or off.
• Play a specific track from the bot's library with Play Track. Leave the track empty to choose one when you press the button.
• Show the playing track, artist and cover in Macro Deck's Music Player widget, and use the bot's track, position and volume in labels through variables.

Some example setups:

• A row of buttons with Previous Track, Toggle Play/Pause and Next Track for the bot in your TeamSpeak channel. The play button shows whether the bot is playing.
• A slider bound to the bot's volume variable, sinusbot_<instance>_volume, so you can turn the music down while you talk.
• A Music Player widget for each bot, next to buttons whose color follows the cover through the music_player_<player>_album_color variable.

Multiple bots and how it behaves

Each SinusBot instance you want to control is one configuration. You can add as many as you like, also instances on different servers, and pick the instance in the Player field of each action. When you leave Player empty, the action controls the first one. Each configuration gets its own set of variables, named after the configuration name, such as sinusbot_<instance>_volume.

Macro Deck checks the connection when you set up a configuration and loads the instances the bot has. While it runs, it reads the playback state regularly. When the bot cannot be reached for a short moment, the deck keeps showing the last track; when it stays unreachable, the sinusbot_<instance>_is_connected variable reads false and actions do nothing until the bot answers again.