Discord Reddit Notifier

A bot for Discord that sends messages to a channel about new Reddit posts that match specific search terms.

I created this quickly when the Pager app was down for 2 days, so it's not exactly the most sophisticated bot. Currently, the bot only supports running on a single server, but notifications can be sent to different channels depending on your configuration.

Dependencies

This bot runs on Python 3.12 and depends on discord.py and Async PRAW.

Running the Bot

Using Docker-Compose

1. Configure your settings in ./config/config.toml (Read more)

2. Run docker compose

   • docker compose up --build -d

Manual

1. Configure your settings in ./config/config.toml. (Read more)

2. Install required dependencies with uv

   • uv sync

3. Run the bot

   • uv run notifier-bot/bot.py

Usage Example

The following watcher is defined in config.toml

[[watchers]]
name = "K-Pop Updates"
subreddit = "kpop"
enabled = true
channel_id = 8888888888888888888
color = 0xC77497
match_mode = "OR"
search_terms = [
  "loona",
  "artms",
  "loossemble",
  "chuu",
  "yves",
]

This watcher will watch r/kpop for new posts that contain any of the strings in search_terms in the title. Read more about watchers here.

Once the watcher finds a post that matches, an embed will be sent to the channel defined by channel_id, as shown below. Note that matches are case-insensitive.