Přeskočit na hlavní obsah

Music Assistant - Komplexní hudební server pro chytrou domácnost

Music Assistant je moderní, otevřený hudební server, který transformuje váš Home Assistant do plnohodnotného hudebního centra. Pokud jste někdy snili o tom, že budete mít všechny své hudební zdroje - od Spotify přes Apple Music až po lokální soubory - na jednom místě s možností streamovat je na jakékoli zařízení v domácnosti, pak je Music Assistant přesně to, co hledáte.

Music Assistant Homepage

Co Music Assistant umí

Centralizovaná hudební knihovna

Music Assistant vytváří jednotnou knihovnu ze všech vašich hudebních zdrojů:

  • Streamovací služby: Spotify, Apple Music, Tidal, Deezer, Qobuz, YouTube Music
  • Domácí servery: Plex, Jellyfin, Subsonic
  • Lokální soubory: MP3, FLAC, WAV a další formáty z NAS nebo lokálního úložiště
  • Internet rádio: Radio Browser, TuneIn
  • Podcasty: iTunes Podcast Search, RSS feedy, gPodder, Audiobookshelf

Music Assistant Homepage

Inteligentní propojení skladeb

Když máte stejnou skladbu na Spotify i v lokálních souborech, Music Assistant je automaticky propojí. To znamená, že můžete vytvořit playlist a Music Assistant vybere nejlepší zdroj pro přehrávání podle dostupnosti a kvality.

Široká podpora přehrávačů

Music Assistant umí streamovat na prakticky jakékoli moderní a chytré audio zařízení:

  • AirPlay - Apple HomePod, AirPlay reproduktory
  • Google Cast - Chromecast Audio, Google Nest reproduktory
  • Sonos - celá rodina Sonos reproduktorů
  • DLNA - většina síťových přehrávačů
  • Snapcast - multi-room audio s perfektní synchronizací
  • Home Assistant media players - integrace s HA přehrávači
  • A mnoho dalších - Alexa, Bluesound, MusicCast, Squeezelite

Pokročilé audio funkce

Music Assistant poskytuje funkce, které oceníte při každodenním poslechu:

  • Gapless playback - plynulé přehrávání bez mezer mezi skladbami
  • Crossfade - prolínání skladeb pro DJ efekt
  • Normalizace hlasitosti - konzistentní hlasitost napříč skladbami
  • DSP filtry - ekvalizér a tone controls pro doladění zvuku
  • Synchronizace přehrávání - perfektně synchronizované multi-room audio
  • Přenos fronty mezi přehrávači - přesuňte přehrávání z jedné místnosti do druhé

Integrace s Home Assistant

Music Assistant se dokonale integruje s Home Assistant:

  • Automatizace - spouštějte hudbu na základě událostí
  • Oznámení - během přehrávání můžete přerušit hudbu pro oznámení
  • Hlasové ovládání - ovládejte hudbu hlasem přes HA voice assistant
  • Dashboardy - přidejte ovládání hudby do svých dashboardů
  • Scény - zahrajte konkrétní hudbu jako součást scény

Instalace

Music Assistant se instaluje jako addon do Home Assistant, což činí instalaci velmi jednoduchou.

Předpoklady

Před instalací se ujistěte, že:

  • Máte Home Assistant nainstalovaný ve verzi HassOS nebo Supervised
  • Máte dostatečný výpočetní výkon - doporučuji minimálně Raspberry Pi 4 (4GB RAM)
  • Máte stabilní síťové připojení pro streamování
Výkon zařízení

Music Assistant je náročnější na výkon než běžné addony. Na Raspberry Pi 3 může být provoz pomalejší, zejména při používání více streamovacích služeb současně.

Postup instalace

  1. V Home Assistantu přejděte do Nastavení → Doplňky → Obchod s doplňky

  2. Klikněte na tři tečky v pravém horním rohu a vyberte Repozitáře

  3. Přidejte Music Assistant repositář:

    https://github.com/music-assistant/home-assistant-addon
  4. Po obnovení stránky najdete v seznamu Music Assistant

  5. Klikněte na addon a poté na tlačítko NAINSTALOVAT

  6. Instalace může trvat několik minut - addon je poměrně velký

Rychlejší cesta

Můžete použít tento přímý odkaz pro přidání repositáře:

Music Assistant Add-on

Music Assistant Installed

První spuštění

