Kodi w Home Assistant: integracja, sterowanie i automatyzacje z odtwarzaczem multimedialnym

Integracja Kodi z Home Assistant – co daje i jak zacząć

Kodi to odtwarzacz multimedialny, który wiele osób stawia w salonie na małym komputerze albo telewizorze z Android TV. Home Assistant potrafi połączyć się z nim przez oficjalną integrację i wtedy przestajesz traktować pilot od Kodi jako osobne urządzenie. Wszystko trafia do jednego panelu.

Co z tego masz w praktyce? Podgląd stanu odtwarzania, możliwość pauzowania, przewijania i włączania konkretnych plików z poziomu automatyzacji. Do tego dochodzi sterowanie głośnością i wysyłanie poleceń do Kodi z dowolnego miejsca w domu.

Integracja działa lokalnie, bez chmury. Home Assistant łączy się z Kodi przez HTTP API, więc opóźnienia są minimalne, a sterowanie nie zależy od zewnętrznych serwerów. To duża zaleta przy automatyzacjach reagujących na zdarzenia.

Jak zacząć? Kolejność ma znaczenie, bo pominięcie jednego kroku blokuje całość.

• W Kodi włącz opcję zdalnego sterowania w ustawieniach usług i zapisz dane logowania.
• Sprawdź, czy port domyślny nie jest zajęty przez inny proces na tym samym urządzeniu.
• W Home Assistant dodaj integrację Kodi i podaj adres IP oraz port odtwarzacza.
• Nadaj stały adres IP urządzeniu z Kodi, żeby integracja nie traciła połączenia po restarcie routera.
• Po dodaniu sprawdź encję medialną w narzędziach deweloperskich, zanim zbudujesz pierwszą automatyzację.

Najczęstszy problem to zmiana adresu IP po restarcie sieci. Druga pułapka to wyłączone zdalne sterowanie po aktualizacji Kodi, które potrafi się zresetować. Warto więc zapisać konfigurację i sprawdzić ją po każdej większej aktualizacji.

Po poprawnym dodaniu integracji masz gotową bazę do scenariuszy: wyciszenie telewizora przy dzwonku do drzwi, przygaszenie świateł przy starcie filmu albo wstrzymanie odtwarzania, gdy ktoś odbierze telefon w innym pokoju. To dopiero początek.

Konfiguracja integracji Kodi krok po kroku

Integracja Kodi w Home Assistant działa lokalnie i nie wymaga chmury. Wystarczy, że instancja HA widzi odtwarzacz w tej samej sieci. Zanim zaczniesz, włącz w Kodi zdalne sterowanie: wejdź w Ustawienia → Serwisy → Sterowanie i aktywuj opcje HTTP oraz zapytania o zdarzenia. Domyślny port to 8080. Jeśli go zmienisz, zapamiętaj numer, bo będzie potrzebny w konfiguracji.

W Home Assistant przejdź do Ustawienia → Urządzenia i usługi → Dodaj integrację i wybierz Kodi. Podaj adres IP odtwarzacza, port oraz dane logowania, jeśli je ustawiłeś. HA sam wykryje urządzenie w sieci, ale ręczne wpisanie adresu bywa szybsze, zwłaszcza gdy Kodi działa na osobnym VLAN-ie.

Po dodaniu integracji sprawdź, czy encje się pojawiły. Zestaw zależy od wersji Kodi i włączonych funkcji:

Gdy encje są widoczne, warto od razu przetestować sterowanie z poziomu panelu. Kliknij odtwarzacz i sprawdź, czy przyciski reagują. Jeśli nic się nie dzieje, problemem najczęściej jest firewall blokujący port albo wyłączone sterowanie HTTP w Kodi.

Ostatni krok to nadanie przyjaznej nazwy i przypisanie encji do odpowiedniego obszaru. Dzięki temu późniejsze automatyzacje i skrypty będą czytelniejsze. Gdy ktoś ma kilka odtwarzaczy w domu, konsekwentne nazewnictwo oszczędza sporo czasu przy budowie scenariuszy.

Sterowanie odtwarzaczem Kodi z poziomu Home Assistant

Po dodaniu integracji Kodi pojawia się w Home Assistant jako encja media_player. To wystarczy, żeby sterować odtwarzaniem bez sięgania po pilota. Na karcie encji dostępne są przyciski play, pauza, stop, przewijanie oraz regulacja głośności. Kodi reaguje na te polecenia w czasie rzeczywistym.

Sterowanie nie ogranicza się do samego odtwarzania. Encja udostępnia też listę źródeł wejściowych, więc można przełączać się między biblioteką filmów, muzyką, dodatkami czy telewizją, jeśli jest skonfigurowana. Z panelu HA wybierzesz konkretny utwór albo film z biblioteki, o ile integracja ma włączoną obsługę wyszukiwania i biblioteki multimediów.

Największą wartość daje sterowanie przez usługi w automatyzacjach i skryptach. Poniżej zestawienie najczęściej używanych wywołań:

Encja zwraca też stan odtwarzania: playing, paused, idle, off. Ten stan można wykorzystać jako warunek w automatyzacjach, na przykład do przygaszenia świateł, gdy film startuje. Wywołania usług działają zarówno z poziomu interfejsu, jak i z Node-RED czy własnych skryptów YAML.

Automatyzacje z Kodi – scenariusze i gotowe przykłady

Integracja Kodi z Home Assistant daje najwięcej, gdy odtwarzacz przestaje być osobnym urządzeniem, a staje się elementem scen. Encje media_player wystawiają stan odtwarzania, więc automatyzacja może reagować na pauzę, zatrzymanie czy zmianę utworu. Wyzwalacze buduje się na atrybutach: media_content_type, app_name lub media_title. Wystarczy jeden warunek, by rozróżnić film od muzyki.

