JellyHA - Jellyfin Custom Integration for Home Assistant

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.

5 Likes

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?

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?

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.

Hey, I’ll look into it.

1 Like

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

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?

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.

1 Like

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

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