Po instalaci:

  1. Zapněte možnost Spustit při startu - Music Assistant by měl běžet neustále
  2. Zapněte Přidat do postranního panelu - pro rychlý přístup k rozhraní
  3. Klikněte na SPUSTIT

První spuštění může trvat déle, protože addon musí stáhnout a nainstalovat všechny závislosti.

Základní konfigurace

Po prvním spuštění se otevře webové rozhraní Music Assistant, kde provedeme základní nastavení.

Přidání hudebních zdrojů

První krok je přidání vašich hudebních zdrojů:

  1. V rozhraní Music Assistant přejděte do Settings → Music Providers

  2. Klikněte na Add Provider a vyberte svou službu

  3. Pro streamovací služby (Spotify, Apple Music, atd.):

    • Klikněte na provider
    • Budete přesměrováni na přihlašovací stránku služby
    • Po autorizaci se vrátíte zpět do Music Assistant
    • Obecně si doporučuji přečíst na dokumentaci jak přidat konkrétní službu, jelikož se bude postup velmi často výrazně lišit.

Music Assistant Add Spotify

  1. Pro lokální soubory:
    • Vyberte Filesystem
    • Zadejte cestu k vašim souborům (např. /media nebo /share)
    • Music Assistant začne skenovat a indexovat soubory
Tip pro lokální soubory

Pokud máte hudbu na NAS, můžete ji nejprve namountovat do Home Assistant pomocí SMB/NFS addon a poté přidat cestu do Music Assistant.

Přidání přehrávačů

Music Assistant automaticky detekuje většinu přehrávačů ve vaší síti:

  1. Přejděte do Settings → Player Providers

  2. Aktivujte provider pro vaše zařízení:

    • Google Cast - pro Chromecast a Google Nest
    • AirPlay - pro Apple zařízení
    • Sonos - pro Sonos reproduktory
    • DLNA - pro obecné síťové přehrávače
    • Home Assistant - pro přehrávače v HA
  3. Po aktivaci provideru se přehrávače objeví v seznamu Players

Integrace s Home Assistant

Pro plnou integraci s Home Assistant je potřeba nainstalovat ještě integraci:

  1. V Home Assistant přejděte do Nastavení → Zařízení a služby

  2. Klikněte na Přidat integraci a vyhledejte Music Assistant

  3. Integrace by měla automaticky detekovat běžící server

  4. Po přidání se vytvoří entity pro každý přehrávač Music Assistant

Music Assistant HA Integration

Proč dvě části?

Music Assistant má dvě komponenty:

  • Addon - samotný hudební server, který spravuje knihovnu a streamování
  • Integrace - propojení mezi serverem a Home Assistant pro automatizace

Použití v automatizacích

Zde je místo, kde se ukážou skutečné možnosti Music Assistant v kombinaci s Home Assistant. Music Assistant přidává všechny své přehrávače jako media_player entity, které můžete plně využít v automatizacích.

Základní příklady automatizací

Ranní buzení s hudbou:

automation:
- alias: "Ranní probuzení hudbou"
trigger:
- platform: time
at: "07:00:00"
action:
- service: media_player.volume_set
target:
entity_id: media_player.obyvak
data:
volume_level: 0.15
- service: media_player.media_play
target:
entity_id: media_player.obyvak

Spuštění hudby při příchodu domů:

automation:
- alias: "Hudba při příchodu"
trigger:
- platform: state
entity_id: person.jmeno
to: 'home'
condition:
- condition: time
after: '18:00:00'
before: '22:00:00'
action:
- service: media_player.media_play
target:
entity_id: media_player.obyvak

Pozastavení hudby při telefonu:

automation:
- alias: "Pauza při telefonu"
trigger:
- platform: state
entity_id: sensor.telefon_stav
to: 'ringing'
action:
- service: media_player.media_pause
target:
entity_id: media_player.obyvak

Pokročilé ovládání

Music Assistant entity podporují všechny standardní media_player služby:

  • media_player.media_play - Přehrávání
  • media_player.media_pause - Pauza
  • media_player.media_stop - Stop
  • media_player.media_next_track - Další skladba
  • media_player.media_previous_track - Předchozí skladba
  • media_player.volume_set - Nastavení hlasitosti
  • media_player.volume_up / volume_down - Zvýšení/snížení hlasitosti
  • media_player.play_media - Přehrání konkrétního média
Přehrávání konkrétního obsahu

Pro přehrání konkrétní skladby, alba, playlistu nebo rádia můžete použít standardní službu media_player.play_media nebo pokročilejší music_assistant.play_media.

Základní použití s media_player.play_media:

