• Views Views: 673
  • Last updated Last updated:
  • Stop using Chrome! Download the Brave Browser via >>> [Brave.com]
    It's a forked version of Chrome with native ad-blockers and Google's spyware stripped out! Download for Mac, Windows, Android, and Linux!
Welcome to the PlexGuide.com
Serving the Community since 2016!
Register Now
  • rsz_tautulli_logo.png


    Tautulli is a great way to gather information on how your Plex Server is being utilized, what users are playing, and enabling certain notifications and access controls for your users. With Plex's new ability to graph user bandwidth and info, Tautulli may not require deployment unless specific capabilities enhance your server. Tautulli for legacy users was known as PlexPy in the past.


    Access Information

    Only for Internal App-to-App Communication​
    Traefik must be Deployed; Remote Servers​
    Poor Security Practice - Stop with PG Port Guard​
    Ideal Only for Local Servers​

    Initial Configuration

    Default User: Plex Default Pass: guide Click Sign In


    Next, the following image should load as seen below. Click Next

    1. Sign into Plex! Click Sign in with Plex
    2. When done, Click Next
    1. Select a Server
    2. Select a Port (leave this alone; unless required to change)
    3. Click Verify to ensure that Tautulli connects to the Plex Server
    4. When done, Click Next
    • Click [Next] until you reach the end of the Tautulli Wizard!

    Helpful Scripts

    Prevent Transcoding at all or specific places

    You can use Tautulli to automatically prevent transcoding, either by resolution, by bit depth (i.e. stop HDR/10-bit files from being transcoded) or just at all. Why would you want this? If your server isn't powerful enough to do transcoding at all, but the users don't know enough to force direct play, then this will stop the stream and provide a pop-up message explaining the reason. Maybe your server can do transcoding, but not for 4K. Or maybe it can even do 4K, but Plex right now can't transcode HDR to HDR. So if you have a 4K or even 1080P video in HDR/10bit color and it has to transcode, it will only be in SDR. The tonemapping in Plex (and Emby/Jellyfin) - for now - is based on an FFMPG version that doesn't support HDR->HDR transcode, so it looks all washed out.

    • Confirm in Portainer that the host directory "/opt/appdata/tautulli/scripts" is mounted to "/scripts" in the Docker container (that is the default setting, so it should be already.)
    • From the host (SSH) enter the following code (slightly modified from https://github.com/PlexGuide/Community/wiki/Tautulli-Custom-Scripts):
      • cd /opt/appdata/tautulli/scripts
      • sudo curl -O https://raw.githubusercontent.com/blacktwin/JBOPS/master/killstream/kill_stream.py
      • sudo chown root:root kill_stream.py #not really necessary if running as root
      • sudo chmod a+x kill_stream.py
        • Note that the file size is actually ~20K, not 9K as listed on the github page.
    Follow the instructions below:
    • Configure Tautulli Notification Agent
      • Enter Tautulli settings and find the Notification Agents link on the left side menu.
      • Click Add a new notification agent and scroll down to Script in the selection dialog.
      • Configuration panel
        • Enter /scripts in the script folder and exit the text input field.
        • Select the script named ./kill_stream.py in the Script File drop-down.
        • Enter Terminate 4K transcodes or something of your own choice in the description field.
      • Triggers panel
        • Put a checkmark in Playback Start and Transcode Decision Change
      • Conditions panel
        • Condition {1}: Video Decision - is - transcode (you'll have to manually type in the transcode variable)
        • Add a new Condition (use the + symbol)
        • Condition {2}: Video Resolution - is - 4K (if you want it to prevent ANY transcoding of 4K video)
          • (Alternatively, if you only want to stop HDR/10 bit transcode, since even if your CPU/GPU can support 4K transcoding it will always be transcoded to SDR and look like garbage) : Video Bit Depth - is - 10
      • Arguments panel
        • Under Playback Start enter the following:--jbop stream --username {username} --sessionId {session_id} --killMessage 'Transcoding is not allowed from the 4K libraries.'
          • Note the "killMessage" part can be whatever text you want to pop-up when the transcode is stopped. For example, I changed mine to --jbop stream --username {username} --sessionId {session_id} --killMessage 'This is an HDR/10-bit color video. Transcoding will make the colors look washed out and bad. Please set your player to play at the original resolution.'
        • Under Transcode Decision Change enter the following: --jbop stream --username {username} --sessionId {session_id} --killMessage 'Transcoding is not allowed from the 4K libraries.'
      • Click the Save button to save the new notification agent. You can test the agent by attempting to play a 4K movie through the Plex web app and downgrade the quality to 2Mbit (or whatever will break the rule you set). It will be transcoding for about 5-10 seconds, after which you should get the stream kill message.
    This is an example of the pop-up your users will see if Tautulli stops the transcode:


    Tautulli Remote App

    Important note: If you use Google Authentication for Tautulli access, the Tautulli Remote App will NOT work.

    You must disable Google Authentication for Tautulli. Recommend setting a username and password in the Tautulli settings Web Interface tab under Authentication and also checking the Allow Plex Admin box. This will allow you login using your Plex authentication as the Tautulli administrator.

    Additional Information

  • Loading…