TwitchLib.EventSub.Websockets 0.7.0-preview.80.7583c0f

This is a prerelease version of TwitchLib.EventSub.Websockets.
There is a newer version of this package available.
See the version list below for details.
dotnet add package TwitchLib.EventSub.Websockets --version 0.7.0-preview.80.7583c0f
                    
NuGet\Install-Package TwitchLib.EventSub.Websockets -Version 0.7.0-preview.80.7583c0f
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TwitchLib.EventSub.Websockets" Version="0.7.0-preview.80.7583c0f" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="TwitchLib.EventSub.Websockets" Version="0.7.0-preview.80.7583c0f" />
                    
Directory.Packages.props
<PackageReference Include="TwitchLib.EventSub.Websockets" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add TwitchLib.EventSub.Websockets --version 0.7.0-preview.80.7583c0f
                    
#r "nuget: TwitchLib.EventSub.Websockets, 0.7.0-preview.80.7583c0f"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package TwitchLib.EventSub.Websockets@0.7.0-preview.80.7583c0f
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=TwitchLib.EventSub.Websockets&version=0.7.0-preview.80.7583c0f&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=TwitchLib.EventSub.Websockets&version=0.7.0-preview.80.7583c0f&prerelease
                    
Install as a Cake Tool

TwitchLib.EventSub.Websockets

TwitchLib component to connect to Twitch's EventSub service via Websockets also known as EventSockets

Disclaimer

EventSub via Websockets is still in open beta. You can use it in production but Twitch may introduce breaking changes without prior notice. The same goes for this implementation until it reaches Version 1.0.0

Resources

If you need help on how to setup Dependency Injection in your Console or WPF Application you can have a look at these guides:

You can also find a console app example for .NET 8 and for .NET Framework 4.8 in the repo.

Installation

NuGet TwitchLib.EventSub.Websockets
Package Manager PM> Install-Package TwitchLib.EventSub.Websockets -Version 0.6.0
.NET CLI > dotnet add package TwitchLib.EventSub.Websockets --version 0.6.0
PackageReference <PackageReference Include="TwitchLib.EventSub.Websockets" Version="0.6.0" />
Paket CLI > paket add TwitchLib.EventSub.Websockets --version 0.6.0

Breaking Changes in Version 0.7

  • removed INotificationHandler interface
  • Removed deprecated versions of .NET.
  • All EventSub events were moved to TwitchLib.EventSub.Core Nuget Package, for better management across future EventSub transport Client libraries. That means their namespace changed from TwitchLib.EventSub.Websockets.Core.EventArgs.* to TwitchLib.EventSub.Core.EventArgs.*.
  • Like Events, all EventSub Models were moved to the TwitchLib.EventSub.Core package, (namespace changed from TwitchLib.EventSub.Websockets.Core.Models to TwitchLib.EventSub.Core.Models) but to ensure that the models can be used across projects some changes had to be made:
    • Properties from EventSubNotification<T> were moved to TwitchLibEventSubEventArgs<T>.
    • Property Notification was removed from TwitchLibEventSubEventArgs<T>.
    • Class EventSubMetadata was renamed to WebsocketEventSubMetadata.
  • WebsocketDisconnected and WebsocketReconnected now contain more specific EventArgs.

Setup

Step 1: Create a new project (Console, WPF, ASP.NET)

Step 2: Install the TwitchLib.EventSub.Websockets nuget package. (See above on how to do that)

Step 3: Step 3: Add necessary services and config to the DI Container

services.AddTwitchLibEventSubWebsockets();
services.AddHostedService<WebsocketHostedService>();

(The location of where to put this and the naming of variables might differ depending on what kind of project and general setup you have)

Step 4: Create the HostedService we just added to the DI container and connect to EventSub and listen to Events

using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using TwitchLib.Api;
using TwitchLib.Api.Core.Enums;
using TwitchLib.EventSub.Websockets.Core.EventArgs;
using TwitchLib.EventSub.Websockets.Core.EventArgs.Channel;

