MediaHooks

MediaHooks is Raptor's centralized notification system for third-party media platforms. Currently, it supports YouTube, Twitch, and Bluesky, allowing you to keep your community informed the moment new content is released.

Features

  • Notifications: Raptor will notify your server when a new video is uploaded or a stream goes live.
  • Custom Templates: Full control over the wording and format of your announcements.

Getting Started

To manage your MediaHooks, navigate to your server's dashboard and select MediaHooks from the sidebar.

YouTube Notifications

  1. Resolve Channel: Paste a YouTube Channel URL, ID (starts with UC), or Handle (e.g., @handle) into the input box and click Resolve.
  2. Select Channel: Choose the Discord channel where you want the notification to be posted.
  3. Customize (Optional): Set a friendly name and a custom message template. (This is shown in the UI to help you keep track of what the channel is)
  4. Subscribe: Click the subscribe button.

YouTube Placeholders:

  • {video_title}: The title of the new video.
  • {video_url}: The direct link to the video.

Twitch Notifications

  1. Resolve Streamer: Enter the Twitch username (e.g., shroud) or URL and click Resolve.
  2. Select Channel: Choose the Discord channel for "Now Live" alerts.
  3. Customize (Optional): Set a custom message template.
  4. Subscribe: Click subscribe. Raptor will now monitor the streamer's status.

Twitch Placeholders:

  • {streamer}: The display name of the streamer.
  • {url}: The link to the Twitch channel.

Bluesky Notifications

  1. Resolve User: Enter the Bluesky handle (e.g., bsky.app) or profile URL and click Resolve.
  2. Select Channel: Choose the Discord channel for new post alerts.
  3. Customize (Optional): Set a custom message template.
  4. Subscribe: Click subscribe. Raptor will listen to the Bluesky firehose for new posts.

Bluesky Placeholders:

  • {handle}: The handle of the Bluesky user.
  • {url}: The link to the new Bluesky post.
  • {text}: The text content of the Bluesky post.

Announcement Templates

Templates allow you to customize how the bot announces new content. If left blank, Raptor uses a clean default message.

Example Template:HEY @everyone! I am like on twhtch: {url}

Permissions

Managing MediaHooks requires Editor or Admin access to the server dashboard.