Skip to content


Image of DockServer

Website: https://dockserver.io Discord: https://discord.gg/A7h7bKBCVa License: GPL 3

Tauticord

A Discord bot that displays live data from Tautulli

Features

Tauticord uses the Tautulli API to pull information from Tautulli and display them in a Discord channel, including:

OVERVIEW:

  • Number of current streams
  • Number of transcoding streams
  • Total bandwidth
  • Total LAN bandwidth

FOR EACH STREAM:

  • Stream state (playing, paused, stopped, loading)
  • Media type (tv show/movie/song/photo)
  • User
  • Media title
  • Product and player
  • Quality profile
  • Stream bandwidth
  • If stream is transcoding
  • Progress of stream
  • ETA of stream completion

Administrator (the bot owner) can react to Tauticord's messages to terminate a specific stream (if they have Plex Pass).

Users can also indicate what libraries they would like monitored. Tauticord will create/update a voice channel for each library name with item counts every hour.

Requirements

  • A Plex Media Server
  • Tautulli
  • A Discord server

Installation and Setup

Setup a Discord Bot

HOW TO MAKE A DISCORD BOT: https://www.digitaltrends.com/gaming/how-to-make-a-discord-bot/

Permissions required:

  • Manage Channels
  • View Channels
  • Send Messages
  • Manage Messages
  • Read Message History
  • Add Reactions

Setup Tauticord

  • Install Tauticord from Docksever Addons Menu.

  • Stop the container.

sudo docker stop tauticord

  • Head over to the appdata folder.

cd /opt/appdata/tauticord/

  • Create a config file.

sudo nano config.yaml

  • Copy / Paste the following config into the created file from previous step.
appName: Tauticord
logLevel: WARN

Tautulli:
  Connection:
    URL: ""
    APIKey: ""
  Customization:
    TerminateMessage: "Your stream has been terminated. Please contact the admin in the Discord."
    # how often (seconds) the bot pulls new data. 5-second minimum built-in, it's for your own good
    RefreshSeconds: 15
    # can only kill streams if you have a Plex Pass, so this controls whether you're given the option
    PlexPass: true
    ServerTimeZone: "UTC"
    Use24HourTime: false
    VoiceChannels:
      Stats:
        CategoryName: "Tautulli Stats"
        StreamCount: false
        TranscodeCount: false
        Bandwidth: false
        LocalBandwidth: false
        RemoteBandwidth: false
      Libraries:
        CategoryName: "Tautulli Libraries"
        Enable: false
        LibraryRefreshSeconds: 3600
        LibraryNames:
          # list of names of the libraries you'd like stats about
          # Voice channels will be made/updated with stats (refreshed every hour)
          - Movies
          - TV Shows
          - Music

Discord:
  Connection:
    BotToken: ""
    # Right-click on your server's icon -> "Copy ID"
    ServerID: 472537215457689601
    # Right-click on your profile picture -> "Copy ID"
    AdminIDs:
      - 00000000000
    # Where the live stats will be posted
    ChannelName: "tautulli"
  Customization:
    # if True, use embeds to print information, use regular text message if False
    UseEmbeds: true

Extras:
  # See README.md for details
  Analytics: true
  • Edit the config file to your needs.

  • Start the container.

sudo docker start tauticord

Et voilĂ , your Bot should now be online in your Disord Server.


Wiki Maintainer

@cyb3rgh05t


Support

Kindly report any issues/broken-parts/bugs on github or discord

  • Join our Discord: https://discord.gg/A7h7bKBCVa for Support
Back to top