Reddit Post Notifier

Reddit Post Notifier is a self-hosted service that watches Reddit for new posts matching your saved search queries and sends you an alert through any…

  • Communication
  • Tools & Utilities
Reddit Post Notifier is a self-hosted service that watches Reddit for new posts matching your saved search queries and sends you an alert through any Apprise-compatible channel such as email, Pushover, or Discord.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
54last commit 190 days ago
Popular
3133 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
33
Open issues
2
Last commit
2026-05-15
Latest release
v2.0.2
License
MIT
Activity
stale

Checked 6 days ago - source: GitHub (RafhaanShah/Reddit-Post-Notifier)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add your Reddit Pixel ID first If this install uses the Reddit Pixel, replace the placeholder Pixel ID with the code Reddit gives you, and add any customer match keys you have, such as email, phone, or device ID. Without the correct Pixel ID, the pixel may send data to the wrong place, so conversion tracking can be missing or wrong. source
  • Use a clear Reddit API User-Agent If the app talks to the Reddit API, set its User-Agent string to describe the app, version, and your contact info. A clear string helps Reddit identify the app, which makes API issues easier to spot and fix. source
  • Set up ads trackers only if you run Reddit Ads Only if you are running Reddit Ads, build the Singular or Kochava tracker URLs with the required campaign, ad, ad group, and advertiser IDs. Missing required IDs will break ad attribution, but you can skip this if you are not using Reddit Ads. source
  • Prerequisites Create a Reddit account, obtain Reddit API client_id and client_secret via OAuth2, and configure an Apprise-supported notification service with its API keys. source
  • Example configuration Copy the repository's config.yaml.example file and set your search queries, Apprise URLs, and notification details. source
  • Reddit API Access Create a Reddit account and obtain Reddit API client_id and client_secret before configuring Apprise alerts. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How should subreddit filters be structured in the config file?

Put the desired filters for each monitored subreddit under the reddit key, with proper indentation and single quotes if needed.

What Reddit API header should I configure for reliable operation?

Set a clear User-Agent string that describes the app, version, and your contact info so Reddit can identify the app and troubleshoot API issues.

Can notifications be scheduled instead of sent immediately?

Yes, the project can create schedules for email notifications when new posts contain a specific keyword in selected subreddits, and it uses Temporal for custom schedules.

Is there a support thread for running it on Unraid?

Yes, there is an Unraid support thread for reddit-post-notifier covering notifications for new posts that match search criteria.

Answers sourced from business.reddithelp.com, forums.unraid.net, github.com, github.com

Community

Collected 49 days ago - public community threads