The twitch platform will allow you to monitor Twitch channel status from within Home Assistant and setup automation based on the information.

Setup Client ID and Client secret

Create a new app at “Register Your Application” in the Twitch developer portal. Then get the Client ID and Client secret for the new application.

Setup OAuth Token

To enable the follow and subscription attributes, the OAuth token is needed to get the right permissions on the Twitch API. If you don’t need those, ignore the configuration setting: token.

To get the OAuth token, visit the OAuth Token Generator, insert your Client ID and user:read:subscriptions inside scopes.

Before clicking Summit (the broken image below the form), visit the Twitch dev console and add a new application.

As OAuth Redirect URLs add and click Create . Back at the Token Generator, click the Connect button, accept the consent screen and get your OAuth Token.


To use Twitch with your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  platform: twitch
    - channel1
    - channel2

Configuration Variables

client_id string Required

Your Twitch client ID.

client_secret string Required

Your Twitch client secret.

token string (Optional)

Your Twitch OAuth Token.

channels list Required

List of channels names