jermcee/plex-notifier repository overview

⁠📺 Plex Notifier

Plex Notifier is a lightweight Flask-based web service that monitors your Plex library and emails users when new episodes are available — but only for shows they’ve already shown interest in (i.e. fully watched at least one episode).

Built with Docker, designed for Unraid, and powered by Tautulli.

⁠✨ Features

• ✅ Sends personalized email notifications for new episodes
• ✅ Automatically detects user interest via Tautulli watch history
• ✅ Fully responsive Web UI for configuring:
  • Plex and Tautulli credentials
  • Email (SMTP) settings
  • Notification interval
• ✅ Users can unsubscribe globally or per-show (Beta)
• 🔐 Optional HTTP Basic Auth for admin access
• 📄 Per-user logs stored locally for review (Beta)
• 🐳 Runs cleanly in Docker with Unraid support

⁠🧰 Requirements

• A running Plex Media Server
• A Tautulli instance connected to your Plex
• SMTP credentials (Gmail, Mailgun, etc.)
• Docker (or Unraid)

⁠🚀 Getting Started

⁠Docker CLI

docker run -d \
  --name plex-notifier \
  --net=host \
  -v /mnt/cache/appdata/plex-notifier:/app/instance \
  -e TZ=America/Chicago \
  -e SECRET_KEY=$(openssl rand -hex 32) \
  -e WEBUI_USER=admin \
  -e WEBUI_PASS=changeme \
  jjermany/plex-notifier:beta

⁠Unraid Setup

1. Go to the Apps tab (Community Applications).
2. Add this template repo:

   https://github.com/jjermany/unraid-templates
   

   Copy
3. Install the Plex Notifier (Beta) template.
4. Configure your settings in the WebUI (http://[Unraid IP]:5000).

⁠🔒 Authentication

HTTP Basic Auth is optional but recommended. Set the following environment variables:

WEBUI_USER=yourusername
WEBUI_PASS=yourpassword

⁠📬 Email Configuration

The following SMTP fields are required and configured via the Web UI:

• SMTP Host
• SMTP Port
• SMTP Username
• SMTP Password
• From Address (email)
• Base URL (used in unsubscribe links)

⁠📝 Subscription Management

Each email includes a secure unsubscribe link:

• Global opt-out: stop all future notifications
• Per-show opt-out: stop notifications for specific shows only

You can review and manage preferences directly in the Web UI after clicking the unsubscribe link.

⁠📦 Data & Logs

• All settings and user preferences are saved in:

  /app/instance/config.sqlite3
  

  Copy
• Each user also gets a personal log file:

  /app/instance/logs/[user]-notification.log
  

  Copy

⁠🧪 Development

Want to help or test features?

git clone https://github.com/jjermany/plex-notifier.git
cd plex-notifier
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
flask run

You can also use Docker Compose for local dev (optional).

⁠🙌 Contributing

Pull requests welcome! Please:

• Follow existing coding patterns
• Keep logging clean and minimal
• Add clear commit messages

⁠🛠️ Roadmap

• ✅ Per-show opt-out
• ✅ Web UI settings panel
• ⏳ Discord/Pushbullet support (future)
• ⏳ Plex token auto-refresh (if needed)

⁠📘 License

MIT License. See LICENSE⁠ for details.

⁠🛠 Web UI Configuration Guide

After starting the container, navigate to the Web UI (e.g. http://localhost:5000) and fill in the following fields:

⁠📺 Plex & Tautulli

⁠📧 Email Settings

⁠⏱️ Polling Interval

⁠🧪 Testing

• Use the "Send Test Email" form to verify SMTP settings.
• Use "Run Now (last 24h)" to manually trigger a check for new episodes.