📺 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 admin login screen for admin access
• 📄 Per-user logs stored locally for review (Beta)
• ♻️ Skips duplicate notifications by tracking each user's last 200 alerts
• 🐳 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

Replace the env values as needed. The container runs on port 5000.

Unraid Setup

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

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

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

🔒 Authentication

The admin login screen is optional but recommended. Set the following environment variables to enable the login form:

WEBUI_USER=yourusername
WEBUI_PASS=yourpassword

When set, the Web UI redirects to a login page at /login, and a session cookie is used after successful sign-in. The WEBUI_USER and WEBUI_PASS values are the exact credentials users must enter on the login form.

📬 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
  

• Each user also gets a personal log file:

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

🧪 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.

☕ Support

If you find Plex Notifier helpful, consider supporting the project: