Tauticord

A Discord bot that displays live data from Tautulli

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

• Number of current streams
• Number of transcoding streams
• Total bandwidth
• Total LAN bandwidth
• Total remote bandwidth
• Library item counts

• 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.

• A Plex Media Server
• Tautulli (formerly known as PlexPy)
• A Discord server
• Docker
• A Discord bot token
  • Permissions required:
    • Manage Channels
    • View Channels
    • Send Messages
    • Manage Messages
    • Read Message History
    • Add Reactions
    • Manage Emojis
  • Shortcut: Use the following link to invite your bot to your server with the above permissions: https://discord.com/oauth2/authorize?client_id=YOUR_APPLICATION_ID&scope=bot&permissions=1073818704

Tauticord runs as a Docker container. The Dockerfile is included in this repository, or can be pulled from Docker Hub or GitHub Packages.

You will need to map the following volumes:

You will need to set the following environment variables:

You can also set these variables via a configuration file:

1. Map the /config directory (see volumes above)
2. Enter the mapped directory on your host machine
3. Rename the config.yaml.example file in the path to config.yaml
4. Complete the variables in config.yaml

Please note, if the config.yaml file is present, the application will ONLY use this file for configuration. If you are going to use it, you need to fill it out in its entirety.

You can run Tauticord outside of Docker by cloning this repository and either:

• renaming config.yaml.example to config.yaml, filling out the settings inside config.yaml and running the bot with python3 run.py --config config.yaml
• adding the above environmental variables to your system and running the bot with python3 run.py

Please note, this is NOT ADVISED. Running this application as a Docker container is the only officially-supported method of running Tauticord.

• On startup, Tauticord attempts to upload a set of custom emojis that it will use when displaying stream information ( if they do not already exist). Your bot will need to have the Manage Emojis permission in order to do this.
  • Discord has a limit of 50 custom emojis per server. If you have reached this limit, you will need to remove some of your existing emojis before Tauticord can upload its own.
  • If you do not want to remove any of your existing emojis, Tauticord will simply skip uploading its own emojis and use the default emojis that Discord provides instead.

Tauticord uses Google Analytics to collect statistics such as common errors that will help with future development. This data is limited, anonymous, and never sold or redistributed.

When and what data is collected?

• Whenever the bot comes online
  • What operating system the bot is running on (Windows, Linux, MacOS, etc.)
• Whenever an error is logged
  • What function the error occurred in.

What data is NOT collected:

• Any identifying information about the user
• Any identifying information about the computer/machine (a random ID is generated on each analytics call, IP addresses are anonymized)
• Settings for Discord or Tautulli, including passwords, API tokens, URLs, etc.
• Any data from Tautulli
• Anything typed in Discord.

This bot is still a work in progress. If you have any ideas for improving or adding to Tauticord, please open an issue or a pull request.

Please leave a pull request if you would like to contribute.

Follow me on Twitter: @nwithan8

Also feel free to check out my other projects here on GitHub or join the #developer channel in my Discord server below.

Thanks goes to these wonderful people (emoji key):

Nate Harris	Thomas White	Tim Wilson	Thomas Durieux
Roy Du	benwaco