Documentation

SquadBot Guide

Everything you need to install SquadBot, set up permissions, and use every available command on your Discord server.

🚀 Installation

Adding SquadBot to your server takes less than a minute. Follow these steps:

1
Invite the bot
Click the "Add to Discord" button at the top of the page, or use the official invite link directly. You'll be redirected to the Discord authorisation portal.
2
Choose your server
In the dropdown menu, select the Discord server where you want to install SquadBot. You must have the Manage Server permission or be an administrator to add it.
3
Accept permissions
Discord will show you the list of permissions requested by SquadBot. Accept them all for optimal operation. These permissions are detailed in the Permissions section below.
4
Start the setup
Once the bot is on your server, type /setup in any text channel to launch the guided setup assistant.
💡 SquadBot is completely free and requires no registration or third-party account. It integrates directly with the Twitch API to detect your members' live streams.

🔐 Required permissions

SquadBot requests the following permissions during installation. Here is why each one is needed:

👁️ View Channels
Allows the bot to read the list of available channels during setup with /setup. Required
✉️ Send Messages
Essential for posting live notifications in the configured channel. Required
🖼️ Embed Links
Allows displaying rich embeds: stream thumbnail, current game, Twitch link. Required
👥 View Server Members
Required to read members with the streamer role in order to identify and monitor their Twitch accounts. Required
🏷️ Mention Roles
Allows mentioning the configured "members" role when a live notification is sent. Required
🗑️ Manage Messages
Used to automatically delete or edit the notification when a live stream ends (based on the configured behaviour). Required
📎 Attach Files
May be useful for displaying thumbnails in certain channel contexts. Optional
⚠️ If SquadBot is unable to send messages in the configured channel, make sure these permissions are granted at the channel level as well, not just at the server level.

⚙️ Initial configuration

After adding SquadBot, run the /setup command to start the assistant. It will guide you through five interactive steps:

1 Language Choose between English and French for the bot's responses.
2 Notification channel Select the text channel where live announcements will be posted.
3 Streamers role Designate the role assigned to members whose streams should be monitored.
4 Role to mention Choose the role that will be mentioned in each notification.
5 End-of-stream behaviour Delete the notification or replace it with a VOD link.
ℹ️ Important: SquadBot identifies streamers by matching their Discord display name with a Twitch login. If a member's Discord name differs from their Twitch login, use the /set_streamer command to link the two accounts manually.

⌨️ Command reference

All SquadBot commands are slash commands (prefixed with /). Commands marked Admin require the Administrator permission on the server.

Server configuration

Launches the interactive multi-step setup assistant. Lets you define the notification channel, the streamers role to monitor, the role to mention (or no ping), and the end-of-stream behaviour.

At the end of the setup, SquadBot automatically subscribes all members with the streamer role (by resolving their Discord name to a Twitch login) and checks whether any of them are already live.

This command can be re-run at any time to update your server's configuration.

Shows a summary of the server's current configuration: notification channel, streamers role, role to mention, and bot language. The response is only visible to the administrator (ephemeral).

Changes the bot's behaviour when a streamer ends their live. Two options are available:

delete 🗑️ Delete the notification message as soon as the stream ends.
vod 📼 Replace the notification with a link to the Twitch VOD (if available).
Parameter
behavior The desired behaviour. Choose between delete or vod.
Streamer management

Subscribes a Discord member to live notifications. SquadBot automatically resolves the member's Discord display name into the matching Twitch login.

Without a parameter, the command applies to the user running it. An administrator can subscribe any other member by specifying the member parameter.

Parameter
member optional The Discord member to subscribe. Admin only. Leave empty to subscribe yourself.
⚠️ Automatic Twitch login resolution relies on the member's server display name. If that name does not exactly match their Twitch login, use /set_streamer to link the accounts manually.

Removes a streamer from live notifications. Without a parameter, unsubscribes the user themselves. Administrators can unsubscribe any member via member, or an external streamer via login.

Note: the member and login parameters are mutually exclusive.

Parameters
member optional The Discord member to unsubscribe. Admin only. Leave empty to unsubscribe yourself.
login optional Twitch login of an external streamer to unsubscribe. Admin only. Cannot be used together with member.

Allows following a Twitch streamer who is not a member of the Discord server. Notifications will be sent to the configured channel, exactly like for a regular member.

Useful for example to notify the lives of a partner or a creator affiliated with your community.

Parameter
login The Twitch login of the streamer to follow (e.g. squeezie, sardoche).

Displays the full list of all subscribed members with their associated Twitch login. Also shows whether a dedicated channel (/set_channel) has been configured for any of them.

Members whose Twitch login could not be resolved are listed separately with a ❌ icon.

Creates or updates the link between a Discord member and a Twitch account manually. Essential when a member's Discord display name differs from their Twitch login (accented names, underscores, etc.).

SquadBot verifies that the provided Twitch login exists before saving the association.

Parameters
member The Discord member to link.
login The member's exact Twitch login (e.g. squeezie). Case-insensitive.
Dedicated channels

Assigns a dedicated announcement channel to a specific streamer. When they go live, their notification will be sent to that channel instead of the default channel configured via /setup.

Handy for organising announcements per streamer if your community is large.

Parameters
member The streamer member to assign a dedicated channel to.
channel The text channel to use for this streamer's announcements.

Removes the dedicated channel associated with a streamer. After this, their notifications will be sent back to the default channel configured during /setup.

Parameter
member The streamer member whose dedicated channel should be removed.