Tautulli
  • Introduction
  • Getting Started
    • Installation
      • Install as a Daemon
    • Upgrading to Python 3
  • Using Tautulli
    • Notifications Agents Guide
    • Custom Notification Conditions
    • Exporter Guide
    • 3rd Party APIs Guide
  • Support
    • Asking for Support
    • Frequently Asked Questions (FAQ)
    • Debugging Tautulli
  • Extending Tautulli
    • Custom Scripts
    • API Reference
Powered by GitBook
On this page
  • Notification Agents:
  • Browser
  • Boxcar
  • Discord
  • Email
  • Gmail
  • Outlook.com
  • Facebook
  • GroupMe
  • Growl
  • Hipchat
  • IFTTT
  • Join
  • Kodi
  • macOS Notification Center
  • MQTT
  • Notify My Android
  • Plex Home Theater
  • Plex Android / iOS App
  • Prowl
  • Pushbullet
  • Pushover
  • Script
  • Slack
  • Tautulli Remote Android App
  • Telegram
  • Twitter
  • Webhook
  • Zapier

Was this helpful?

  1. Using Tautulli

Notifications Agents Guide

PreviousUpgrading to Python 3NextCustom Notification Conditions

Last updated 4 years ago

Was this helpful?

Notification Agents:

  1. Click on Allow Notifications and give permission for Tautulli to send notifications through your browser.

  1. Go to the Settings page in your Boxcar app.

  2. Copy the Access Token and fill in the Tautulli setting.

  1. Go to Discord, and click on Edit Channel for the channel where you want the notifications to be sent.

  2. Go to the Webhooks tab and click on Create Webhook.

  3. Give your webhook bot a Name and Icon. This can be changed in the Tautulli settings instead if you wish.

  4. Copy the Webhook URL and fill in the Tautulli setting.

  • Note: Some anti-virus software have "Email protection" which may prevent sending emails via SMTP from a script. This will either need to be disabled or add an exception for Tautulli to send emails.

Gmail

SMTP Server:     smtp.gmail.com
SMTP Port:       587 or 465
SMTP User:       YourEmail@gmail.com or Username
SMTP Password:   Your Gmail password or app password
Encryption:      TLS/STARTTLS (587) or SSL/TLS (465)

Outlook.com

SMTP Server:     smtp.office365.com
SMTP Port:       587
SMTP User:       YourEmail@outlook.com
SMTP Password:   Your Outlook password or app password
Encryption:      TLS/STARTTLS (587)

Facebook has blocked all non-approved applications from posting to a group programmatically. Although Tautulli shouldn't be against their terms, they are refusing to approve any app that can do this.

