JellyHA - Jellyfin Custom Integration for Home Assistant

smartpodgurc · January 31, 2026, 9:59am

Hi everyone,

I wanted to share a new integration I’ve been working on called JellyHA. First off, I want to say thanks to this amazing community with all the contributions you’ve all done so far. It has been incredibly helpful and inspiring.

I’ve been using Home Assistant for more than 9 years and recently got into the Jellyfin community, which I absolutely love. However, I was missing a good way to display my Jellyfin media library on my dashboards. Since I couldn’t find exactly what I was looking for, I decided to build it myself with the help of AI. It started as something just for my own needs, but I figured others might find it useful too, so I’m happy to share it.

What is JellyHA?

It’s a Home Assistant custom integration and Lovelace card that displays your movies and TV shows from Jellyfin in a nice, visual way. You can browse your media collection right from your dashboard with poster images, ratings, genres, and more. Build automations around your media library, playback status, and control your playback right from Home Assistant.

Main features

Library Card

Display media library in three different layouts: carousel, grid, and list
Filter library cards based on Media Type (Movies, TV Shows, Next Up), New Items, Favorites
Search your library directly from the Library Card using Search Bar
Interact with library card (posters) using actions: Open in Jellyfin, Cast to Chromecast, Watch Trailer, More Information, No Action
Stream and control Chromecast playback directly from library card/poster with controls to Pause, Unpause, Stop, Rewind

Now-Playind Card

Display what you’re currently watching in a nice visual way with poster image, background image and progress bar
Use card controls to Pause, Unpause, Stop, Rewind

Services & Sensors

Use Services for controlling Jellyfin playback and library updates
Use Services within Automations to search library, update items, get recommendations, and more
Leverage Sensors as trigger actions to build awesome Automations

…

For more information go here: GitHub - zupancicmarko/JellyHA: Jellyfin Custom Integration for Home Assistant

I’d love for people to try it out and let me know what you think.

Disclaimer: I don’t have a huge library, so not sure how it will perfrom for users with thousands of items in their Jellyfin library.

If you run into any issues or have suggestions for improvements, feel free to open an issue on GitHub or drop a comment here. I’m open to feedback and happy to work on making it better.

Thanks again to everyone who contributes to making Home Assistant such a great platform.

SamJongenelen · January 31, 2026, 11:25pm

Love it. I would only use it to check what my users are playing and how much mbps they are consuming. Would that (kinda like jellfyin addon playback reporting) be possible too?

stevemann · February 1, 2026, 12:30am

Since I just installed Jellyfin, this sounds like a good addition to my Home Assistant.
But, Step 1 is already out of date.
HACS → Integrations → Custom repositories …no longer exists.
It is now in the three-dot menu at the top of the HACS page.

After adding the repository, click on “save”, and JellyHA is not found. After restarting Home Assistant, the custom repository is missing.

Manual install works, but the provided instructions are vague.

Nonetheless, I was unable to get the integration to connect to my Jellyfin server. I tried for the url: 192.168.1.64 and 192.168.1.6:8096. I tried using my login name and password and I tried creating an API key in Jellyfin. Nothing worked.

Any ideas?

smartpodgurc · February 1, 2026, 10:22pm

Thanks for your interest in this. I’ve updated the three-dot menu in readme. Not sure why it wouldn’t show you the JellyHA in HACS after adding the repository to the Custom Repositories. I’ve tried on 2 different installations of Home Assistant, worked no issues. Are you using the latest version of HACS?

Regarding the connection, did you add the http:// in front of your IP:Port?

Or you can as well use something like https://jellyfin.example.com if you have a subdomain set up for it.

smartpodgurc · February 1, 2026, 10:25pm

Hey, I’ll look into it.

stevemann · February 2, 2026, 2:57am

It worked with the full URL. This is the first integration that needed a full URL. I.E., no defaults.

jdenman03 · February 2, 2026, 6:59pm

Mine keeps failing on Initializing. I can see the server, see my users etc. But it just fails to initialize. I chose the user/password instead of the API key. Do I need the API key?

jdenman03 · February 2, 2026, 7:02pm

Disregard. Deleted it and then tried again, but this time I selected all of my libraries instead of just some and it works just fine.

smartpodgurc · February 2, 2026, 8:29pm

Thanks for input. Will update the wizard to auto-add it if missing.

vedno_lacni · February 15, 2026, 9:11pm

is it possible to make something like this for plex?? i just deployed jellyfin to try it and its really good!!

NutBall · February 17, 2026, 4:02pm

Is there a way to increase or turn off the Library Refresh Interval? I have it maxed out (3600 seconds-1 hour), but once a day/week, or a way to trigger it when needed.

smartpodgurc · February 17, 2026, 4:47pm

Hey, not using Plex and not planning to. So this integration will be Jellyfin focused only. I’m sure you’re going to love Jellyfin. It’s a great product.

smartpodgurc · February 17, 2026, 4:48pm

Sure, I’ll update that part. Out of curiosity, what’s your Library size? How many items do you have?

NutBall · February 17, 2026, 6:52pm

It is a small library, 2 dozen or so movies and about 10 or so series with roughly 12-24 episodes each.
Thank you so much for even considering this! The Home Assistant community rocks!

sascha1 · February 18, 2026, 5:49pm

I mainly use Jellyfin to manage my personal videos, pictures, and music library. The integration does not scan my library or find any media because my libraries in Jellyfin are of the home videos, pictures, and music type.
I also get an error message when I add the Lovelace card “library” that the sensor.jellyha_library does not exist.

My music library contains approximately 1,500 albums and 31,000 songs.

rVlad · February 20, 2026, 1:10am

This is briliant. Let alone the cards, which look beautiful and provide usefull info, this works better than any other Jellyfin integrations I tried so far. Thank you!

smartpodgurc · March 22, 2026, 9:19pm

Hey @NutBall

Thanks for the feedback in a first place.

I’ve revamped the Library Refresh Interval, now with few drop-down options, but as well the ability to turn it off.

If turned off, you can then create an automation with jellyha.refresh_library call and make your own refresh schedule.

Hope this solves your issue.

NutBall · March 25, 2026, 8:16pm

Totally awesome!!! That is fantastic! Thank you so much for doing this!!

RetroButton · March 30, 2026, 5:18pm

Very nice!
I only have one problem.
I cannot add the cards to my dashboard.
The are not available in the card selection.
Even configuring the card manually does not work.

Any ideas?
Clearing the browser cache has not helped too.

smartpodgurc · March 30, 2026, 6:36pm

Hi @RetroButton,

thanks for your interest in JellyHA.

Question - did you do the Step 2 of the installation by adding /jellyha/jellyha-cards.js to the dashboard resources?