namespace TwitchLib.EventSub.Websockets.Test
{
    public class WebsocketHostedService : IHostedService
    {
        private readonly ILogger<WebsocketHostedService> _logger;
        private readonly EventSubWebsocketClient _eventSubWebsocketClient;
        private readonly TwitchApi _twitchApi = new();
        private string _userId;
        
        public WebsocketHostedService(ILogger<WebsocketHostedService> logger, EventSubWebsocketClient eventSubWebsocketClient)
        {
            _logger = logger ?? throw new ArgumentNullException(nameof(logger));

            _eventSubWebsocketClient = eventSubWebsocketClient ?? throw new ArgumentNullException(nameof(eventSubWebsocketClient));
            _eventSubWebsocketClient.WebsocketConnected += OnWebsocketConnected;
            _eventSubWebsocketClient.WebsocketDisconnected += OnWebsocketDisconnected;
            _eventSubWebsocketClient.WebsocketReconnected += OnWebsocketReconnected;
            _eventSubWebsocketClient.ErrorOccurred += OnErrorOccurred;

            _eventSubWebsocketClient.ChannelFollow += OnChannelFollow; 
            // Get ClientId and ClientSecret by register an Application here: https://dev.twitch.tv/console/apps
            // https://dev.twitch.tv/docs/authentication/register-app/
            _twitchApi.Settings.ClientId = "YOUR_APP_CLIENT_ID";
            // Get Application Token with Client credentials grant flow.
            // https://dev.twitch.tv/docs/authentication/getting-tokens-oauth/#client-credentials-grant-flow
            _twitchApi.Settings.AccessToken = "YOUR_APPLICATION_ACCESS_TOKEN";

            // You need the UserID for the User/Channel you want to get Events from.
            // You can use await _api.Helix.Users.GetUsersAsync() for that.
            _userId = "USER_ID";
        }

        public async Task StartAsync(CancellationToken cancellationToken)
        {
            await _eventSubWebsocketClient.ConnectAsync();
        }

        public async Task StopAsync(CancellationToken cancellationToken)
        {
            await _eventSubWebsocketClient.DisconnectAsync();
        }

        private async Task OnWebsocketConnected(object sender, WebsocketConnectedArgs e)
        {
            _logger.LogInformation($"Websocket {_eventSubWebsocketClient.SessionId} connected!");

            if (!e.IsRequestedReconnect)
            {
                // subscribe to topics
                // create condition Dictionary
                // You need BOTH broadcaster and moderator values or EventSub returns an Error!
                var condition = new Dictionary<string, string> { { "broadcaster_user_id", _userId }, {"moderator_user_id", _userId} };
                // Create and send EventSubscription
                await _twitchApi.Helix.EventSub.CreateEventSubSubscriptionAsync("channel.follow", "2", condition, EventSubTransportMethod.Websocket,
                _eventSubWebsocketClient.SessionId, accessToken: "BROADCASTER_ACCESS_TOKEN_WITH_SCOPES");
                // If you want to get Events for special Events you need to additionally add the AccessToken of the ChannelOwner to the request.
                // https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/
            }
        }

        private async Task OnWebsocketDisconnected(object sender, WebsocketDisconnectedArgs e)
        {
            _logger.LogError($"Websocket {_eventSubWebsocketClient.SessionId} disconnected!");

            // Don't do this in production. You should implement a better reconnect strategy with exponential backoff
            while (!await _eventSubWebsocketClient.ReconnectAsync())
            {
                _logger.LogError("Websocket reconnect failed!");
                await Task.Delay(1000);
            }
        }

        private async Task OnWebsocketReconnected(object sender, WebsocketReconnectedArgs e)
        {
            _logger.LogWarning($"Websocket {_eventSubWebsocketClient.SessionId} reconnected");
        }

        private async Task OnErrorOccurred(object sender, ErrorOccuredArgs e)
        {
            _logger.LogError($"Websocket {_eventSubWebsocketClient.SessionId} - Error occurred!");
        }

        private async Task OnChannelFollow(object sender, ChannelFollowArgs e)
        {
            var eventData = e.Notification.Payload.Event;
            _logger.LogInformation($"{eventData.UserName} followed {eventData.BroadcasterUserName} at {eventData.FollowedAt}");
        }
    }
}