service: media_player.play_media
target:
entity_id: media_player.obyvak
data:
media_content_type: music
media_content_id: "Queen" # Jméno umělce, alba nebo skladby

Music Assistant podporuje různé formáty media_content_id:

  • Jméno: Queen nebo Queen - Innuendo
  • Streaming URI: spotify://artist/12345 nebo spotify://playlist/xyz
  • Streaming URL: https://open.spotify.com/track/...
  • Library URI: library://track/123, library://album/456, library://playlist/789, library://radio/3

Pokročilé použití s music_assistant.play_media:

Pro větší kontrolu nad přehrává můžete použít speciální Music Assistant službu:

service: music_assistant.play_media
target:
entity_id: media_player.obyvak
data:
media_id: "Innuendo"
media_type: album
artist: "Queen" # Filtrování podle umělce
enqueue: replace # play, replace, next, replace_next, add
radio_mode: true # Automaticky generovat podobné skladby

Parametr enqueue určuje, jak se má obsah přidat do fronty:

  • play - Přehrát nyní
  • replace - Nahradit celou frontu a přehrát
  • next - Přidat jako další do fronty
  • replace_next - Nahradit vše po aktuální skladbě
  • add - Přidat na konec fronty

Radio mode automaticky vytvoří playlist podobných skladeb na základě výběru.

Pokročilé funkce

Skupiny přehrávačů (Multi-room audio)

Music Assistant umožňuje vytvářet skupiny přehrávačů pro synchronizované přehrávání:

  1. V rozhraní klikněte na přehrávač
  2. Vyberte Group with a zvolte další přehrávače
  3. Hudba se bude přehrávat synchronizovaně na všech zařízeních
Perfektní synchronizace

Pro nejlepší synchronizaci doporučuji použít Snapcast provider, který zajišťuje sub-milisekundovou synchronizaci.

Oznámení během přehrávání

Music Assistant umí pozastavit hudbu, přehrát oznámení a poté pokračovat:

service: music_assistant.play_announcement
target:
entity_id: media_player.obyvak
data:
url: "https://www.example.com/doorbell.mp3"
announce_volume: 60
Parametry oznámení

Můžete také použít parametr use_pre_announce: true pro přehrání zvuku před oznámením, aby upozornil posluchače.

Přenos fronty mezi přehrávači

Můžete přesunout přehrávání z jedné místnosti do druhé bez přerušení:

service: music_assistant.transfer_queue
target:
entity_id: media_player.kuchyn # Cílový přehrávač
data:
source_player: media_player.obyvak # Zdrojový přehrávač
auto_play: true # Automaticky spustit přehrávání

Tipy a triky

Použití s Spotify Connect

Pokud máte Spotify Premium, můžete nainstalovat Spotify Connect plugin, který umožní ovládat Music Assistant přímo ze Spotify aplikace.

Scrobbling do Last.fm

Music Assistant podporuje odesílání historie poslechu do Last.fm:

  1. Nainstalujte Last.fm Scrobbler plugin
  2. Připojte svůj Last.fm účet
  3. Veškerá přehraná hudba se automaticky zaznamenává

Optimalizace výkonu

Pokud Music Assistant běží pomalu:

  • Snižte počet aktivních music providers
  • Vypněte automatickou synchronizaci pro velké knihovny
  • Zvažte použití externí databáze (PostgreSQL)

Alternativy a srovnání

FunkceMusic AssistantVolumioMopidyPlex
Vícero zdrojů
Integrace s HAČástečněČástečně
Gapless playback
Multi-room sync✅ (Snapcast)
Webové UI
ZdarmaČástečněČástečně
Snadná instalace

Shrnutí

Music Assistant je skutečně impresivní projekt, který přináší do Home Assistant profesionální hudební funkcionalitu.

Co se mi líbí:

  • Jednotná knihovna ze všech zdrojů
  • Automatické propojování skladeb
  • Výborná integrace s Home Assistant
  • Pokročilé audio funkce (gapless, crossfade)
  • Aktivní vývoj a komunita

Co by mohlo být lepší:

  • Vyžaduje výkonnější hardware
  • Občasné problémy s některými streamovacími službami
  • Dokumentace stále není úplně kompletní
  • První nastavení může být pro začátečníky složitější a přidávání některých zdrojů je opravdu složité

Pokud máte Home Assistant a chcete mít dokonalou kontrolu nad hudbou v celé domácnosti, Music Assistant je jasná volba.

Komentáře