VodOnDemand.TwitchEverywhere.Core 0.4.0

TwitchEverywhere

• How To Use It
• Sample CLI App
• Performance
• Supported Functionality
  • IRC Commands
    • CLEARCHAT
    • CLEARMSG
    • GLOBALUSERSTATE
    • HOSTTARGET
    • NOTICE
    • RECONNECT
    • ROOMSTATE
    • USERNOTICE
    • USERSTATE
    • WHISPER
  • IRC Membership
    • JOIN
    • PART
  • IRC Tags
    • PRIVMSG Tags
    • CLEARCHAT Tags
    • CLEARMSG Tags
    • GLOBALUSERSTATE Tags
    • NOTICE Tags
    • ROOMSTATE Tags
    • USERNOTICE Tags
    • USERSTATE Tags
    • WHISPER Tags

TwitchEverywhere is a .NET library that allows connecting to a Twitch chat and subscribing to messages in that chat.

The goal of this library is to provide a lightweight, strongly typed API for clients so they can avoid parsing raw strings as much as possible. Additionally, Twitch requires an authenticated connection to the IRC server which can get a bit complicated to setup and maintain. Fortunately TwitchEverywhere can do that for you! 😀

The library will support the latest LTS version of .NET and non LTS versions IF it is newer than the LTS version. So for example before .NET 8, the library supported .NET 6 (LTS) and 7 but once .NET 8 was released support for 6 and 7 was dropped.

How To Use It

You will need to provide the following values as parameters to the TwitchConnectionOptions record:

TwitchConnectionOptions options = new(
    Channel: channel,
    AccessToken: accessToken,
    RefreshToken: refreshToken,
    ClientId: clientId,
    ClientSecret: clientSecret,
    ClientName: clientName
);

Next define a MessageCallback method that will handle any messages that TwitchEverywhere sends to your application. The input will be of type TwitchEverywhere.Types.Message and return type void.

// This example only handles MessageType.PrivMsg but you should handle other types here too
private void MessageCallback( Message message ) {
    switch( message.MessageType ) {
        case MessageType.PrivMsg: {
            PrivMsg privMsg = (PrivMsg) message;
            PrivMessageCallback( privMsg );
            break;
        }
        default:
            // This is just an example, you can handle this case however you wish
            throw new ArgumentOutOfRangeException();
    }
}

Then initialize TwitchEverywhere and pass in the options to the constructor. Finally call the TwitchEverywhere.ConnectToChannel method and pass in your callback as a parameter.

TwitchEverywhere.TwitchEverywhere twitchEverywhere = new( options );
await twitchEverywhere.ConnectToChannel( MessageCallback );

Now whenever TwitchEverywhere receives a message it will pass it to your callback! 🎉

Sample CLI App

There is a sample CLI application that is included as an example in this repo and you can use it to connect with Twitch – give it a try!

In order to connect you need to create an appsettings.json file in the root of the TwitchEverywhereCLI project with the following parameters:

{
  "AccessToken": "your_twitch_access_token",
  "RefreshToken": "your_twitch_refresh_token",
  "ClientId": "your_client_id",
  "ClientSecret": "your_client_secret",
  "ClientName": "your_client_name_all_lowercase",
  "Channel": "channel_you_want_to_connect_to"
}

Performance

See the README in the TwitchEverywhere.Benchmark project here

Supported Functionality

IRC Commands

See the related Twitch documentation here

CLEARCHAT

See CLEARCHAT tags

CLEARMSG

See CLEARMSG tags

GLOBALUSERSTATE

See GLOBALUSERSTATE tags

HOSTTARGET

NOTICE

See NOTICE tags

RECONNECT

No fields for RECONNECT, use the presence of this message as a signal to reconnect to Twitch. See the Twitch API docs for more infomation.

ROOMSTATE

See ROOMSTATE tags

USERNOTICE

See USERNOTICE tags

USERSTATE

See USERSTATE tags

WHISPER

See WHISPER tags

IRC Membership

See the related Twitch documentation here.

JOIN

PART

IRC Tags

See the related Twitch documentation here.

PRIVMSG Tags

CLEARCHAT Tags

CLEARMSG Tags

GLOBALUSERSTATE Tags

NOTICE Tags

ROOMSTATE Tags

USERNOTICE Tags

USERSTATE Tags

WHISPER Tags