twitch2ma

twitch2ma is a Twitch chat bot that hooks into your channel and executes commands on a GrandMA 2 console using telnet.

Viewers can run user-defined commands like !red in chat to trigger whatever action on the desk. Additionally, viewers can always run !lights in chat to list all available commands.

Installation

To install twitch2ma you need to have at least node.js 14 installed. Run

npm install -g twitch2ma

Configuration

Before you can run twitch2ma you need a config file in JSON or YAML format. Sample files are located in the root directory (JSON / YAML) of the repository and ship with the npm package.

Find a detailed description of every option here.

Twitch authentication

As mentioned above, you need a clientId and an accessToken when connecting the bot to a channel. To obtain these, you will need to register an app on dev.twitch.tv. Just use any name you like for the app. OAuth Redirect URLSs don't matter either, just fill in anything. Category is Chat Bot of course. You can get your clientId from the manage page now.

After you have done that, you will need an access token. Unfortunately, this is not done by twitch2ma yet, so you have to get it manually with this neat tool. You will get an OAuth token like oauth:9ouvuuiv3mwvdd3rx5obks823jdp20dj. Remove the oauth: and that is your access token for the configuration file.

Locking commands and parameters

twitch2ma can receive sACN to temporarily lock commands. This is done by the sacn configuration options. If configured, twitch2ma listens to the respective universe/channel combination and locks configured commands and parameters when the channel value drops below 100%. This allows for a more flexible way of allowing or denying viewers' input.

When sACN is configured for a channel or parameter, it overrides timeout settings for that channel or parameter.

Additionally a lockMessage can be configured which is sent to Twitch chat when viewers try to execute a locked command/parameters.

Usage

To run twitch2ma, just run the following command. Please be aware that you need to have a desk or onPC in your network, reachable under the IP adress you configured. You also have to have telnet turned on.