Skip to content

Tautulli

Optional Step

This step is completely optional, and only those with both Plex media servers and Tautulli should continue.

If you do not use Plex or Tautulli, a Sonarr Webhook can be utilized as an alternative - setting this up is covered here.

Why Connect to Tautulli?

Typically, TitleCardMaker creates and loads Title Cards on an adjustable schedule. However, TCM is able to set up a Notification Agent on Tautulli so that it can notify TCM immediately after new Episodes are available, or an existing Episode has been watched.

A similiar integration can be enabled with Sonarr, but that integration only triggers for newly added content, not on watch-statuses.

  1. Within the Plex connection form that has a Tautulli connection, click Create Notification Agent.

  2. In the launched window, enter the root URL to your instance of Tautulli.

    Example URL

    Although your local IP address will obviously be different, this IP should be like http://192.168.0.29:8181/.

  3. Open Tautulli and navigate to the Settings by clicking the Gear icon in the top right.

  4. From the left navigation bar, open the Web Interface settings.

  5. Scroll to the bottom, and ensure the Enable API checkbox is checked, then show and copy the generated API key.

    Security Warning

    Keep this API key private, as it can be used to remotely access and modify Tautulli.

  6. Back within TitleCardMaker, paste the API key from Step 5 into the API key input box.

  7. If you want Tautulli to trigger TitleCardMaker when episodes are watched, and not just when episodes are added, then leave the Trigger on Recently Watched checkbox checked. I also recommend entering your username in the username input so that Tautulli is only triggered when you watch content.

  8. Click Create Agent.

  9. Open Plex (on a computer) and navigate to your server settings via the Wrench icon in the top right corner.

  10. From the left navigation bar, scroll down to Library under the Settings section and take note of your Video Played Threshold setting (this is an Advanced Setting).

  11. Back in Tautulli, open the General settings from the sidebar, and find the TV Episode Watched Percent setting. Set this to 1-2% higher than the Plex setting from Step 9.

    Example Setting

    For a Plex played threshold of 90%, the appropriate Tautulli setting is 91% or 92%.

    Why is this Necessary?

    Because this integration is so fast (typically triggering within 5 seconds of finishing an Episode) - it is imperative that Tautulli triggers TCM to update a Title Card after an Episode's watch-status has had time to update within Plex.

Once created, you can close the box within TCM. Unlike the other Connections, your Tautulli connection details will not be stored (and so will not appear) in TCM - this is because TCM only submits API requests to Tautulli to create an agent. Afterwards, it is Tautulli that sends data to TCM, and so no active connection is required.