Skip to content
April Docs

Stream monitors

Stream monitors announce Twitch live streams or YouTube video uploads in a Discord server.

Before you start

Section titled “Before you start”

Sign in to the dashboard, select a server you can manage, and make sure April can access and send messages to the destination text or announcement channel. You need a Twitch streamer or YouTube channel to monitor. These images show unsaved drafts and empty lists captured in a local English dashboard on 2026-11-01; they do not demonstrate delivery. Availability depends on the running service and its provider subscriptions; saving settings alone does not verify delivery.

Create a monitor

Section titled “Create a monitor”

  1. In the server sidebar, open Twitch or YouTube. The list shows your existing monitors; an empty list means there are none to show.

    The Twitch Streamers list is empty, with three available slots and an add control.

    The empty Twitch list in the local English dashboard.

  2. Choose the add control and search for the streamer or YouTube channel. Select the intended result.

  3. Under Notifications, expand the default Live (Twitch) or Video upload (YouTube) notification. It starts enabled, but has no destination channel selected.

  4. Under Select channel, choose the Discord channel for the announcement. Edit the message if you wish, then choose Submit.

    The Twitch creation form shows an unselected streamer, an enabled Live notification, an empty channel selector and the default embed.

    The unsaved Twitch form and its default Live message.

  5. Check that the monitor appears in the list and its switch is enabled. For example, select a Twitch streamer and a #streams text channel; the next supported live event should send the configured announcement there.

For YouTube, follow the same steps in YouTube, choosing a channel and a Video upload notification. A new eligible upload should produce an announcement.

The YouTube creation form shows Video upload and a message using stream title and URL variables, alongside its preview.

An unsaved YouTube message and its preview; no destination or YouTuber has been selected.

The save confirms the configuration was accepted; it is not a test of provider subscription or Discord delivery. There is no test button or test command established for this workflow. To check delivery, use an authorized real event and inspect the chosen Discord channel. YouTube videos more than 14 days old are skipped.

The list provides controls to edit, duplicate, disable or remove a monitor. When duplicating, select the streamer or channel again and review the destination before saving. Disabling the monitor stops the Worker from announcing it; re-enable it to resume. Removing it deletes the saved monitor.

Notification types

Section titled “Notification types”

Live is the supported Twitch event path and Video upload is the YouTube event path. The editor also offers Twitch Offline, but the current subscription and callback implementation handles live events only; do not rely on offline announcements. An update-style Twitch delivery path is not established by the current source.

Each notification has a switch, destination and messages.

A disabled Live notification displays an Enable message to view overlay over its settings.

The disabled notification in an unsaved local form.

The editor offers Add notification and prevents adding the same type twice. A newly created monitor can contain at most three notifications and each notification can contain up to 15 messages; when several messages are configured, one is selected at random for an announcement. Keep the monitor enabled and configure a usable message and channel. The current delivery code does not check the individual notification switch, so use the monitor switch when you need to stop announcements.

For servers without premium, the dashboard permits up to three Twitch monitors and five YouTube monitors. The API separately applies a limit of five per platform for non-premium servers. Limits and availability may differ with the running version.

Message templates

Section titled “Message templates”

The Twitch Live default is an embed containing stream details; the YouTube Video upload default includes {stream.url}. For example, a YouTube message can say New video: {stream.title} — {stream.url}. Twitch variables include {stream.title}, {stream.url}, {stream.preview} and {stream.viewerCount}; YouTube also supports {stream.channel.name}. See Formatting variables for the full stream variable list.

Troubleshooting

Section titled “Troubleshooting”
  • No search result or a search error: check the spelling and platform, then try again. Provider search or the service may be unavailable.
  • Cannot open or save settings: confirm you are signed in and can manage the selected server. Check the selected streamer, destination and validation messages. If a create request reports an error, refresh the list before retrying: a monitor may have been saved before subscription setup failed.
  • Cannot add another monitor: check the dashboard limit for the platform and the server’s premium status. Review existing monitors before removing any.
  • No announcement: confirm the monitor is enabled, its notification has a message and a text or announcement destination, and April can access and send to that channel. Check the event type and wait for a new supported event. If it still fails, ask the service operator to check provider subscriptions, callbacks and delivery; saving does not prove those steps succeeded.
  • Notification settings are covered: turn on the notification switch to edit them. To stop delivery reliably, disable the monitor itself.

See Adding April for server setup and Formatting variables for message options.