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.

Setup openen Support

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.

macOS client wordt via mDNS gezien, maar niet automatisch ingevuld

Home Assistant gebruikt de geadverteerde local_url om de macOS client via HTTP te lezen.

Test vanaf de Home Assistant host of een ander LAN-apparaat, niet alleen vanaf dezelfde Mac.
curl -i http://<mac-lan-ip>:<port>/api/device/pairing-info
curl -i http://<mac-lan-ip>:<port>/api/device/info
Verwacht HTTP 200 met JSON. Bij Connection reset by peer blokkeert vaak de macOS firewall of beveiligingssoftware.
Sta inkomende lokale netwerkverbindingen toe voor DJConnect.app in macOS firewall, ESET, Little Snitch of LuLu.
Gebruik bij voorkeur een applicatie-gebaseerde allow-rule. Alleen een vaste poort toestaan is kwetsbaar, omdat de lokale API-poort kan wisselen na herstart.
DJConnect vraagt geen automatische firewall-exclusions aan; jij houdt controle over firewall en security-software.

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

Spotify playback gebruikt je Spotify Premium account en Spotify Connect devices.

Controleer of Spotify Premium actief is.
Open Spotify en controleer of de gewenste Connect speaker beschikbaar is.
Autoriseer Spotify opnieuw als tokens of scopes zijn gewijzigd.
Playback-control opdrachten zoals Stop muziek voeren direct backend commands uit.

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.