Skip to content

ShivanshDengla/SubNotify

Repository files navigation

SubNotify

Ping subscribers when your recurring threads go live — weekly megathreads, monthly discussions, announcement posts, and anything else you run on a schedule.

Users opt in with a comment. When a new post matches your rules (flair or title), SubNotify comments on that post and tags everyone who subscribed — in small batches so Reddit doesn’t drop pings.


Install & turn on

  1. Install SubNotify on your subreddit.
  2. Open Community appsSubNotifySettings.
  3. Leave Enable notifications on.
  4. Paste the sample setup below into Notification rules (JSON) and edit it for your sub.
  5. Click Save.

Tell members to comment !subscribe (or !subscribe movies for a specific category) on any post.


What members type

Command What it does
!subscribe Subscribe to your default category (usually general)
!subscribe movies Subscribe to the movies category
!unsubscribe Unsubscribe from the default category
!unsubscribe movies Leave the movies category
!unsubscribe all Remove every subscription in your sub
!list See what you’re subscribed to
!help Show the command list

The bot replies under their comment. Subscriptions are only for your subreddit — not account-wide.


Settings (plain English)

Setting What to put
Enable notifications On = bot works. Off = commands still work, but no auto-pings.
Default category name Short name used when someone types !subscribe with nothing else. Example: general
Notification rules (JSON) Your categories and what posts trigger each one. See below.
Max users tagged per comment Keep at 25. Reddit ignores extra tags if you go too high.
Cooldown per category (minutes) Minimum time between two pings for the same category. 60 is a good default.
Command prefix Usually ! — the character before subscribe, help, etc.

How categories work

Think of a category as a bucket of subscribers + a rule for which posts ping them.

Each category has:

  • name — Short ID (lowercase, no spaces). Users subscribe with !subscribe monthly.
  • flairs — Post flairs that trigger this category. Must match exactly (not case-sensitive). Example: "Weekly Thread".
  • keywords — Words/phrases in the post title. If any keyword appears in the title, it triggers. Example: "weekly discussion".

A post triggers a category if either the flair matches or a keyword appears in the title.

A category with empty flairs and empty keywords does nothing (safety guard — it won’t ping on every post).


Sample setup (copy-paste)

Use this as a starting point. Change names, flairs, and keywords to match your sub.

[
  {
    "name": "general",
    "flairs": [],
    "keywords": ["weekly thread", "megathread"]
  },
  {
    "name": "monthly",
    "flairs": ["Monthly Discussion"],
    "keywords": ["monthly discussion", "monthly mega-thread"]
  },
  {
    "name": "movies",
    "flairs": ["Weekly Movies"],
    "keywords": ["movies of the week"]
  }
]

Example: A mod posts “Monthly Discussion — May 2026” with flair Monthly Discussion. Everyone who ran !subscribe monthly gets tagged in a comment on that post.


Mod tools (⋯ menu)

Action Where What it does
SubNotify: Stats Subreddit menu How many subscribers per category
SubNotify: Notify subscribers of this post Post menu Manually ping subscribers for this post (if it matches a rule). Skips cooldown.

Example flow

  1. You add the JSON above and set default category to general.
  2. A user comments !subscribe monthly on your welcome post.
  3. Next month you publish a post with flair Monthly Discussion.
  4. SubNotify comments: “New post for monthly subscribers” and tags u/user1 u/user2 … (up to 25 per comment; more subscribers = more comments).

Tips

  • Pin a post: “Comment !subscribe to get notified for weekly threads. !help for all commands.”
  • Test with a post title that includes one of your keywords before going live.
  • If pings feel spammy, raise Cooldown or narrow your keywords/flairs.

Bot account: u/subnotify-app (or your app’s slug). Questions or bugs: contact the app developer via the listing page.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors