> ## Documentation Index
> Fetch the complete documentation index at: https://docs.razebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Twitch

> Get notified in Discord when a streamer goes live on Twitch.

# Twitch

> Get notified in Discord when a streamer goes live on Twitch.

## How it works

raze checks Twitch every minute using the Helix API. When a streamer you follow transitions from offline to live, an embed is posted with their stream title, game, viewer count, and a live thumbnail.

## Subscribe to a streamer

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;twitch add (#channel) (username)
  ```

  ```bash Example theme={null} theme={null}
  ;twitch add #streams xqc
    ;twitch add #live-alerts Ninja
  ```
</CodeGroup>

## Unsubscribe

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;twitch remove (#channel) (username)
  ```

  ```bash Example theme={null} theme={null}
  ;twitch remove #streams xqc
  ```
</CodeGroup>

## Custom notification message

Send a custom message alongside the embed when the streamer goes live.

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;twitch message (username) (message) [--pingable on|off]
  ```

  ```bash Example theme={null} theme={null}
  ;twitch message xqc @everyone he's live!!
    ;twitch message Ninja @Gamers Ninja is live! --pingable on
  ```
</CodeGroup>

## List feeds

```bash theme={null} theme={null}
;twitch list
```

<Note>
  Notifications only fire when a streamer goes **online** — going offline resets the state silently so the next stream triggers a fresh notification.
</Note>