Old, non-working instructions [This script](https://gist.github.com/spuniun/56624e1464c621c91e52f88e03321582) by [@spuniun](https://github.com/spuniun) could be used to post directly, however, Facebook has started banning accounts using it so it has been removed from the recommended methods. See the [Custom Scripts](Custom-Scripts) page for help setting it up. **Note:** Facebook has [redone their app approval process](https://developers.facebook.com/blog/post/2018/05/01/enhanced-developer-app-review-and-graph-api-3.0-now-live/), as such **all** apps _must_ go through the approval process fully before they will work again. To work around this you can send notifications via email to the group's secret email address from an account that is in the group. **Note:** As of March 2018, all new Facebook apps require HTTPS for authorization. If Tautulli is not running with HTTPS, the easiest method would be to check "Enable HTTPS" under the Web Interface tab (show advanced). This can be disabled after authorizing with Facebook. 1. Go to [Facebook Developers](https://developers.facebook.com/apps) and click `Add a New App`. 1. Click Add Product on the left, then click `Set Up` for Facebook Login. 1. Skip the Quickstart and go to Facebook Login > Settings on the left, and fill in the **Valid OAuth redirect URIs** with the one provided by Tautulli. 1. Go to Settings > Basic on the left, and fill in a **Privacy Policy URL**. 1. On the same page, get your **App ID** and **App Secret** and fill in the respective Tautulli settings. 1. Go to App Review on the left, and toggle your app to toggle "Make Public" to `Yes`. 1. Click the `Request Authorization` button in Tautulli to allow it to access your Facebook account. Make sure the app visibility is set to `Public` or `Friends` (`Only Me` will not work). 1. Copy the **Access Token** and fill in the Tautulli setting if it is not filled in automatically. 1. Get your **Group ID** from the URL of your group page (e.g. `https://www.facebook.com/groups/`) and fill in the Tautulli setting. If you have customized the URL and no longer have easy access to the Group ID, see [this answer](https://stackoverflow.com/questions/8957340/how-do-i-find-my-facebook-group-id) for how to obtain it. _Note:_ You should _only_ put the ID in the setting for Tautulli, not the full URL.

  1. Go to the Bots tab at the top and click Create Bot.

  2. Select the group chat where you want the notifications to be sent, give your bot a Name and Avatar, and click Submit. All other fields can be left at their default values.

  3. Copy the Bot ID and fill in the Tautulli setting.

  1. Open Growl and go to the General tab to make sure Growl is turned On and running.

  2. Optional: Go to the Security tab to set up a Password. Check "Allow network notifications" if Growl is running on a separate machine than Tautulli.

  3. Fill in the Host for the machine running Growl (e.g. localhost or 192.168.0.100) in the Tautulli settings.

  4. Fill in the Password, if required, in the Tautulli settings.

  1. Give your integration a Name and click Create.

  2. Copy the Integration URL and fill in the Tautulli setting.

  1. Click on Documentation to get your Webhook Key and fill in the Tautulli setting.

  2. Fill in the Event Name with the one that matches the Tautulli setting.

    • Tip: You can create different IFTTT events (e.g. tautulli_play, tautulli_stop, tautulli_created, etc.) by adding {action} to the Event Name in Tautulli (e.g. tautulli_{action}).

  3. Select "that" as whichever service you want.

  4. Fill in the settings of your service by adding the ingredients Value1, Value2, and Value3.

    • Value1 will be the subject line in your notification text settings.

    • Value2 will be the body text in your notification text settings.

    • (Optional) Value3 can be anything you select (e.g. Poster URL).

  1. Copy the API Key and fill in the Tautulli setting.

  1. From within Kodi, go to Settings > Service settings > Control, and make sure "Allow remote control via HTTP" is checked.

  2. Optional: Set the Port, Username, and Password for the Kodi Webserver. The default port is 8080.

  3. Enter in the Host Address for the machine running Kodi (e.g. http://localhost:8080) in the Tautulli settings.

  4. Fill in the Username and Password, if required, in the Tautulli settings.

Note: macOS Notification Center notifications will only work on the machine where Tautulli is installed.

  1. Fill in the path to your Tautulli application. The default is /Applications/Tautulli.

  2. Click the Register App button to register Tautulli with the Notification Center.

  1. Fill in the settings from your MQTT broker.

  1. Copy the API Key and fill in the Tautulli setting.

  1. From within OpenPHT/RasPlex, go to Preferences > System > Services, and make sure "Allow remote control via HTTP" is checked.

  2. Enter in the Host Address for the machine running OpenPHT or RasPlex with the port 3005 (e.g. http://localhost:3005).

  3. Fill in the Username and Password, if required, in the Tautulli settings.

Note: Plex Pass is required to send notifications to the Plex mobile apps.

  1. Open the Plex Android or iOS app, go to Settings > Notifications and enable the following notifications matching the triggers in the Tautulli notification agent:

    1. New Content Added to Library - Tautulli trigger: Recently Added

      • Note: Make sure to uncheck all libraries for the server connected to Tautulli.

    2. Playback Started - Tautulli trigger: Playback Start

      • Note: Make sure to uncheck the server and all users connected to Tautulli.

    3. New Devices - Tautulli trigger: User New Device

      • Note: Make sure to uncheck the server connected to Tautulli.

  2. Send a Test Notification from Tautulli and you should receive one test notification for each notification you have enabled in the Plex App.

Note: The user(s) receiving the notifications must have notifications enabled for the matching Tautulli triggers in their Plex mobile app.

Note: Push notifications do not need to be enabled in your Plex server Settings > General page. However, you may leave it enabled to receive the other notifications types from Plex (new server shared with you, new item on deck, database corruption detected, database backed up, etc.).

  1. Copy the API Key and fill in the Tautulli Setting.

  1. Copy the Access Token and fill in the Tautulli Setting.

  1. Give your application a Name and Icon, and click Create Application.

  2. Copy the API Token and fill in the Tautulli Setting.

    • If you want to send notifications to yourself, copy your User Key and fill in the Tautulli setting.

  • Please see the [[Custom Scripts Wiki Page|Custom Scripts]].

  1. Select the slack channel where you want the notifications to be sent, and click `Add Incoming Webhooks integration.

  2. Copy your Webhook URL and fill in the Tautulli setting.

  3. Scroll down to Integration Settings, and give your integration a Name and Icon. This can be changed in the Tautulli settings instead if you wish.

  1. Follow the instructions to give your bot a display name and a bot username.

  2. Copy the Bot Token and fill in the Tautulli setting.

Sending Messages to Yourself

  1. Create a new chat with your bot.

  2. Copy the Chat ID and fill in the Tautulli setting.

Sending Messages to a Group

  1. Copy the Group ID and fill in the Tautulli setting. Don't forget the hyphen (-) in the Group ID.

Sending Messages to a Channel

  1. Create a new Public Channel in Telegram.

  2. Go to Manage Channel and add your bot to the Administrators.

  3. Add a "Link" to your channel. This is your channel username (e.g. t.me/<CHANNEL_USERNAME>).

  4. Copy the Channel Username and fill in the Tautulli setting. Don't forget the at sign (@<CHANNEL_USERNAME>) in the Channel Username.

  1. Give your app a Name, Description, and Website. A valid website is not required.

  2. Go to the "Keys and Access Tokens" tab to get your Consumer Key and Consumer Secret, and fill in the respective Tautulli settings.

  3. Click on Create my access token to get your Access Token and Access Token Secret, and fill in the respective Tautulli settings.

  1. Find the Webhook URL for the service you are going to be using and fill in the Tautulli setting. Some examples:

  2. Pick the appropriate HTTP request method for your Webhook Method. Generally, you want to select POST here.

  3. Customize the raw JSON Data sent to the webhook on the Data tab.

  1. For "When this happens...", Choose App as "Webhooks by Zapier", and Choose Trigger as "Catch Hook", then click Continue.

  2. Copy the Custom Webhook URL and fill in the Tautulli setting, then click Continue in Zapier.

  3. Click Test & Review in Zapier, then click the Send Test Data button in Tautulli. A new hook will show up in Zapier with test data from Tautulli. Once everything is okay, click Done Editing.

  4. For "Do this...", Choose App as whichever service you want, and follow the instructions to connect the service.

  5. Set Up Template using the values Body, Subject, Action, Provider Name, Provider Link, Plex URL, and Poster URL. These values will all be filled in by Tatutulli.

  6. Make sure your Zap is turned on in the top right.

Note: If you use 2-factor authentication, then you will need to generate an app password .

Note: If you don't use 2-factor authentication, you may need to allow less secure apps to access your account. See Option 2 .

Note: If you use 2-factor authentication, then you will need to generate an app password .

There only currently known workaround is that Zapier also allows posting to Facebook, see for how to set this up. See for an example Facebook configuration within Zapier.

Go to and click Access Token at the top. Copy the token and fill in the Tautulli setting.

Go to , select the room where you want the notifications to be sent, and click Build your own integration.

Go to IFTTT and set up your service.

Create a , with "this" as "Webhooks", and the trigger "Receive a web request".

Go to , and click on Join API, then Show.

Go to and click Generate New Key.

Note: Plex Home Theater notifications only work with or .

Note: The user(s) must uncheck all the servers, libraries, and users connected to Tautulli in the Plex mobile app settings otherwise they may receive duplicate notifications from Plex and Tautulli. Use the in Tautulli to filter the notifications instead.

Go to , and generate a new API key by clicking Generate Key.

Go to , and click Create Access Token.

Go to Pushover, and .

Go back to the .

If you want to send notifications to a group, go to . Copy the Group Key and fill in the Tautulli setting.

Go to Slack, and create a new .

Please see the on how to register your .

Message on Telegram with the command /newbot to create a new bot.

Message on Telegram with the command /getid to get your Chat ID.

Create a new group chat with your bot and .

Message in the group with the command /getgroupid to get your Group ID.

Go to and click Create New App.

Discord:

Slack:

Go to Zapier and .

Browser
Boxcar
Discord
Email
here
here
here
Facebook
their agent guide
here
GroupMe
GroupMe Developers
Growl
Hipchat
Hipchat Integrations
IFTTT
Webhooks
New Applet
Join
Join App
Kodi
macOS Notification Center
MQTT
Notify My Android
Notify My Android
Plex Home Theater
OpenPHT
RasPlex
Plex Android / iOS App
custom notification agent conditions
Prowl
Prowl
Pushbullet
Pushbullet Account Settings
Pushover
Create a New Application
Pushover homepage
Create a New Group
Script
Slack
Incoming Webhook
Tautulli Remote Android App
Tautulli Remote Wiki
Tautulli Remote Android App
Telegram
@BotFather
@IDBot
@IDBot
@IDBot
Twitter
Twitter Apps
Webhook
Intro to Webhooks
Incoming Webhooks
Zapier
Make a Zap
Boxcar
Browser
Discord
Email
Facebook
GroupMe
Growl
Hipchat
IFTTT
Join
Kodi
macOS Notification Center
MQTT
Notify My Android
Plex Home Theater
Plex Android / iOS App
Prowl
Pushbullet
Pushover
Script
Slack
Tautulli Remote Android App
Telegram
Twitter
Webhook
Zapier