# PlexWatch

PlexWatch is a Discord bot that puts a live monitoring dashboard for your Plex or Jellyfin server directly inside your Discord server. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3203/plexwatch

## Description

PlexWatch (MediaWatch) is a Discord bot that puts a live monitoring dashboard for your Plex or Jellyfin server directly inside your Discord server. It keeps a persistent embed updated in real time with active streams, library totals, and server state, plus optional SABnzbd download and Uptime Kuma status sections. Interactive stream details let homelab admins inspect or terminate playback without leaving Discord.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

63/100 (Good), based on 5 of 5 factors.
- Maintained: 82 (last commit 10 days ago)
- Popular: 36 (64 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 95 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/nichtlegacy/PlexWatch
- Unraid: https://ca.unraid.net/apps/plexwatch-14hgwbn1adexwn?q=PlexWatch
- Documentation: https://mediawatch.nichtlegacy.com/docs/
- Official website: https://mediawatch.nichtlegacy.com/

## Common questions

### Does PlexWatch require a database for state?

No, it keeps runtime state in local files instead of Postgres or Redis. The Docker example mounts ./data:/app/data for that state and configuration.

### Can PlexWatch monitor both Plex and Jellyfin at the same time?

No, it loads exactly one platform at runtime. The active media server is selected by the media_server.type setting.

### Which Plex features require Tautulli?

Plex stream details, user and global statistics, and open in the media server require Tautulli. Jellyfin support is narrower and does not include user or global statistics.

### Who can view stream details and statistics in the Discord channel?

By default, anyone who can read the dashboard channel can open stream details. On Plex with Tautulli, they can also access global statistics, including a top-users leaderboard, unless two config options restrict that.

### What Discord and media server credentials are needed for setup?

You need a Discord bot token, a channel ID, your guild ID, at least one authorized user ID, and credentials for either Plex or Jellyfin. Secrets should be stored in .env while behavior is set in data/config.yaml.

---
Source: Our Local Host (https://ourlocalhost.com/app/3203/plexwatch), the self-hosted and open-source app directory.
