Plex¶

Current Version¶

Reaction example:

Plex Trigger Overview¶

1. Opens the integrations settings.
2. Reloads the integration.
3. Triggers
   • Play - When media starts playing
   • Direct Play - Requires play enabled, sends notifications for direct play streams
   • Single Transcode - Requires play enabled, sends notifications for single transcode streams (audio or video)
   • Full Transcode - Requires play enabled, sends notifications for full transcode streams (audio and video)
   • Resume - When media starts playing after being paused
   • Finished - When media stops playing, this uses the client to track plex sessions (do not use with Scrobble enabled)
   • Scrobble - When media stops playing, this uses the plex webhook (requires Plex Pass)
   • Rating - Notify when a user rates a movie/show (requires Plex Pass)
   • New Item - Notify when a new item is added to plex (requires push notifications enabled in Plex and Plex Pass)
   • Sessions - A snapshot of what is playing, transcoding, server info, etc
   • New Devices - Notify when a new device is added (requires push notifications and Plex Pass)
   • Db Backup - Notify when a database backup was completed (requires push notifications and Plex Pass)
   • Db Corruption - Notify when database corruption is detected (requires push notifications and Plex Pass)
4. Discord Channels
   • Channel(s) to use for sending plex notifications

Integration Settings Menu¶

Click the cog icon to open the integration settings for Plex.

1. Basic Instructions - Gives you basic guidelines on how to setup this integration in the UI.
2. Triggers - Adjust which webhooks will send notifications to you.
3. Integration Settings - Allows the user to further configure the integration.
4. Extra Settings - Adjust the extra settings for this integration.
5. Client Settings - Allows the user to set the scanning interval.
6. Custom Icon - Assign another icon to notifications from this integration. (Subscriber Feature)
7. Content Lines - Add a message to the top of notifications for wearable/toast purposes.
8. Screenshots - Shows the expected output once all correctly configured.
9. Save - Saves all your Configured settings and closes the Integration Settings Menu.

Triggers¶

1. Notification triggers.
2. Notification fields - Select various fields to be displayed in the notification.
3. Notification colors.

Integration Settings¶

Here you can adjust the settings for this integration.

User/Device¶

1. Table of all users and devices. Uncheck the notify box to not receive notifications from the specific user/device.
2. Keyword for having the bot display what is currently streaming on your server.

Session Management¶

1. Scope - Kill all sessions from a given user/device (Maybe a user shared their login with someone else).
2. Rules - Kill the session after rules have been met.
3. Action - Notify when sessions are automatically killed.

Library Trash¶

Note: You may see the following error when tab is loading: Error fetching plex library list. Ensure the client settings are saved and try again.

1. Trigger - Keyword to trigger a cleanup outside the set frequency and time
2. Library - Check which libraries you want the automated trash cleanup
3. Trash Settings - The time and frequency of the automated cleanup
   • Frequency - How frequently this should try to clear the trash.
   • Time - What time of day this should try to clear the trash.
   • Max - Do not empty if trash items is more than this number (in case of a drive failure for example).
   • Copy - Copy applied settings to all libraries. Note: This only appears on the first listed library.
4. Times - The times for the library

Extra Settings¶

Additional settings such as automatically unmonitor an episode or movie once a user has watched it. You are able to select multiple users by holding down ctrl and highlighting the names.

• Item Ratings - How to display ratings when media is rated (plain text, stars, or stars with label)
• Split by Rating - Send notifications with selected content ratings to a separate channel
• Unmonitor movie on finish - Automatically unmonitor a movie after selected users finish watching in selected Radarr instances (Patron feature, requires finished/scrobble notifications enabled)
• Unmonitor episode on finish - Automatically unmonitor an episode after selected users finish watching in selected Sonarr instances (Patron feature, requires finished/scrobble notifications enabled)
• Delete movie & file on finish - Delete movie and file after selected users finish watching in selected Radarr instances (Patron feature, requires finished/scrobble notifications enabled)
• Delete movie file on finish - Delete only the movie file after selected users finish watching in selected Radarr instances (Patron feature, requires finished/scrobble notifications enabled)
• Delete episode on finish - Delete episode after selected users finish watching in selected Sonarr instances (Patron feature, requires finished/scrobble notifications enabled)
• Delete delay - How long to wait after the finished notification before deleting, in minutes (Patron feature)
• Delete exclusions (TMDb) - TMDb IDs to exclude from automatic movie deletion, separated by commas (Patron feature)
• Delete exclusions (TVDb) - TVDb IDs to exclude from automatic episode deletion, separated by commas (Patron feature)
• Library exclusion - Ignore notifications from specific libraries

Client Settings¶

1. Account Map - This will map user emails in your notifications to a user friendly name.
2. Plex and Tautulli Account Map - Examples of mapped accounts.
3. Track Play/Resume sessions - Check this if you want to get Play/Resume notifications but do not have a Plex Pass.
4. Finished Movie - This is a percentage setting for when to send a finished playing movie notification, 0 to disable, 70 min and 95-98 suggested.
5. Finished Episode - This is a percentage setting for when to send a finished playing episode notification, 0 to disable, 70 min and 95-98 suggested.
6. Include Activity - This is a used to send speed, transcode, container, etc information in plex notifications.
7. Activity Delay - This is how long to wait after media is started before getting the session, at least 10-12 seconds is needed.
8. Cooldown - Minimum time between notifications to ensure duplicates are not sent (such as media.play and playback.started)
9. Interval - This is how often to send a notification for the Plex Sessions trigger, nothing sends if there is no media playing or paused.

Custom Icon¶

Assign another icon to notifications from this integration (Subscriber Feature)

Content Lines¶

Content lines are small previews of the full notification for toast/push notifications. Great for wearables.

Instructions¶

This integration requires the Notifiarr client to be running locally. You can get it from Github. After installing, you need to setup plex in the UI. An example is

1. The name for Plex comes from Plex and cannot be changed here. There is no automatic way to add a service check to Plex. If you want service checks, add one for it in Service Checks.
2. http:// or https:// URL for the application instance. If your application has a Base URL, include it. Providing an https:// URL reveals a checkbox. Checking this box enables SSL certificate validation; invalid certificates generate an error.
3. Your Plex Token you may find directions for locating your Plex token at this Plex Article.
4. This controls the maximum duration a request to this application may elapse. Selecting No Timeout can be dangerous. Selecting Disabled completely disables the instance.

Webhook¶

In Plex, add a webhook that points to http://localhost:port/plex?token=plex-token-here

• Replace localhost:port with the ip:port to the Notifiarr client
• Replace plex-token-here with the token for Plex so the Notifiarr client allows the incoming connection