--- title: "JellyHA" description: "JellyHA is a Marketplace integration for Home Assistant. It has 776 installs sharing analytics, works locally and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/zupancicmarko-jellyha" url: "https://vulpo.app/integrations/marketplace/zupancicmarko-jellyha.md" last-updated: "2026-10-26" version: "1.4" --- # JellyHA > JellyHA is a Marketplace integration for Home Assistant. It has 776 installs sharing analytics, works locally and was last updated October 25, 2026. JellyHA is a Jellyfin integration that connects Home Assistant to a Jellyfin server over the local network. It adds a library browser in the media browser and media players per user and per client device, with playback controls such as play, pause, seek and shuffle. Sensors cover libraries, favorites, unwatched items, Live TV channels, active sessions, server version and WebSocket status. Actions can play music, playlists and Live TV channels, cast an item to a Chromecast, refresh the library, delete an item, and fetch playlists or collections. Several servers can run side by side using an instance label, and sign-in works with a username and password or an API key. Setup is done in the UI, and the integration comes with two dashboard cards. Automatic summary of the README and code of zupancicmarko/JellyHA. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=zupancicmarko&repository=JellyHA&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=zupancicmarko&repository=JellyHA&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect to Jellyfin - **Server URL**: Full URL to your Jellyfin server (e.g., http://192.168.1.100:8096) - **External URL (Optional, for UI links)** - **Authentication Method** ### API Key Authentication - **API Key**: API key from Jellyfin Dashboard → API Keys ### Jellyfin Login - **Username** - **Password** ### Select User - **User** ### Select Libraries - **Libraries** - **Library Refresh Interval** ### Select Client Devices - **Client Devices** ### Configure Instance - **Instance Label**: This integration supports Multi-Instance configurations. Add a label to distinguish this instance (e.g., \*Movies\*, \*Music\*, \*Server01\*, \*Server02\*). Your device will be named 'JellyHA Movies', 'JellyHA Music', 'JellyHA Server01', 'JellyHA Server02', etc., making it easier to identify entities across multiple servers or libraries. Leave empty for the default 'JellyHA'. ### Re-authenticate Jellyfin - **Server URL**: Full URL to your Jellyfin server (e.g., http://192.168.1.100:8096) - **Authentication Method** ### After setup - **Server URL** - **External URL (Optional, for UI links)** - **Libraries** - **Library Refresh Interval** - **Client/Device Media Players (Optional)**: Select client devices (e.g. Smart TVs, Android TV boxes) to create dedicated media player entities for. These maintain state and attributes per device regardless of which user is watching. - **Refresh fetched data immediately** - **Update Credentials / Switch User** - **Enable Live TV**: Enable Live TV channels, dedicated services, and Media Browser tuning. - **API Request Timeout (seconds)**: Maximum timeout in seconds for requests to Jellyfin. Increase this (e.g. 45-60s) for very large libraries or slower server hardware. - **Method** - **API Key** - **Username** - **Password** - **User** - **Libraries** Texts from the code of [zupancicmarko/JellyHA](https://github.com/zupancicmarko/JellyHA). ## Entities - **Media**: Library Browser - **Sensors**: Library, Live TV Channels, Favorites, Unwatched, Unwatched Movies, Unwatched Series, Unwatched Episodes, Last Refresh, Last Library Update, WebSocket Status, Jellyfin Version, Active Sessions, and 17 more ## Actions - **Play on Chromecast**: Play a Jellyfin item on a Chromecast device Fields: Media Player, Item ID, Use Series Poster, Subtitle Mode, Subtitle Languages - **Refresh Library**: Force refresh library data from Jellyfin - **Delete Item**: Delete an item from Jellyfin library Fields: Item ID - **Get Live TV Channels**: Retrieve available Jellyfin Live TV channels with optional search filtering. Fields: Search Query, Limit - **Play Live TV Channel**: Resolve a Live TV channel by number or normalized name and play it. Fields: Channel Number, Channel Name - **Music Search**: Search Jellyfin music library for tracks, albums, or artists with FLAC and Hi-Res audio specifications. Fields: Search Query, Search Type, Artist, Album, Genre, Year, Audio Codec / Format, Hi-Res Audio Only, Lossless Audio Only, Limit - **Play Music**: Search and play a music track or album from Jellyfin on any Home Assistant media player (e.g. Kitchen Speaker, Sonos, Cast). Fields: Media Player, Search Query / Song Title, Artist, Album - **Play Playlist**: Play a playlist from Jellyfin on any Home Assistant media player or directly on a Jellyfin client session, with optional shuffle. Fields: Media Player, Playlist Name or ID, Shuffle - **Get Playlists**: Fetch all user playlists from Jellyfin with track count, duration, and thumbnail to response\_variable. Fields: Query, Limit - **Get Collections**: Fetch all BoxSets / Movie Collections from Jellyfin with item count and contained movies to response\_variable. Fields: Query, Limit, Include Items ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > - 🎬 Display movies and TV shows from your library > - ▶️ In-Dashboard Browser Playback: Stream media directly within your Home Assistant dashboards with native Closed Captions (CC) and subtitle track support > - 📱 Native Jellyfin Client Remote Control: 1-tap playback to official Jellyfin apps (Android TV, Google TV, Fire TV, Web, etc.) via native session control without Chromecast transcoding overhead > - 🎯 Configurable Play Actions: Instant Browser playback, Native Jellyfin Client playback, Chromecast casting, or custom scripts in More Info > - 📺 Cast media directly to Chromecast (Gen 1 supported) > - 📡 Live TV Support: Visual channel browsing in Media Browser > - 🎵 Music Support > - 📂 Full integration with Home Assistant Media Browser > - ⏯️ Full playback control: Play, Pause, Stop, Seek, Next/Previous Track, Shuffle, Repeat > - 🎮 Per-user media players with transport and volume controls > - 📺 Dedicated per-device media players with custom Jellyfin nicknames > - 🌈 Real-time Dynamic Range detection: Reporting of SDR, HDR10, HDR10+, Dolby Vision, and HLG From the README of [zupancicmarko/JellyHA](https://github.com/zupancicmarko/JellyHA#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Media and entertainment](https://vulpo.app/integrations/category/media-and-entertainment.md) - Number: 776 installs sharing analytics; 84 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.7.1, last updated October 25, 2026 - Domain: `jellyha` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/b507638e8948d560.webp (from zupancicmarko/JellyHA's README) - Screenshot: https://vulpo.app/integrations-img/1a6c474a66b23ed9.webp (from zupancicmarko/JellyHA's README) - Screenshot: https://vulpo.app/integrations-img/7fdf40624885fd98.webp (from zupancicmarko/JellyHA's README) In Vulpo: Media Player card, Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-26. Source: https://vulpo.app/integrations/marketplace/zupancicmarko-jellyha --- - HTML version of this page: https://vulpo.app/integrations/marketplace/zupancicmarko-jellyha - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml