PlexAnnouncer

PlexAnnouncer

Docker app from JohnnyP's Repository

Overview

A Discord bot that sends updates about your plex media to a Discord channel using webhooks. Please see the support thread for more details on how to set it up and configure Discord and Plex.

Plex Announcer

A Discord bot that sends updates about newly added Plex media to a Discord channel using webhooks.

Getting Started

To get started you first have to setup a webhook within your discord server / channel settings and copy the webhook url.

For more information about how you create webhooks and what they are check here.

Usage

Note that the container bust me accessible from your plex host. If you running both of them on the same server just enter localhost instead.

With Env Variables

Run the container and specify your PLEX_SERVER_URL, PLEX_WEBHOOK_TOKEN and DISCORD_WEBHOOK_URL as environment variables:

docker run -p 32500:32500 -e PLEX_SERVER_URL="https://app.plex.tv/desktop#!/server/SERVER_ID" -e PLEX_WEBHOOK_TOKEN="SOME_RANDOM_TOKEN" -e DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN" tenasi/plexannouncer:latest

With Config File

First create a config file somewhere and insert your plex server url, your Discord webhook url and some random token.

{
    "plex_server_url": "https://app.plex.tv/desktop#!/server/SERVERID",
    "plex_webhook_token": "RANDOM_TOKEN",
    "discord_webhook_url": "https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN"
}

Then run the container and point to your config folder:

docker run -v /path/to/config/dir:/config -p 32500:32500 tenasi/plexannouncer:latest

Register the Webhook in Plex

Register the bot in Plex under Settings/Webhooks with the link being:

http://IP:PORT/RANDOM_TOKEN

Sources

Install PlexAnnouncer on Unraid in a few clicks.

Find PlexAnnouncer in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for PlexAnnouncer Review the template variables and paths Click Install

Download Statistics

56,686
Total Downloads
799
This Month
341
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
tenasi/plexannouncer:latest
Last Updated2023-01-12
First Seen2021-03-14

Runtime arguments

Network
bridge
Shell
bash
Privileged
false

Template configuration

Webhook PortPorttcp

The port for incoming webhooks from Plex, it must match the port specified in the webhook url in your plex settings.

Target
32500
Default
32500
Value
32500
Plex Server URLVariable

The url pointing to your Plex server, you can obtain it from the external url of one of your Plex server libraries.

Target
PLEX_SERVER_URL
Plex Webhook TokenVariable

Some randomly generated token, you can put anything alphanumeric in here.

Target
PLEX_WEBHOOK_TOKEN
Discord Webhook URLVariable

The url of your Discord webhook, retrieve it from your server webhook settings. A comma seperated list of urls is also possible.

Target
DISCORD_WEBHOOK_URL
Updated LibrariesVariable

List of libraries that will be checked for new media, if this is empty it checks all libraries.

Target
UPDATED_LIBRARIES