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.
-
Within the Plex connection form that has a Tautulli connection, click
. -
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/
. -
Open Tautulli and navigate to the Settings by clicking the Gear icon in the top right.
-
From the left navigation bar, open the
Web Interface
settings. -
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.
-
Back within TitleCardMaker, paste the API key from Step 5 into the API key input box.
-
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. -
Click
. -
Open Plex (on a computer) and navigate to your server settings via the Wrench icon in the top right corner.
-
From the left navigation bar, scroll down to
Library
under theSettings
section and take note of yourVideo Played Threshold
setting (this is an Advanced Setting). -
Back in Tautulli, open the
General
settings from the sidebar, and find theTV 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.