Integrace RichPear Home

cmus

cmus přidá do RichPear Home ovládání lokálního nebo vzdáleného hudebního přehrávače cmus jako přehrávač médií.

Doména: cmus
Kategorie: přehrávače médií
Komunikace: lokální dotazování
Nastavení: configuration.yaml
Výstup: přehrávač médií cmus

Co integrace přidá

Integrace vytvoří jednu entitu přehrávače médií pro cmus. Přes ni lze spustit a pozastavit přehrávání, přejít na další nebo předchozí stopu, nastavit hlasitost, přehrát soubor nebo playlist a posunout pozici ve skladbě.

Stav přehrávače se čte lokálním dotazováním z cmus socketu. RichPear Home zobrazuje dostupné informace o aktuální stopě, například název, interpreta, album, délku, soubor a hlasitost, pokud je cmus poskytne.

Lokální nastavení nepotřebuje host ani heslo. Vzdálený cmus musí být nastavený pro vzdálené připojení a musí mít heslo.

Kontrolní témata

Ruční zápis do konfigurace
Lokální nebo vzdálený cmus socket
Port, výchozí hodnota 3000
Heslo pro vzdálené připojení

Příprava před přidáním

Nejdřív ověřte, že cmus na cílovém počítači běží a lze ho ovládat mimo RichPear Home. U vzdáleného přehrávače nastavte cmus tak, aby poslouchal na síti, měl heslo a firewall propouštěl použitý port.

Připravte si název hostitele nebo IP adresu stroje s cmus, heslo pro cmus a port. Pokud port neuvedete, použije se 3000.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Vzdálený cmus nepřipojujte bez hesla. Pokud přehrávač běží na jiném stroji, použijte stabilní IP adresu nebo DNS jméno.

Nastavení v RichPear Home

Tato integrace se nepřidává průvodcem. Upravte configuration.yaml, uložte změny a restartujte RichPear Home.

media_player:
  - platform: cmus

Pro vzdálený cmus doplňte host a heslo. Port uvádějte jen tehdy, pokud nepoužíváte výchozí 3000.

media_player:
  - platform: cmus
    host: IP_ADRESA_NEBO_HOSTNAME
    password: HESLO_CMUS
    port: 3000
    name: cmus

Po restartu otevřete Nastavení → Zařízení a služby a zkontrolujte kartu integrace. Entity najdete také na kartě entit.

Kontrola entit a funkcí

Otevřete vytvořený přehrávač médií a ověřte stav přehrávání, pauzu, pokračování, změnu hlasitosti a přechod na další nebo předchozí skladbu.

Pokud používáte akci pro přehrání média, používejte typ média hudba nebo playlist. U jiného typu média integrace příkaz odmítne.

Po nastavení

Ověřte připojení po restartu RichPear Home.
Zkontrolujte aktuální skladbu a hlasitost.
Vyzkoušejte základní ovládací prvky.
Pojmenujte entitu podle místnosti nebo přehrávače.

Použití v automatizacích

Automatizace používejte hlavně pro spuštění hudby, pozastavení při odchodu, noční ztišení nebo přepnutí playlistu podle režimu domácnosti.

U vzdáleného přehrávače počítejte s tím, že výpadek počítače, cmus procesu nebo síťového portu způsobí nedostupnost entity. Před automatizací nejdřív ručně otestujte chování při nedostupném přehrávači.

Provoz a údržba

Po změně IP adresy, portu, hesla nebo názvu entity upravte configuration.yaml, restartujte RichPear Home a zkontrolujte dashboardy i automatizace, které přehrávač používají.

U vzdáleného cmus držte stabilní adresu stroje a jasně dokumentované heslo. Pokud cmus běží jen občas, navrhněte dashboard tak, aby nedostupnost přehrávače nebyla matoucí.

Řešení problémů

Když entita nevznikne, zkontrolujte odsazení v configuration.yaml, restart a logy v Nastavení → Systém → Logy podle domény cmus.

Když se přehrávač nepřipojí, ověřte, že cmus běží, poslouchá na správném portu, heslo je správné a firewall neblokuje spojení. Chyba hesla se v logu projeví odmítnutím hesla ze strany cmus.