Alternatively you can also just clone the examples:

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on TwitchLib.EventSub.Websockets:

Package Downloads
TwitchLib

Twitch C# library for accessing Twitch chat and whispers with events, Twitch API wrapper with every available API endpoint, PubSub wrapper and an Eventsub Websocket implementation

Strem.Twitch

Package Description

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on TwitchLib.EventSub.Websockets:

Repository Stars
baffler/Transparent-Twitch-Chat-Overlay
Twitch chat on top of windowed games for single monitor streamers
songify-rocks/Songify
A simple tool that gets the current track from Spotify, YouTube and Nightbot.
Version Downloads Last Updated
0.7.0 227 9/19/2025
0.7.0-preview.80.7583c0f 121 9/10/2025
0.7.0-preview.79.47f9402 155 8/24/2025
0.7.0-preview.78.d5d3fa8 74 8/16/2025
0.7.0-preview.77.43b8abc 53 8/15/2025
0.7.0-preview.76.e0eb3c4 472 7/24/2025
0.7.0-preview.75.9626728 468 7/24/2025
0.7.0-preview.74.00871ba 460 7/24/2025
0.7.0-preview.73.af00daa 130 7/16/2025
0.7.0-preview.72.d91d48d 117 7/14/2025
0.7.0-preview.71.3864955 135 7/6/2025
0.7.0-preview.70.cd91499 168 6/18/2025
0.6.0 1,795 6/7/2025
0.6.0-preview-f14064f 185 5/20/2025
0.6.0-preview-dbc970c 2,726 11/6/2024
0.6.0-preview-cde682a 132 11/5/2024
0.6.0-preview-9e27637 165 5/22/2025
0.6.0-preview-8dbcfb5 259 5/14/2025
0.6.0-preview-6f4cd77 320 11/16/2024
0.6.0-preview-62.534d542 108 5/30/2025
0.6.0-preview-532b5cd 252 5/14/2025
0.6.0-preview-3c5fac1 256 5/14/2025
0.6.0-preview-129f195 109 11/5/2024
0.6.0-preview.67.4401bf1 63 6/7/2025
0.6.0-preview.66.3e5313f 63 5/31/2025
0.5.0 5,629 4/11/2024
0.5.0-preview-ffc3181 313 7/31/2024
0.5.0-preview-ff1356d 162 6/12/2024
0.5.0-preview-fed1002 136 4/22/2024
0.5.0-preview-ef96f7f 125 4/11/2024
0.5.0-preview-d22efe0 150 4/11/2024
0.5.0-preview-cf9adcd 133 4/11/2024
0.5.0-preview-bcfc70a 147 5/20/2024
0.5.0-preview-bcc5801 152 6/17/2024
0.5.0-preview-abba5e7 191 6/25/2024
0.5.0-preview-a6ae325 304 10/30/2023
0.5.0-preview-72088d1 268 6/1/2023
0.5.0-preview-50e75fa 213 6/1/2023
0.5.0-preview-38d6070 196 6/1/2023
0.5.0-preview-10a6910 148 6/17/2024
0.4.0 2,510 5/9/2023
0.4.0-preview-7595d8b 192 5/9/2023
0.3.0 938 2/12/2023
0.3.0-preview-f4eee33 195 4/13/2023
0.3.0-preview-4523dce 210 5/9/2023
0.3.0-preview-34c0d87 233 2/11/2023
0.3.0-preview-13e1cef 220 2/11/2023
0.2.0 586 11/20/2022
0.2.0-preview-e561e8e 219 11/20/2022
0.2.0-preview-24aeaba 240 11/20/2022
0.1.0 438 11/8/2022
0.1.0-preview-ce4fc65 236 11/8/2022
0.1.0-preview-a65fad9 230 11/8/2022
0.1.0-preview-29bcaac 224 11/8/2022
0.1.0-preview-17203fa 225 11/8/2022
0.0.3 68,931 11/3/2022
0.0.3-preview-5d9eb3d 215 11/3/2022
0.0.2 493 11/1/2022
0.0.2-preview-d1dbff3 226 11/3/2022
0.0.2-preview-66f945c 234 11/1/2022
0.0.2-preview-1038807 232 11/3/2022