Documentation

Notifications & live cards

Every alert is a custom-rendered gold-on-navy card plus the message and pings you configure — not a plain embed. Here's each piece and how to customize it.

What a notification contains

When a monitored streamer goes live, the bot posts (to every configured channel):

  • Your mentions (@everyone, @here, and/or role pings) and custom message, with placeholders substituted.
  • The live card — a 1200×630 image rendered on the fly: streamer avatar in a gold ring, stream title, a platform-colored LIVE badge, the Twitch/Kick brand wordmark, the game name, and high-resolution game cover art (see where the art comes from).
  • A Watch Live button linking straight to the stream — optional and relabelable.

The dashboard's live preview renders the exact production card, so what you see while configuring is what your community gets.

Custom message & placeholders

The custom message (up to 1,500 characters) is posted above the card. These tokens are substituted with the live stream's details at post time — the form has one-click insert chips for each:

PlaceholderBecomes
{streamer}The streamer's display name
{game}The game / category being streamed
{title}The stream title
{url}The direct watch link
{platform}“Twitch” or “Kick”
{login}The channel's lowercase login/slug
{timestamp}A live Discord timestamp (“2 minutes ago”, auto-localized for every viewer). On card images it renders as plain text instead.

Show message on the card — an optional toggle that also renders your (substituted) message onto the card image itself, in a gold-accented block.

Mentions

Pick @everyone, @here, and/or any number of specific server roles (up to 25 selections). Only the pings you choose actually fire — the bot sends an exact allow-list with every message, so a stray “@everyone” typed in the custom message text can never mass-ping by accident.

Test alerts never ping. The Test button strips all mentions so you can verify formatting without notifying the whole server.

The Watch Live button

By default every alert carries a link button labeled 🔴 Watch {streamer} live pointing at the stream. Per monitor you can:

  • Disable it entirely (no button row is sent), or
  • Relabel it (up to 80 characters). Labels support {streamer}, {game}, {title}, {platform}, and {login}{url} is intentionally not substituted there, since the button itself is the link.