Najprostszy scenariusz to przygaszenie świateł po starcie filmu. Wyzwalacz: zmiana stanu odtwarzacza na playing przy typie treści video. Akcja: scena oświetlenia z obniżoną jasnością. Drugi wariant działa w drugą stronę. Pauza lub stop przywraca światło do poziomu sprzed seansu, a po dłuższej bezczynności wyłącza odtwarzacz i amplituner.

Trzeci schemat dotyczy sterowania głosem przez asystenta. Komenda „zagraj film” może uruchomić Kodi, przełączyć wejście amplitunera i ustawić scenę świetlną w jednej automatyzacji. Warto dodać warunek sprawdzający, czy odtwarzacz jest dostępny, bo przy wyłączonym sprzęcie akcja zakończy się błędem.

• Ustaw krótkie opóźnienie w akcjach świetlnych, żeby uniknąć migotania przy szybkich zmianach stanu.
• Rozróżniaj treści po atrybucie media_content_type, a nie po tytule utworu.
• Dodaj warunek na stan encji, zanim wyślesz komendę do amplitunera lub TV.
• Testuj automatyzacje w trybie single, żeby kolejne wyzwolenia nie nakładały się na siebie.
• Loguj wyzwalacze przez logbook, gdy scena nie reaguje zgodnie z oczekiwaniem.

Kolejny poziom to reakcja na zawartość. Gdy odtwarzany jest serial, automatyzacja może przyciemnić światło mocniej niż przy muzyce, a przy audiobooku wyłączyć ekran TV. Wszystko opiera się na tych samych encjach, różnica tkwi w warunkach.

Zaawansowane zastosowania: skrypty, sensory i powiadomienia

Integracja Kodi z Home Assistant daje dopiero pełny efekt, gdy wyjdziesz poza prosty pilot. Skrypty pozwalają połączyć odtwarzacz z resztą domu w jedna sekwencję. Sensor szablonowy potrafi za to wyciągnąć z Kodi informacje, których standardowe encje nie pokazują.

Pierwszy krok to skrypt wywołujący usługę media_player z konkretnymi parametrami. Zamiast za każdym razem klikać po interfejsie, zapisujesz całą akcję jako jedną encję script. Wywołujesz ją przyciskiem, automatyzacją albo asystentem głosowym.

• Skrypt uruchamiający odtwarzanie playlisty o stałej godzinie w wybranym pomieszczeniu.
• Skrypt przełączający wejście amplitunera na Kodi i przyciszający resztę stref.
• Skrypt pauzujący odtwarzanie, gdy dzwonek do drzwi zostanie aktywowany.
• Skrypt wyłączający Kodi i telewizor po zakończeniu seansu z opóźnieniem.
• Skrypt restartujący usługę Kodi przez API, gdy odtwarzacz przestanie odpowiadać.

Drugi filar to sensory szablonowe. Standardowa encja media_player podaje tytuł i stan odtwarzania. Sensor oparty na atrybutach potrafi wyłuskać nazwę odtwarzanego pliku, typ mediów albo informację, czy odtwarzanie trwa dłużej niż określony czas. Takie dane stają się wyzwalaczem dla automatyzacji.

Powiadomienia domykają całość. Gdy Kodi zaczyna odtwarzać film w salonie, możesz wyciszyć powiadomienia na telefonie albo przyciemnić światło w korytarzu. Warunek opierasz na stanie encji i atrybucie media_content_type. To prostsze niż się wydaje, a efekt odczuwalny od razu.

Moje podejście jest takie: sensory szablonowe zamiast automatyzacji opartych na stanie, bo stan bywa chwilowy i potrafi wywołać fałszywy trigger przy każdej zmianie. Sensor z filtrem czasu eliminuje ten problem u źródła.

Nie wszystko trzeba robić od razu. Zacznij od jednego skryptu i jednego sensora. Reszta przyjdzie sama.

Najczęściej zadawane pytania (FAQ)

Poniższe odpowiedzi dotyczą najczęstszych wątpliwości przy konfiguracji integracji Kodi w Home Assistant. Każde pytanie odnosi się do typowych sytuacji, z którymi spotykają się osoby stawiające pierwsze kroki z odtwarzaczem multimedialnym w automatyce domowej.

Czy integracja Kodi wymaga włączonego serwera HTTP w ustawieniach odtwarzacza? Tak. Home Assistant komunikuje się z Kodi przez interfejs sieciowy, dlatego w opcjach usług zdalnych trzeba włączyć serwer HTTP i ustawić port. Bez tego integracja nie nawiąże połączenia.

Dlaczego encje multimedialne pozostają niedostępne po restarcie? Najczęściej powodem jest zmiana adresu IP urządzenia lub wyłączony serwer HTTP po aktualizacji Kodi. Warto przypisać odtwarzaczowi stały adres w routerze i sprawdzić, czy port nie został zablokowany przez firewall.

Czy można sterować Kodi z automatyzacji? Tak, przez usługi media_player, które pozwalają odtwarzać, pauzować, zmieniać głośność i uruchamiać konkretne utwory. Wyzwalacze oparte na stanie odtwarzacza świetnie sprawdzają się przy scenach światła dopasowanych do filmu.

Jakie protokoły sieciowe są potrzebne? Integracja korzysta z HTTP do sterowania i nasłuchiwania zdarzeń. Oba muszą być dostępne w tej samej sieci co Home Assistant, chyba że stosujesz tunelowanie.