Skip to main content

Tautulli

Connect Tautulli to unlock analytics and monitoring on your homescreen-hero dashboard. Track collection performance, view streaming activity in real-time, and visualize viewing trends with interactive charts.

Setup​

  1. Find your API key in Tautulli Settings > Web Interface > API
  2. Add it to your .env file:
HSH_TAUTULLI_API_KEY=your-api-key
HSH_TAUTULLI_BASE_URL=http://your-tautulli-ip:8181  # Optional, defaults to http://localhost:8181
  1. If you didn't enable Tautulli in the Setup Wizard, simply enable it on the Integrations page (or directly in config.yaml):
tautulli:
  enabled: true

Dashboard Widgets​

Once connected, three Tautulli-powered widgets become available on your dashboard:

Analytics Card​

Displays your top 5 collections by play count over the last 30 days. Toggle between Movies and TV Shows to see which collections are getting the most attention. Includes a "Collect Now" button to manually trigger a fresh analytics snapshot.

Active Streams Card​

Shows current live streaming activity on your Plex server. Color-coded - green when people are watching, gray when idle. Click to expand and see details for each active stream: who's watching, what they're watching, playback state, and progress.

Auto-refreshes every 30 seconds.

A three-panel carousel with interactive charts:

  • Peak Concurrent Viewers - Maximum simultaneous streams over time
  • Peak Viewing Hours - Play distribution by hour of day (great for seeing when your server is busiest)
  • Stream History - Play count trends over time

Each graph supports time range filtering: 24 Hours, Week, Month, or Year.

Analytics Collection​

homescreen-hero collects analytics snapshots that aggregate play counts and watch time across your rotation collections. Since Tautulli tracks individual items (not collections), homescreen-hero queries each item in a collection and aggregates the stats.

Collection happens in two ways:

  • Automatically after each rotation - enabled by default via collect_on_rotation
  • Manually - click "Collect Now" on the Analytics widget
tautulli:
  enabled: true
  collect_on_rotation: true       # Auto-collect after each rotation (default: true)
  collect_interval_hours: 24      # Minimum hours between collections (default: 24)

What Tautulli Unlocks​

Beyond the dashboard widgets, having Tautulli connected also enables:

  • Unwatched Report tool - requires Tautulli to query watch history (see Tools & Utilities)
  • Collection performance tracking - see which collections actually get watched after rotation