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
- 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
- Python 3.7+
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
Install requirements with:
pip3 install -r requirements.txt
Copy config.yaml.example
to config.yaml
and complete the variables in the file.
Run the script with the following command:
python3 Tauticord.py
You can also run Tauticord as a Docker container.
After copying and editing your config.py
file, build the container with:
docker build -t tauticord .
Run the container with docker run tauticord
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 Python 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 do a pull request.