The weeb for the next gen discord boat - Wamellow
wamellow.com
bot
discord
add reddit notification docs
+130
-35
+2
-2
app/(home)/page.tsx
+2
-2
app/(home)/page.tsx
···
314
314
>
315
315
<span className="font-semibold">Free styling, 30 Channels</span>
316
316
</ClientChip>
317
-
<h3 className={styles.h3}>YouTube, Twitch & Bluesky</h3>
317
+
<h3 className={styles.h3}>YouTube, Twitch, Bluesky & Reddit</h3>
318
318
<div className="pt-6">
319
319
Set up notifications with free custom messages and embeds for up to 30 channels and get notified in less than a minute.
320
320
321
321
<ol className="mt-4">
322
322
{[
323
-
"Youtube, Twitch, and Bluesky (bsky.app)",
323
+
"Youtube, Twitch, Bluesky and Reddit",
324
324
"Custom message & embed",
325
325
"Up to 30 channels",
326
326
"Insanely fast"
+2
-2
app/dashboard/[guildId]/notifications/page.tsx
+2
-2
app/dashboard/[guildId]/notifications/page.tsx
···
213
213
/>
214
214
: <TextInput
215
215
className="md:w-1/2 w-full"
216
-
name="Regex filter"
216
+
name="Ignore regex"
217
217
url={url + "/" + item.id}
218
218
dataName="regex"
219
-
description="Uploads that match the provided regex will be ignored."
219
+
description="Posts that match the provided regex will be ignored."
220
220
defaultState={item.regex || ""}
221
221
/>
222
222
}
+1
-1
public/docs/meta.json
+1
-1
public/docs/meta.json
···
79
79
"name": "📢 Social Notifications",
80
80
"file": "notifications.md",
81
81
"image": "/docs-assets/open-graph/notifications-youtube.webp",
82
-
"description": "Notify your community when creators on YouTube, Twitch or Bluesky post or go live!",
82
+
"description": "Notify your community when creators on YouTube, Twitch, Bluesky or Reddit post or go live!",
83
83
"permissions": {
84
84
"bot": [
85
85
"View Channel",
+125
-30
public/docs/notifications.md
+125
-30
public/docs/notifications.md
···
1
-
- Instant notifications for **YouTube, Twitch and Bluesky (bsky.app)**, more comming soon!
2
-
- Every server can have **up to 30 different channels and streamers for free**.
3
-
- Notifications are sent **within five to ten seconds** after uploading.
1
+
- Instant notifications for **YouTube, Twitch, Bluesky and Reddit**, more comming soon!
2
+
- Every server can have **up to 30 different channels and users for free**.
3
+
- Notifications are sent **in real-time, almost instantly** after uploading.
4
4
- And **free custom messages** for every notification individually.
5
5
<br />
6
6
···
12
12
2. Head to the dashboard by going to [wamellow.com/dashboard](https://wamellow.com/dashboard?to=notifications).
13
13
3. Select your server from the dashboard.
14
14
4. Navigate to the **Notifications** tab.
15
-
5. Click **Create new Notification**, select a platform and enter a channel url or @handle.
15
+
5. Click **Create new Notification**, select a platform and enter a channel url or username.
16
16
7. Click **Submit** and start customizing your message!
17
17
<br/>
18
18
<br/>
19
19
20
-
No need to worry about creators changing their usernames—Wamellow updates them automatically.
20
+
No need to worry about creators changing their usernames — Wamellow updates them automatically.
21
21
You also don’t need to own the channel to create notifications. As long as the channel is public, you can add it.
22
22
<br/>
23
23
<br/>
···
42
42
**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.
43
43
44
44
### 📫 Filter
45
-
Allows you to select additional types or filter notifications for Bluesky.
45
+
Allows you to select additional types or filter notifications for Bluesky:
46
46
- `Send Reposts` will also notify when the user reposts any post.
47
47
- `Send Replies` will also notify when the user replies to any post.
48
48
- `Send Quotes` will also notify when the user quotes any post.
49
49
- `Must Contain Image` will only notify when the post contains an image.
50
+
<br />
51
+
<br />
52
+
53
+
For all other services, you can take advantage of a regex to blacklist posts:
54
+
- `^\[live\]` will not post anything starting with `[live]`.
55
+
- `insult|badword` will not post anything that includes either `insult` or `badword`.
56
+
<br />
57
+
<br />
58
+
59
+
You can use [regexr.com](https://regexr.com/) or [ChatGPT](https://chatgpt.com/) to create (JavaScript-like) regexs.
60
+
You can use regex keywords to negate the condition, in order to create a whitelist filter.
61
+
The flags used for string matching are `gi`, only the title is checked.
50
62
51
63
### 🥳 Test notification
52
64
Test notifications let you see how your message will look like when a video is uploaded or a streamer goes live, etc.
53
65
54
66
For the purpose of testing, all pings are disabled, so no member will get notified.
55
67
For streaming platforms, like Twitch, mock (fake) data is used to simulate a live stream.
68
+
Notification filters will be ignored.
69
+
70
+
## Better embeds
71
+
If you’d like to improve embeds (for example, fixing Bluesky embeds), you can use the following custom messages:
72
+
- `https://bskyx.app/profile/{creator.handle}/post/{post.id}` ([Lexedia/VixBluesky](https://github.com/Lexedia/VixBluesky))
73
+
- `https://fxbsky.app/profile/{creator.handle}/post/{post.id}` ([fxbsky.app](https://bsky.app/profile/fxbsky.app))
74
+
- `https://vxbsky.app/profile/{creator.handle}/post/{post.id}` ([dylanpdx/vxBsky](https://github.com/dylanpdx/vxBsky))
75
+
- `https://bskye.app/profile/{creator.handle}/post/{post.id}` ([FerroEduardo/bskye](https://github.com/FerroEduardo/bskye))
76
+
- `https://bsyy.app/profile/{creator.handle}/post/{post.id}`
77
+
78
+
A preview of all embeds can be found [in this reddit post](https://www.reddit.com/r/BlueskySocial/comments/1he642f/comparing_bluesky_fix_embed_sites/).
79
+
80
+
## Offline notifications
81
+
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](/status).
82
+
83
+
## Notification speed
84
+
Notifications are typically sent within these time frames:
85
+
- **YouTube**: 4 to 8 seconds
86
+
- **Twitch**: 10 to 100 seconds
87
+
- **Bluesky**: 0.4 to 0.6 seconds (400ms to 600ms)
88
+
- **Reddit**: up to 20 minutes
89
+
90
+
## Platform limitations
91
+
YouTube keeps the video private for a few seconds to minutes after uploading, so the notification might be delayed by a few seconds.
92
+
<br />
93
+
<br />
94
+
95
+
Due to changes in Reddits' API pricing in 2023, we can't offer faster notification speeds, but 20 minutes should be fine.
96
+
Since Reddit is still in testing, you can only setup 4 subreddits per server.
56
97
57
98
## Placeholders
58
99
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}`.
···
230
271
<br />
231
272
<br />
232
273
274
+
<mark>
275
+
These are only available for Reddit. (*4)
276
+
</mark>
277
+
278
+
<table>
279
+
<thead>
280
+
<tr>
281
+
<th width="192">Placeholder (*4)</th>
282
+
<th>Example</th>
283
+
<th width="181">Description</th>
284
+
</tr>
285
+
</thead>
286
+
<tbody>
287
+
<tr>
288
+
<td><code>post.id</code></td>
289
+
<td>1in69l2</td>
290
+
<td>Post id</td>
291
+
</tr>
292
+
<tr>
293
+
<td><code>post.text</code></td>
294
+
<td>A very, very long text</td>
295
+
<td>Post body</td>
296
+
</tr>
297
+
<tr>
298
+
<td><code>post.thumbnail</code>*</td>
299
+
<td>https://.../..</td>
300
+
<td>Post thumbnail</td>
301
+
</tr>
302
+
<tr>
303
+
<td><code>post.posted.ago</code></td>
304
+
<td><t:1715878720:R></td>
305
+
<td>Time since post</td>
306
+
</tr>
307
+
<tr>
308
+
<td><code>post.posted.at</code></td>
309
+
<td><t:1715878720:f></td>
310
+
<td>Post time & date</td>
311
+
</tr>
312
+
<tr>
313
+
<td><code>author.username</code></td>
314
+
<td>wayabot</td>
315
+
<td>Author username</td>
316
+
</tr>
317
+
<tr>
318
+
<td><code>author.id</code></td>
319
+
<td>1ea1sud48</td>
320
+
<td>Author id</td>
321
+
</tr>
322
+
<tr>
323
+
<td><code>author.link</code></td>
324
+
<td>https://reddit.com/user/wayabot</td>
325
+
<td>Author url</td>
326
+
</tr>
327
+
<tr>
328
+
<td><code>subreddit.name</code></td>
329
+
<td>r/wamellow</td>
330
+
<td>Subreddit name</td>
331
+
</tr>
332
+
<tr>
333
+
<td><code>subreddit.id</code></td>
334
+
<td>d6lqay</td>
335
+
<td>Subreddit id</td>
336
+
</tr>
337
+
<tr>
338
+
<td><code>subreddit.members</code></td>
339
+
<td>1642519</td>
340
+
<td>Subreddit members</td>
341
+
</tr>
342
+
</tbody>
343
+
</table>
344
+
<br />
345
+
346
+
*`post.thumbnail` is in testing and might change, note that it's content is optional and might be empty.
347
+
348
+
<br />
349
+
<br />
350
+
233
351
<table>
234
352
<thead>
235
353
<tr>
···
302
420
<td>Member count</td>
303
421
</tr>
304
422
</tbody>
305
-
</table>
306
-
307
-
## Better embeds
308
-
If you’d like to improve embeds (for example, fixing Bluesky embeds), you can use the following custom messages:
309
-
- `https://bskyx.app/profile/{creator.handle}/post/{post.id}` ([Lexedia/VixBluesky](https://github.com/Lexedia/VixBluesky))
310
-
- `https://fxbsky.app/profile/{creator.handle}/post/{post.id}` ([fxbsky.app](https://bsky.app/profile/fxbsky.app))
311
-
- `https://vxbsky.app/profile/{creator.handle}/post/{post.id}` ([dylanpdx/vxBsky](https://github.com/dylanpdx/vxBsky))
312
-
- `https://bskye.app/profile/{creator.handle}/post/{post.id}` ([FerroEduardo/bskye](https://github.com/FerroEduardo/bskye))
313
-
- `https://bsyy.app/profile/{creator.handle}/post/{post.id}`
314
-
315
-
A preview of all embeds can be found [in this reddit post](https://www.reddit.com/r/BlueskySocial/comments/1he642f/comparing_bluesky_fix_embed_sites/).
316
-
317
-
## Offline notifications
318
-
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](/status).
319
-
320
-
## Notification speed
321
-
Notifications are typically sent within these time frames:
322
-
- **YouTube**: 4 to 8 seconds
323
-
- **Twitch**: 10 to 100 seconds
324
-
- **Bluesky**: 0.4 to 0.6 seconds (400ms to 600ms)
325
-
<br />
326
-
<br />
327
-
328
-
**Note:** YouTube keeps the video private for a few seconds to minutes after uploading, so the notification might be delayed by a few seconds.
423
+
</table>