Docs

Everything you need to set up ShadowCat in your Discord server.

Adding the bot

Click the button below to invite ShadowCat to your Discord server. You'll need the Manage Server permission on the server you're adding it to.

Add to Discord

Permissions

ShadowCat requests the following permissions when added to your server:

  • View Channels - to see the channels it can post in
  • Send Messages and Create Posts - to post go-live notifications
  • Embed Links - to include stream previews and links
  • Mention @everyone, @here and All Roles - for optional alerts
  • Use Application Commands - for slash commands

Make sure the bot's role has access to the channel you want it to post in. You can check permissions under Server Settings > Roles > ShadowCat > Permissions.

Private and announcement channels

For private or announcement channels, server-wide permissions aren't enough. You'll need to add the ShadowCat app to the channel and grant it the following permissions:

  • View Channel - to see the channel
  • Send Messages - to post go-live notifications
  • Embed Links - to include stream previews and links

To set this up:

  1. Open the channel settings > Permissions.
  2. Click Add members or roles, switch to the Members tab, and select ShadowCat (the entry with the APP badge).
  3. Scroll down to Advanced permissions, select ShadowCat from the roles/members list on the left.
  4. Enable View Channel, Send Messages, and Embed Links.

If you see a "Permissions not synced with category" warning at the top, leave it as-is. Syncing would overwrite the per-channel permissions you just added.

Commands

ShadowCat uses Discord slash commands. Type / in any channel to see available commands:

/add [platform] [channel]

Start listening for channel go live events. Pick the platform (Twitch, YouTube, Kick) and enter the channel name.

/add twitch ninja

/remove [platform] [channel]

Stop listening for channel go live events.

/list

List all shadowed channels in this server.

/pause

Temporarily stop channel notifications.

/resume

Resume channel notifications after a pause.

/test

Send a test event to verify the bot is working and has permission to post in the current channel.

/upgrade

Upgrade to track channels across more servers.

Setting up an announcement channel

If you want go-live notifications to appear in a Discord announcement channel (so other servers can follow them), here's how:

  1. Create an announcement channel in your Discord server (or use an existing one)
  2. Make sure ShadowCat's role has permission to send messages and manage messages in that channel
  3. Run your /subscribe commands in that channel
  4. ShadowCat will post there and the messages can be published to followers

Need help?

Email [email protected].