Tautulli Active Streams Integration for Home Assistant
Like This Integration?
If you find the **Tautulli Active Streams** integration helpful, please take a moment to give it a ⭐ on [GitHub] Your feedback and support help improve the project and motivate further development. Thanks! 🚀
Features
A custom integration for Home Assistant that allows you to monitor active Plex streams using Tautulli Api.
- Dynamically creates session sensors based on active Plex streams.
- Custom Sensor Count – Choose how many active streams to display.
- Adjustable Scan Interval – Set how often HA updates stream data.
- Detailed Session Attributes – Each active stream sensor provides:
Media Title & Type (Movie, TV Show, etc.)
User (Who is watching)
IP Address & Device
Playback Progress & Quality- And so much more!
- Kill All Active Streams:
A new service that terminates every active stream, regardless of the user. - Kill Active Streams by Username:
A new service that terminates all streams associated with a specified username. - Kill Active Streams by Session:
A new service that terminates a Single stream.
➡️ Click Here 🛠️ How to Use the Kill Stream Services
Check Attributes in "plex_session_" for "user" or "session_id"
Kill All Active Streams
Call the service from Developer Tools → Actions:
service: tautulli_active_streams.kill_all_streams
data:
message: "Your Message Here"
Kill Streams for a Specific User
Call the service for a specific user:
service: tautulli_active_streams.kill_user_stream
data:
user: "john_doe"
message: "Your Message Here."
Kill Streams for a Specific Session
Call the service for a specific user:
service: tautulli_active_streams.kill_session_stream
data:
session_id: "gxvzdoq4fjkjfmduq5dgf25hz"
message: "Your Message Here."
These new features are designed to work seamlessly with automations and will become even more powerful as additional data becomes available in future updates.
GitHub: Tautulli Active Streams
Home-assistant Community: (https://community.home-assistant.io/t/custom-component-tautulli-active-streams)
Installation
-
Via HACS:
- Open HACS in Home Assistant.
- Click the three dots in the top right corner and select Custom repositories.
- Add the repository URL for this integration and choose Integration as the category.
- Download the integration from HACS.
-
Manual Installation:
- Download the repository from GitHub.
- Place the entire folder into your
custom_components/tautulli_active_streamsdirectory.
-
Setup in Home Assistant:
- Go to Settings → Devices & Services and Add the integration.
- Enter your Tautulli details (URL, API Key), and set the Session Sensor Count and Refresh Interval.
Don’t forget to add the Card below.
My usage: I have a chip card that displays the current active session count.
When clicked, It will trigger a bubble popup card where all active sessions can be viewed.
Custom Lovelace card
Produced by @stratotally and Edited by me.
Dynamically displays active Plex sessions using Tautulli data fetched by the Tautulli Active Streams integration.
- Install
Tautulli Active Streamsintegration via HACS or manually. - Ensure Lovelace resources for
auto-entities,button-card,bar-card,card-modare loaded. - Copy the YAML below into your Lovelace dashboard.
- Enjoy real-time Plex session monitoring!
➡️ Click Here Card YAML - Last updated 23.02.2025
type: custom:auto-entities
filter:
exclude:
- state: unknown
- state: unavailable
- state: "off"
- state: "on"
include:
- entity_id: "*plex_session_*"
options:
entity: this.entity_id
type: custom:button-card
tap_action:
action: none
variables:
entity: this.entity_id
custom_fields:
picture:
card:
type: picture
image: |
[[[
return states[variables.entity].attributes.image_url
? states[variables.entity].attributes.image_url
: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAHCCAIAAADaUWPQAAABoElEQVR4nO3BMQEAAADCoPVPbQwfoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgL8BMCQAAX/csOsAAAAASUVORK5CYII=";
]]]
card_mod:
style: |
ha-card {
box-shadow: 0;
border-radius: 5px;
margin: 1px 3px -4px 3px;
}
ha-card img {
min-height: 80px;
min-width: 80px;
}
bar:
card:
type: custom:bar-card
entities:
- entity: this.entity_id
attribute: progress_percent
unit_of_measurement: "%"
positions:
icon: "off"
indicator: "off"
name: inside
height: 19px
color: |
[[[
if (states[variables.entity].state == 'playing') {
return '#2986cc';
} else if (states[variables.entity].state == 'paused') {
return '#e49f29; animation: blink 1.5s linear infinite;';
} else {
return '#000000'; // Default color if neither playing nor paused
}
]]]
name: |
[[[
return states[variables.entity].state
]]]
card_mod:
style: |-
@keyframes blink {
50% {
opacity: 0;
}
}
ha-card {
--ha-card-background: rgba(0, 0, 0, 0.8) !important;
border: 0.02px solid rgba(70, 130, 180, 0.3);
box-shadow: none;
}
ha-card #states {
padding: 0;
}
bar-card-currentbar, bar-card-backgroundbar {
border-radius: 8px;
left: 0;
}
bar-card-name {
margin-left: 3%;
text-shadow: 1px 1px 1px #0003;
}
bar-card-value {
margin-right: 3%;
text-shadow: 1px 1px 1px #0003;
}
user: |
[[[
return "<b>" + states[variables.entity].attributes.user + "</b>"
]]]
title: |
[[[
if (states[variables.entity].state == 'playing') {
return "<ha-icon icon='mdi:play' style='width: 15px; height: 15px; position: relative; top: -2px;'></ha-icon> " + states[variables.entity].attributes.full_title;
} else {
if (states[variables.entity].state == 'paused') {
return "<ha-icon icon='mdi:pause' style='width: 15px; height: 15px; position: relative; top: -2px;'></ha-icon> " + states[variables.entity].attributes.full_title;
} else {
return states[variables.entity].attributes.full_title;
}
}
]]]
stream: |
[[[
return states[variables.entity].attributes.transcode_decision + " - " + states[variables.entity].attributes.stream_video_resolution;
]]]
product: |
[[[
var player = states[variables.entity].attributes.player;
var product = states[variables.entity].attributes.product;
return product + ' - ' + '<i>' + player + '</i>';
]]]
media_detail: |
[[[
if(states[variables.entity].attributes.media_type == 'movie') {
return "<ha-icon icon='mdi:filmstrip' style='width: 15px; height: 15px; position: relative; top: -2px;'></ha-icon> (" + states[variables.entity].attributes.year + ")";
} else {
return "<ha-icon icon='mdi:television-classic' style='width: 15px; height: 15px; position: relative; top: -2px;'></ha-icon> S" + states[variables.entity].attributes.parent_media_index + " • E" + states[variables.entity].attributes.media_index;
}
]]]
bandwidth: |
[[[
var bytes = states[variables.entity].attributes.bandwidth * 1000;
var sizes = ['Bytes', 'Kbps', 'Mbps', 'Gbps', 'Tbps'];
if (bytes == 0) return 'n/a';
var i = parseInt(Math.floor(Math.log(bytes) / Math.log(1000)));
if (i == 0) return 'Bandwidth: ' + bytes + ' ' + sizes[i];
return 'Bandwidth: ' + (bytes / Math.pow(1000, i)).toFixed(1) + ' ' + sizes[i];
]]]
card_mod:
style: |
ha-card {
padding: 0;
margin: 0;
border: 0.01px solid rgba(70, 130, 180, 0.5);
box-shadow: 3px 3px 5px rgba(0, 0, 0, 0.5); /* Add a box shadow effect */
background: rgba(0.40, 1, 0, 0.5) !important;
}
ha-card #container {
margin: 5px 0 0 0;
}
#name {
display:none;
}
styles:
card:
- height: 100x
- padding: 0
custom_fields:
bar:
- text-transform: capitalize
- font-size: 13px
- padding-top: 2px
- padding-bottom: 0px
user:
- text-transform: capitalize
- text-align: end
- font-size: 12px
- font-family: Arial, sans-serif;
- font-style: italic;
- letter-spacing: 2px;
- margin-left: "-60px;"
title:
- text-transform: capitalize
- text-align: start
- font-size: 26px
- margin-top: "-5px"
- margin-bottom: 2px
stream:
- text-transform: capitalize
- text-align: start
- font-size: 12px
product:
- text-transform: capitalize
- text-align: start
- font-size: 12px
media_detail:
- text-transform: uppercase
- text-align: start
- font-size: 15px
bandwidth:
- text-transform: capitalize
- text-align: end
- font-size: 12px
- margin-left: "-60px;"
grid:
- grid-template-areas: |
"picture product user"
"picture title title"
"picture media_detail media_detail"
"picture bar bar"
"picture stream bandwidth"
- grid-template-columns: 1fr 200px 3fr
- grid-gap: 5px 3px
card:
type: vertical-stack
card_param: cards
Troubleshooting
No Data Appearing?
- Ensure your Tautulli API key, Url are correct.
- Restart Home Assistant after making changes.
- Check Developer Tools → States for
sensor.plex_session_*.
Contributing
Want to improve this integration? Feel free to submit a PR or open an issue on GitHub!
License
This project is licensed under the MIT License.
