Troubleshooting

Loop je vast? Begin met de melding die het meest lijkt op wat je ziet en controleer de stappen in volgorde.

Snelle checks

  • Home Assistant draait en is bereikbaar via HTTPS als Spotify autorisatie nodig is.
  • DJConnect is na installatie of update opnieuw geladen door Home Assistant.
  • Je gebruikt Spotify Premium en een eigen Spotify Developer app.
  • Client en Home Assistant zitten tijdens pairing op hetzelfde lokale netwerk.

Spotify autorisatie lukt niet

Meestal klopt de redirect URI niet exact met wat Spotify heeft geregistreerd.

  • Controleer de exacte redirect URI in Spotify Developer Dashboard.
  • Gebruik dit pad:/api/djconnect/spotify/callback.
  • Gebruik bij voorkeur je Nabu Casa HTTPS external URL.
  • Wijzigt je Home Assistant external URL? Pas Spotify aan en autoriseer opnieuw.

DJConnect verschijnt niet in HACS

HACS heeft soms een refresh of correcte repository category nodig.

  • Controleer of de custom repository als Integration is toegevoegd.
  • Herlaad HACS of herstart Home Assistant.
  • Zoek op DJConnect en installeer daarna de integratie.
  • Controleer of Home Assistant internettoegang heeft tot GitHub.

Pairing met app of device faalt

Pairing is lokaal en gevoelig voor netwerk, URL en clienttype.

  • Zet Home Assistant en de DJConnect client op hetzelfde lokale netwerk.
  • Controleer of je in Home Assistant het juiste clienttype kiest.
  • Kopieer de pairinggegevens opnieuw als je een oude code gebruikte.
  • Gebruik voor Assist Conversation Agent geen hardware-client of koppelcode.

Waarom kan ik de app niet remote pairen?

Pairing/token bootstrap is lokaal. Remote gebruik begint pas nadat iOS, macOS of Windows lokaal met Home Assistant is gekoppeld.

  • Zet de app en Home Assistant tijdens pairing op hetzelfde lokale netwerk.
  • Gebruik daarna je Nabu Casa of externe HTTPS Home Assistant URL voor remote runtime.
  • Apple/Windows apps hebben geen Client adres naar Home Assistant meer nodig.
  • Apple Watch gebruikt de iPhone als Home Assistant transportproxy.

Voice Assistant reageert niet goed

DJConnect hangt aan je eigen Home Assistant Assist-configuratie.

  • Test eerst of je Assist pipeline STT en TTS los van DJConnect werkt.
  • Controleer of DJConnect als Assist Conversation Agent is gekozen.
  • AI- en Assist-antwoorden kunnen onjuist zijn en hangen af van je eigen configuratie.
  • Gebruik de Spraak-pagina om ondersteunde voorbeeldzinnen te controleren.

Muziek start niet of op de verkeerde speaker

Playback hangt af van je actieve music backend: Spotify Direct of Music Assistant.

  • Bij Spotify Direct: controleer Spotify Premium, Client ID en OAuth/PKCE autorisatie.
  • Bij Music Assistant: controleer of Music Assistant draait, providers werken en de gekozen player beschikbaar is.
  • Recent/top/favorites zijn met Music Assistant capability-dependent en dus niet altijd beschikbaar.
  • Als een oude Play Now actie verloopt, vraag Ask DJ opnieuw; de backend revision of target kan gewijzigd zijn.

Waarom werkt ESP/Pi niet buiten huis?

ESP32 en Raspberry Pi zijn local-only. Alleen iOS, macOS en Windows zijn remote-capable na lokale pairing.

  • ESP32 gebruikt de lokale /api/device/* device API.
  • Raspberry Pi blijft bedoeld als vaste controller in je thuisnetwerk.
  • ESP32-S3-BOX-3 staat niet meer in de supported device lijst.

Downloads, firmware of updates werken niet

Downloads worden via GitHub releases en privacyvriendelijke redirects geladen.

  • Ververs de pagina als een releaseblok tijdelijk leeg blijft.
  • Controleer GitHub als downloads niet live geladen kunnen worden.
  • Herstart Home Assistant na integratie-updates via HACS.
  • Flash ESP32 firmware alleen op ondersteunde devices.

Nog steeds vast? Mail [email protected] met je Home Assistant versie, DJConnect versie, clienttype, foutmelding en welke stap misgaat. Stuur geen wachtwoorden, OAuth tokens of WiFi-wachtwoorden mee.