Kodi
kodi
The Kodi integration allows you to control a Kodi multimedia system from Home Assistant.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
media_player | Media player (as switches) | Only TVs and receivers get a TV tile; other players show as power and play switches; Needs its own HomeKit Bridge in accessory mode |
What people report
Kodi players are found by Zeroconf and controlled over JSON-RPC. Very old Kodi 17, artwork on newer Kodi versions and SSL setups caused trouble.
- Works1
- Partly works1
- Not working2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Kodi media player | Works Local | Discovery, media browsing and media source supportedSaved copyBreaking change ## Proposed change <!-- Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or resolves Excerpt saved from GitHub on 2026-10-23. | PR #67203 · 2022-02 | |
| Kodi 20 (Matrix and later) | Partly works | Artwork and posters fail with 500 errors after upgrading from Kodi 18Saved copy… thought there was something in my config before i found this thread. I just get a Status Code: 500 (from service worker) when it tries to get the poster. - Kodi 18.9 is the last version it was working on, tested on Matrix 19.5 and Nexus 20.0 with out any luck - Happens whatever i use normal videolibrary or via plexkodiconnect. - Tested both with local art and with online art, same issue. - Happens in both Edge and Chrome @Shredder5262 Regarding the thumbs, if you go into Kodi settings, library, videos and disable extract thumbnails from videofiles . You wont atleast get the ugly thumbs from … Excerpt saved from GitHub on 2026-10-23. | Issue #84963 · 2023-01 | |
| Kodi 17.3 on CuBox-i | Not working | Discovery sends no UUID, so setup fails on very old KodiSaved copyI got this! In this log i remove kodi and connect again... I’m using kodi 17.3 on cubox-i `2020-09-12 01:44:56 DEBUG (zeroconf-ServiceBrowsergooglecast._tcp.local.-_plugwise._tcp.local.-_viziocast._tcp.local.-_printer._tcp.local.-_hap._tcp.local.-_Volumio._tcp.local.-_daap._tcp.local.-_wled._tcp.local.-_miio._udp.local.-_ipps._tcp.local.-_axis-video._tcp.local.-_elg._tcp.local.-_xbmc-jsonrpc-h._tcp.local.-_nut._tcp.local.-_ipp._tcp.local.-_api._udp.local.-_ssh._tcp.local.-_bond._tcp.local.-_dkapi._tcp.local.-_spotify-connect._tcp.local.-_esphomelib._tcp.local.-_http._tcp.local._306) … Excerpt saved from GitHub on 2026-10-23. | Issue #39874 · 2020-09 | |
| Kodi with SSL/TLS enabled | Not working | Failed to connect when Kodi uses SSL certificateSaved copyThe problem I am trying to add a Kodi instance to my HomeAssistant (HA) setup, but keep getting a "Failed to Connect" error message. My instance of Kodi is set up for SSL/TLS connections - confirmed working from both the Yatse remote control app, via a browser, and by connecting from the HA machine via `openssl s_client -connect media.l33ch.xh:443`. I am able to turn off the `Uses an SSL certificate` option in the Kodi Integration and successfully connect, once I have disabled SSL in the Kodi. Kodi's certificate is signed by a private / local-only network Certificate Authority. I had … Excerpt saved from GitHub on 2026-10-23. | Issue #110975 · 2024-02 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 6,900 (0.97%) |
|---|---|
| Added in | Home Assistant pre 0.7 |
| Set up in the UI | Yes |
| Maintainers | @OnFreund |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
