Live Announcements: Members Announce Themselves with /live

With the Live Announcements module, members announce themselves: "I'm live right now" or "I just published something new". The /live command posts an embed in a channel you choose. It works for any platform, even where Kage cannot detect anything automatically.

How this module differs from automatic detection

Use /live when a platform offers no detection, such as X, TikTok or Instagram, or when members should decide themselves when to report something.

Setting up

1. In the dashboard, open Live Announcements and switch the module on.
2. Choose the announcement channel. Without a channel, /live replies that the feature is not set up.
3. Optionally choose a role that is mentioned with every announcement, for example a role for viewers who want to be notified.
4. Set the cooldown per member in minutes. The default is 60, the smallest value 1.
5. Save. The bot needs permission to write and to embed in the channel.

The /live command

Every member may use /live. There is no permission check.

Kage then posts an embed with the title, the platform, the link and the person's profile picture. For Twitch, YouTube and Kick the heading reads "🔴 Name is live now!", for all other platforms "🔔 Name published something new!". The language of the embed follows the server language. The reply to the person follows their Discord language and is visible only to them.

Cooldown

The cooldown applies per member and server. The first announcement always goes through right away. After that the person has to wait as long as you set, and otherwise gets a message saying how many minutes are left. The cooldown starts as soon as Kage accepts the announcement, before it is sent.

Settings at a glance

Checking the result

1. Set up: Switch the module on and choose a channel.
2. Announce: Enter /live platform:Twitch title:Test. The reply "Announced in #channel" appears and the embed is in the channel.
3. Cooldown: Enter the command again right away. Kage tells you how long you still have to wait.
4. Log: In the Logs tab of the module you find the entry "announced".

Troubleshooting

"This feature isn't set up on this server yet"

The module is off, or no channel is chosen. Check both in the dashboard.

"The configured announcement channel no longer exists"

The channel was deleted. Choose a new one in the dashboard.

"I'm not allowed to write in the announcement channel"

The bot lacks permission to write or to embed in the channel. In this case the person's cooldown still runs.

The /live command does not appear

The module is switched off on the server. Kage hides the commands of switched-off modules. Switch the module on and wait a moment until Discord has updated the commands.

"Please wait … minutes"

The cooldown is still running. An admin can shorten it in the dashboard.

Limits

• Kage does not check whether someone is really live, and checks neither the platform nor the link. Any member can post any text and links. If you do not want that, switch the module off or use Streamer Detection.
• The platform is only a choice from a fixed list and is not queried.
• There is no role or channel restriction for the command itself.

Further reading

Automatic detection: Streamer Detection and Social Alerts. Supported platforms in detail: Platforms.