# PlexAnnouncer

PlexAnnouncer is a Discord bot that posts a notification to a chosen Discord channel whenever new media is added to your Plex Media Server library. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1583/plexannouncer

## Description

PlexAnnouncer is a Discord bot that posts a notification to a chosen Discord channel whenever new media is added to your Plex Media Server library. It runs as a lightweight self-hosted container, giving Plex server administrators real-time alerts about library changes in Discord.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

30/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1618 days ago)
- Popular: 23 (13 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/tenasi/plexannouncer
- Docker Hub: https://hub.docker.com/r/tenasi/plexannouncer
- Unraid: https://ca.unraid.net/apps/plexannouncer-1q1e4jg08rj1ns?q=PlexAnnouncer

## Common questions

### What endpoint do I register in Plex for PlexAnnouncer?

Add a Plex webhook pointing to your host IP, port 32500, and the random token you set for plex_webhook_token.

### Can PlexAnnouncer run on the same machine as Plex?

Yes. If both run on the same server, the container just needs to be reachable from the Plex host, and you can use localhost for PLEX_SERVER_URL.

### Do I have to use environment variables to configure PlexAnnouncer?

No. You can create a config file containing plex_server_url, plex_webhook_token, and discord_webhook_url, then mount that directory to /config.

### How does PlexAnnouncer send messages to Discord?

Create a webhook in the Discord channel you want to notify and put that webhook URL into DISCORD_WEBHOOK_URL or the config file.

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