Knobby Music Assistant trasforma una manopola Zigbee in telecomando per Home Assistant

Knobby Music Assistant - Una manopola Zigbee economica può diventare un telecomando per Music Assistant in home Assistant grazie a Knobby, un blueprint condiviso nella community del progetto. La soluzione è pensata per il modello ZG-101ZD, venduto anche con marchio Moes, e permette di controllare volume, riproduzione, tracce e preferiti attraverso rotazioni e pressioni. L’autore dichiara di usarla quotidianamente e di averla verificata su Home Assistant 2026.10.4. Il risultato dipende però da requisiti precisi, fra cui Zigbee2MQTT e tre helper da configurare per ogni manopola.

Come funziona Knobby Music Assistant

Il progetto associa le gesture della manopola Zigbee a comandi diretti di Music Assistant, senza richiedere script personalizzati per ogni azione. Ruotando la manopola si regola il volume, con variazioni indicate dall’autore in circa 1 dB per scatto; una pressione avvia o mette in pausa la riproduzione e una doppia pressione passa alla traccia successiva.

La pressione tripla richiama la traccia precedente, mentre tenendo premuto il pulsante si aggiunge il brano ai preferiti di Music Assistant, con una conferma vocale. Sono comportamenti previsti dal blueprint condiviso, non funzioni universali di tutte le manopole Zigbee.

Requisiti e configurazione in Home Assistant

La configurazione descritta richiede una manopola ZG-101ZD basata sul progetto Tuya, commercializzata anche da Moes, Home Assistant 2024.6.0 o successivo, Zigbee2MQTT e Music Assistant. L’autore precisa che ZHA non è utilizzabile con questa soluzione, perché il blueprint si basa sugli eventi MQTT. Il prezzo di circa 4 dollari citato nella discussione si riferisce all’acquisto personale di quattro unità e non costituisce un prezzo attuale garantito.

Per ciascuna manopola occorre creare tre helper: un input_boolean per il blocco della modalità di ricerca nella traccia, un input_datetime che memorizzi obbligatoriamente sia la data sia l’ora, e un input_text per l’orologio interno della posizione di riproduzione. Usare un input_datetime limitato alla sola data compromette, secondo l’autore, il riconoscimento della pressione prolungata.

Il percorso di configurazione indicato consiste nell’importare il blueprint, creare i tre helper seguendo i nomi guidati e selezionare il player Music Assistant, lo speaker e il motore e la voce TTS. Per gli annunci è previsto un motore di sintesi vocale; Piper/Wyoming è citato come opzione per regolarne la velocità. Le conferme passano attraverso Music Assistant, senza un suono introduttivo.

La gestione delle gesture e della posizione del brano

Il punto tecnico più interessante riguarda la distinzione fra pressione prolungata e pressione accompagnata dalla rotazione. La manopola può inviare gli eventi di rotazione prima che sia raggiunta la soglia della pressione lunga: il blueprint usa quindi un meccanismo di blocco e una finestra temporale per stabilire se l’utente intenda cercare un punto nella traccia oppure salvare un preferito.

Un secondo accorgimento risponde al comportamento di alcuni provider di Music Assistant, che possono lasciare fermo il valore di media_position durante la riproduzione. Il blueprint mantiene un proprio riferimento temporale: lo aggiorna quando riceve campioni recenti ed effettua una stima mentre il brano è in riproduzione. In questo modo i comandi di ricerca non dipendono esclusivamente da un dato potenzialmente non aggiornato.

Versioni, aggiornamenti e limiti documentati

Il comportamento della modalità command rimane invariato, secondo le note pubblicate.

Gli aggiornamenti del blueprint non arrivano automaticamente: occorre eseguire nuovamente l’importazione. L’autore specifica che automazione e impostazioni vengono mantenute, ma dopo il passaggio alla v1.4 bisogna selezionare nuovamente il valore della finestra temporale se si proviene da importazioni precedenti. Per segnalare problemi chiede la traccia dell’esecuzione, il testo degli errori dai log e le versioni di Home Assistant, Zigbee2MQTT, Music Assistant e del blueprint. La condivisione descrive un progetto personale testato dall’autore, non una certificazione di compatibilità estesa a tutte le installazioni.