📢 Social Notifications

• Instant notifications for YouTube, Twitch, Bluesky and Reddit, more comming soon!
• Every server can have up to 30 different channels and users for free.
• Notifications are sent in real-time, almost instantly after uploading.
• And free custom messages for every notification individually.

Setup

1. Add Wamellow to your server by going to wamellow.com/add.
2. Head to the dashboard by going to wamellow.com/dashboard.
3. Select your server from the dashboard.
4. Navigate to the Notifications tab.
5. Click Create new Notification, select a platform and enter a channel url or username.
6. Click Submit and start customizing your message!

No need to worry about creators changing their usernames — Wamellow updates them automatically. You also don't need to own the channel to create notifications. As long as the channel is public, you can add it.

✏️ Custom message & embed

You can create a notification message with a fully customizable message and embed for free, enabling you to style the messages the way you love.

Note: Image previews might be broken on the dashboard.

🏓 Pings

The role that should get notified about new uploads.

• @everyone will ping every member in the server.
• @here will ping every currently online member in the server.
• @some-role will ping everyone with that role.

Note: If Wamellow does not have the Mention Everyone permissions inside the channel, it might not be able to actually notify members with those roles.

📫 Filter

Allows you to select additional types or filter notifications for Bluesky:

• Send Reposts will also notify when the user reposts any post.
• Send Replies will also notify when the user replies to any post.
• Send Quotes will also notify when the user quotes any post.
• Must Contain Image will only notify when the post contains an image.

Allows you to select additional types or filter notifications for YouTube:

• Send Videos will notify when the creator uploads a new video or stream.
• Send Shorts will also notify when the creator uploads a new short.

For every service, you can take advantage of a regex to whitelist and blacklist posts.

You can use regexr.com or ChatGPT to create (JavaScript-like) regexs.

The following values are matched against:

• YouTube titles
• Twitch titles and game name*
• Bluesky post bodies
• Reddit post title and flair*

*In case of a Whitelist, it's enough for one of the values to match. In case of a Blacklist, no value must match the regex.

Whitelist examples

• ^\[live\] will only post anything starting with [live].
• Grand Theft Auto will only post anything that includes Grand Theft Auto. (useful for Twitch games)

Blacklist examples

• ^\[live\] will not post anything starting with [live].
• insult|badword will not post anything that includes either insult or badword.
• ^(?!support$).+$ will only post that are support. (useful for Reddit flairs)

🖱️ Show button row

By default, social notifications show a row of buttons bellow the message to: View the post on the original platform, or perform actions on the post (e.g. like, repost, etc.).

🗑️ Delete after stream

This allows you to delete the notification after the stream has ended.

🕵️‍♀️ Styles (whitelabel / webhook)

Notification styles allow you to customize (or whitelabel) the username and avatar of the author (i.e. the sender of the message) separately for each notification. Wamellow will automatically manage the webhooks for you.

The username must follow the name constraints set by Discord. The avatar must be a .png, .jpg, .jpeg, or .webp file and be less than 8MiB in size. (Animated formats like GIFs and APNGs are not supported by Discord)

🥳 Test notification

Test notifications let you see how your message will look like when a video is uploaded or a streamer goes live, etc.

For the purpose of testing, all pings are disabled, so no member will get notified. For streaming platforms, like Twitch, mock (fake) data is used to simulate a live stream. Notification filters will be ignored.

Better embeds

If you'd like to improve embeds (for example, fixing Bluesky embeds), you can use the following custom messages:

• https://bskyx.app/profile/{author.handle}/post/{post.id} (Lexedia/VixBluesky)
• https://fxbsky.app/profile/{author.handle}/post/{post.id} (fxbsky.app)
• https://vxbsky.app/profile/{author.handle}/post/{post.id} (dylanpdx/vxBsky)
• https://bskye.app/profile/{author.handle}/post/{post.id} (FerroEduardo/bskye)
• https://bsyy.app/profile/{author.handle}/post/{post.id}

A preview of all embeds can be found in this reddit post.

Offline notifications

If Wamellow is offline when a video, stream or post is published, your notification will be queued and sent as soon as Wamellow comes back online. You can view Wamellow's current status on the status page.

Notification speed

Notifications are typically sent within these time frames:

• YouTube: 4 to 8 seconds
• Twitch: 10 to 100 seconds
• Bluesky: 0.4 to 0.6 seconds (400ms to 600ms)
• Reddit: up to 20 minutes

Platform limitations

Each platform has specific technical constraints that may affect notification delivery:

• YouTube processes videos privately for several seconds after upload, which can cause delays in notifications.
• Reddit API pricing changes limit us to checking for new posts every 20 minutes, but this interval works well for most use cases.

In addition to the overall limit of 30 notifications per server (1,000 with premium), each platform has specific restrictions:

• YouTube: 30 channels maximum (1,000 with premium)
• Twitch: 30 channels maximum (1,000 with premium)
• Bluesky: 30 users maximum (100 with premium)
• Reddit: 4 subreddits maximum (10 with premium)

Please note that posts, videos or streams marked as adult content may only be sent into age-restricted Discord channels. You will need to mark the channel as Age-Restricted within the channel settings. Learn more here.

Placeholders

Placeholders allow you to use variables that change from message to message, for example to display information about the uploaded video or creator. They are always enclosed in curly braces, such as {creator.name}.

* If a post is a reply, and your custom message is {post.type}ed it will display replied to, instead of replyed.

** If {post.image} is used within text fields of the custom message, it will be rendered as an invisible hyperlink to embed the image. If it's used within image url fields, it will be rendered as an image.

*** You may also use {author.xxx} to refer to the author for all {creator.xxx} placeholders. In non-reposts, author and creator will be the same — if a post is a repost, creator will be the user who reposted the post, while author will be the original author of the post.