Skip to content

Plex (Tautulli)

Tautulli tracks what’s played on Plex. This shows streams, who’s watching, most watched, plays over time and a race of the year’s titles, and the assistant can stop a stream, after asking.

config.yaml
integrations:
tautulli:
type: tautulli
url: http://tautulli:8181
apiKey: ${TAUTULLI_APIKEY}
href: https://plex.example.com
layout:
- title: Media
widgets:
- tautulli.library
OptionTypeDefaultWhat it does
urlURLrequiredWhere the service answers, from Valet’s side.
apiKeystringrequiredIts API key. Use ${VAR}.
hrefstringoptionalWhere the card links to, when that differs from url.

8 widgets. Each key starts with your instance name, here tautulli.

tautulli.library · stats card · refreshes every hour while the page is open.

Plex (Tautulli), Your library, medium size
Medium
Plex (Tautulli), Your library, large size
Large
Plex (Tautulli), Your library, in chat
In chat

Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Your library: Can't reach it
Can't reach it

tautulli.top · ranked card · refreshes every hour while the page is open.

Plex (Tautulli), Most watched, medium size
Medium
Plex (Tautulli), Most watched, large size
Large
Plex (Tautulli), Most watched, in chat
In chat

Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Most watched: Nothing watched yet
Nothing watched yet
Plex (Tautulli) Most watched: Can't reach it
Can't reach it

tautulli.people · list card · refreshes every minute while the page is open.

Plex (Tautulli), Who's watching, medium size
Medium
Plex (Tautulli), Who's watching, large size
Large
Plex (Tautulli), Who's watching, in chat
In chat

Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Who's watching: Nobody on right now
Nobody on right now
Plex (Tautulli) Who's watching: Nobody yet
Nobody yet
Plex (Tautulli) Who's watching: Can't reach it
Can't reach it

tautulli.plays · chart card · refreshes every hour while the page is open.

Plex (Tautulli), Plays, medium size
Medium
Plex (Tautulli), Plays, tall size
Tall
Plex (Tautulli), Plays, large size
Large
Plex (Tautulli), Plays, in chat
In chat

Small draws the same as medium. Wide draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Plays: Can't reach it
Can't reach it

tautulli.race · race card · refreshes every 6 hours while the page is open.

Plex (Tautulli), The year so far, small size
Small
Plex (Tautulli), The year so far, wide size
Wide
Plex (Tautulli), The year so far, medium size
Medium
Plex (Tautulli), The year so far, large size
Large
Plex (Tautulli), The year so far, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Plex (Tautulli) The year so far: No history yet
No history yet
Plex (Tautulli) The year so far: Can't reach it
Can't reach it

tautulli.viewing · heatmap card · refreshes every 6 hours while the page is open.

Plex (Tautulli), Viewing, medium size
Medium
Plex (Tautulli), Viewing, tall size
Tall
Plex (Tautulli), Viewing, large size
Large
Plex (Tautulli), Viewing, in chat
In chat

Small draws the same as medium. Wide draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Viewing: Can't reach it
Can't reach it

tautulli.streams · media card · refreshes every 10 seconds while the page is open.

Plex (Tautulli), Now playing, small size
Small
Plex (Tautulli), Now playing, wide size
Wide
Plex (Tautulli), Now playing, medium size
Medium
Plex (Tautulli), Now playing, large size
Large
Plex (Tautulli), Now playing, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Plex (Tautulli) Now playing: One stream
One stream
Plex (Tautulli) Now playing: Paused
Paused
Plex (Tautulli) Now playing: Buffering
Buffering
Plex (Tautulli) Now playing: Nothing playing
Nothing playing
Plex (Tautulli) Now playing: Can't reach it
Can't reach it

tautulli.recent · shelf card · refreshes every 5 minutes while the page is open.

Plex (Tautulli), Recently added, medium size
Medium
Plex (Tautulli), Recently added, large size
Large
Plex (Tautulli), Recently added, in chat
In chat

Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.

Plex (Tautulli) Recently added: Nothing added
Nothing added
Plex (Tautulli) Recently added: Can't reach it
Can't reach it

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

ToolAccessWhat it does
plex_stop_streamcontrolStop someone’s Plex stream, with a short message they’ll see.
plex_streamsreadWho is watching what on Plex right now: title, user, device, progress, quality, direct play or transcode, bandwidth.
plex_recently_addedreadThe most recently added movies and episodes on Plex.
plex_statsreadWhat’s been watched most on Plex in the last 30 days, and who has watched the most.
plex_historyreadRecent watch history: who watched what and when.

Slides this integration adds to the recap.

Recap slide: You watched 272 hours. 332 plays, all from your own server.
You watched 272 hours
Recap slide: Your most watched The Long Tide . 111 plays and 81 h, more time than anything else this year.
Your most watched The Long Tide
Recap slide: Your night in Fridays . 50 of your 332 plays started on a Friday.
Your night in Fridays
Recap slide: Who kept Plex busiest Sam . 107 h of the 272 h everyone watched.
Who kept Plex busiest Sam