Fehlerbehebung

Wenn etwas nicht geht, suche unten das Symptom. Die meisten Probleme lösen sich mit einem von drei Schritten, deshalb zuerst die.

Erste Hilfe

1. Schau in die Aktivität. In der Übersicht zeigt die Karte Aktivität jede fehlgeschlagene Aktion als rote Zeile Fehler (action_failed): … mit dem Grund. Die Meldungen sind so geschrieben, dass sie sagen, woran es liegt. Siehe Häufige Meldungen der Plugins.
2. Starte das Backend neu: Einstellungen → Backend & Info → Backend neu starten. Das beendet nur das Hintergrundprogramm und startet es wieder. Belegungen und Einstellungen überleben das.
3. Probiere es im Simulator. Funktioniert eine Belegung dort, liegt es am Gerät, nicht an der Belegung (siehe Simulator).

Hilft das nicht: Einstellungen → Backend & Info → Diagnose kopieren legt eine Zusammenfassung in die Zwischenablage, die du einer Fehlermeldung beilegen kannst. Sie enthält keine Belegungen, Namen, Passwörter oder Token.

Der Master wird nicht erkannt

Anzeige: oben Master getrennt. In Einstellungen → Geräte steht: „Nicht verbunden. Prüf das Kabel am Kommunikationsanschluss - oder starte das Backend neu.“

• Die Software sucht den Master nur beim Start. Hast du ihn danach angesteckt, genügt Backend neu starten (siehe oben).
• Prüfe das Kabel. Es muss ein Datenkabel sein (manche USB-C-Kabel laden nur) und am Kommunikationsanschluss (USB1) stecken, nicht am Anschluss für den Strom.
• Erkannt wird der Master an der Hersteller-Kennung von Espressif, nicht daran, dass er der erste Anschluss wäre. Ein falsch geratener Anschluss wäre schlimmer als keiner.
• Ein anderes Programm hält den Anschluss (ein Terminalprogramm, ein Flash-Werkzeug)? Beende es, dann Backend neu starten. Im Protokoll steht dann „… nicht nutzbar“.
• Ohne Master läuft die Software weiter. Alles außer dem Gerät selbst lässt sich einrichten. Der Master wird ehrlich als getrennt gemeldet, damit niemand den Fehler am Gerät sucht.

Ein Modul erscheint nicht oder tut nichts

• Es steht auf NEU? Dann hast du es noch nicht übernommen. Bis dahin ignoriert das Deck seine Tasten vollständig. Übernehmen in der Karte Neue Module.
• ABGELEHNT? Du hast es in dieser Sitzung abgelehnt. Starte das Backend neu oder stecke es neu an, dann ist es wieder NEU.
• GETRENNT? Der Master meldet es gerade nicht. Prüfe die Verbindung zwischen den Modulen.
• Erscheint es gar nicht, ist die Kette unterbrochen, oder die Firmware des Masters kennt das Modul nicht. Siehe Module und Kette.

Eine Taste tut nichts

Gehe der Reihe nach durch:

1. Ist das Modul AKTIV? (Zustand unter der Zeichnung.) Nicht übernommene Module sind stumm.
2. Ist die Taste belegt? Auf der Seite des Moduls zeigt ein Klick den Dialog mit der Belegung. Ohne Belegung steht dort „Zieh eine Aktion aus der Plugin-Leiste auf eine Taste.“
3. Ist das Plugin aktiviert? Sonst meldet die Aktivität „<Plugin> ist nicht aktiviert. Im Marktplatz lässt es sich einschalten.“
4. Ist das Plugin eingerichtet und verbunden? Der Zustand steht im Marktplatz.
5. Was sagt die Aktivität? Dort steht der Grund.
6. Drückst du im Simulator oder am Gerät? In der Übersicht öffnet ein Klick nur die Seite des Masters oder Moduls. Ausgelöst wird im Simulator und am Gerät.

Auf den Einrichtungsseiten löst ein Klick nie aus. Er öffnet die Belegung zum Ändern.

Eine Kachel leuchtet nicht, oder zeigt das Falsche

• Leuchten können nur Aktionen, die einen Zustand melden. Welche, steht in der Plugin-Referenz bei Passt auf („die Kachel zeigt den Zustand“).
• Das Plugin muss den Zustand kennen: OBS nur mit Verbindung, Discord nur, wenn du über die Verbindung angemeldet bist (nicht bei reinen Tastenkürzeln), Elgato nur, wenn das Licht antwortet. Ohne Auskunft bleibt die Kachel dunkel. Eine falsche Auskunft wäre schlimmer als keine.
• Schaltest du am Programm selbst um (in Windows, am Licht, in OBS), zieht die Kachel nach: bei der Lautstärke nach spätestens fünf Sekunden, beim Elgato-Licht nach spätestens 20 Sekunden, bei OBS sofort, weil OBS es selbst meldet.

Ein Plugin zeigt „getrennt“ oder „nicht eingerichtet“

Anzeige	Was tun
nicht eingerichtet	Einrichten klicken und ausfüllen, siehe die Seite des Plugins
getrennt (OBS)	OBS läuft nicht, oder der WebSocket-Server ist aus, oder Host/Port/Passwort stimmen nicht. Das Plugin versucht es immer wieder (von einer Sekunde bis zu 30 Sekunden Abstand)
getrennt (Discord)	Discord läuft nicht, oder du bist nicht angemeldet: „Discord läuft — noch nicht verbunden“. Mit Discord verbinden
getrennt (Twitch, Elgato, Wetter)	Der Dienst ist nicht erreichbar oder das Token abgelehnt. Die Zeile im Dialog nennt den Grund
bereit, aber nichts passiert	Bei Home Assistant, Hue, Web-Anfrage heißt bereit nur „eingetragen“. Der Grund steht in der Meldung beim Drücken

Das Backend startet nicht

Anzeige: oben Backend getrennt, die Software kommt nicht über die Anmeldeseite hinaus oder wartet auf das Backend („Warte auf das Backend …“).

• Warte einen Moment, der Start dauert ein paar Sekunden.
• Beende die Software vollständig (Infobereich-Symbol → Beenden) und starte sie neu.
• Läuft noch ein zweites Backend (zum Beispiel von einem früheren Start, der nicht sauber endete), kann die Oberfläche einen Zustand zeigen, der zu keinem passt. Beende dann im Task-Manager alle Prozesse MultiverseStreamDeck.exe und MultiverseBackend.exe und starte neu.
• Port 9847 gehört der Software. Belegt ihn ein anderes Programm, kann sich die Oberfläche nicht verbinden.
• Blitzt die Anmeldeseite kurz auf, und das Backend startet scheinbar von selbst neu, kann das Backend abgestürzt sein. Dann hilft die Datei backend-crash.log (siehe Dateien und Ordner): Sie enthält vor einem Absturz in einer nativen Bibliothek die Stapel aller Arbeitsabläufe und eine Zeile je Start. Lege sie einer Fehlermeldung bei.

Die Anmeldung klappt nicht

• „Dieser Build kennt keinen Server (.env)“: Diese Fassung hat keine Serveranbindung. Das ist ein Problem der Fassung, nicht deines Rechners. Nimm eine offizielle Fassung.
• „Anmeldung fehlgeschlagen“: Die Meldung darunter nennt den Grund. Probiere es noch einmal. Die Knöpfe sind danach wieder frei.
• Der Browser öffnet sich nicht: Öffne die Adresse von Hand, falls dein System sie anzeigt, oder stelle in Windows deinen Standardbrowser ein.
• Es passiert nichts nach der Bestätigung: Die Antwort kommt über 127.0.0.1 Port 9848 zurück. Ein Programm, das diesen Port belegt (oder eine Firewall, die lokale Verbindungen blockt), verhindert das. Zwei Anmeldungen gleichzeitig (zum Beispiel Twitch im Plugin und das Konto) gehen nicht: Der Port gehört immer nur einer.
• Nach drei Minuten ohne Bestätigung bricht die Anmeldung ab. Starte sie neu.
• Ein Konto bei Discord braucht keine Freigabe für die Stummschaltung selbst, aber die Steuerung des Discord-Programms (Mikro stumm, Pegel) schon. Siehe Discord.

Konto und Abgleich

Meldung	Bedeutung
Auf dem Server steht ein neuerer Stand. Erst herunterladen, dann wieder hochladen.	Ein anderer PC hat nach deinem letzten Abgleich hochgeladen. Herunterladen, prüfen, dann ggf. wieder Hochladen
Zu diesem Konto liegt noch nichts auf dem Server	Es gibt noch nichts zum Herunterladen. Erst von einem PC Hochladen
Server nicht erreichbar: …	Kein Netz oder der Server antwortet nicht
Was auf dem Server liegt, ist nicht lesbar	Der Stand beim Konto ist unbrauchbar. Lade vom PC mit dem guten Stand hoch und melde den Fehler

Updates

• „nicht abrufbar“ unter Updates & Sicherung: Die Zeile darunter nennt den Grund. Ohne Netz gibt es eben kein Update. Ein 404 sieht für GitHub gleich aus bei einem Release, das es nicht gibt, und bei einem, das nicht öffentlich ist.
• Stimmt die Prüfsumme nicht, wird das Setup gelöscht statt gestartet. Suche erneut.
• Das Setup startet, aber nichts passiert: Windows kann das Setup (unsigniert) mit SmartScreen aufhalten, siehe Installation.
• Die Firmware lässt sich nicht einspielen: „Der Master antwortet nicht.“ Prüfe das Kabel. Eine alte Firmware, die die Nachrichten noch nicht kennt, lässt sich nur über den Download-Modus mit esptool erneuern.

Das Display zeigt etwas nicht

• Ein Widget bleibt leer: Ist sein Plugin aktiviert und eingerichtet? Ein abgeschaltetes Plugin macht sein Widget stumm. Beim Wetter bleibt vor dem ersten Abruf alles leer. Eine Temperatur von gestern wäre schlimmer als keine.
• „Was gerade läuft“ ist leer: Es zeigt, was Windows als aktiven Player führt. Läuft nichts, bleibt es leer.
• Das Hintergrundbild geht nicht: erlaubt sind PNG, JPG, GIF, BMP, WebP bis 8 MB, erkannt am Inhalt, nicht an der Endung.
• Eine Kachel fehlt: Liegt ein Widget darüber? Die Kachel bleibt gespeichert, wird aber nicht gezeichnet. Siehe Das Display.
• Das Display ist leer oder reagiert nicht: Das Zeichnen übernimmt die Firmware des Masters. Prüfe im Simulator, was die Software schickt.

Häufige Meldungen der Plugins

Die Meldungen erscheinen in der Aktivität als Fehler (action_failed): …. Einige stammen noch aus der Entwicklung und sind englisch. Hier die häufigsten.

Allgemein

Meldung	Bedeutung und was tun
… ist nicht aktiviert. Im Marktplatz lässt es sich einschalten.	Das Plugin ist aus. Plugins → Aktivieren
missing parameter: 'x'	Ein Pflichtfeld fehlt in der Belegung. Belegung öffnen und ausfüllen
unknown … command: 'x'	Die Belegung zeigt auf einen Befehl, den das Plugin nicht (mehr) kennt. Neu belegen
Schritt N (plugin.befehl): …	Ein Makro scheiterte in Schritt N, dahinter der Grund. Siehe Makros
only implemented on Windows	Der Befehl gibt es nur unter Windows

Lautstärke, Medien, Soundboard

Meldung	Bedeutung und was tun
X.exe spielt gerade keinen Ton	Das Programm hat keine Audio-Sitzung. Es muss gerade Ton ausgeben. Name prüfen (Task-Manager)
Es gibt keine Datei …	Soundboard: der Pfad stimmt nicht. Mit Ordner mit den Klängen reicht der Dateiname
„x“ lässt sich nicht dekodieren — es muss eine Datei in wav, mp3, ogg, flac sein	Die Datei ist kein Klang in einem dieser Formate
Kein Ausgabegerät gefunden, dessen Name „x“ enthält	Das Ausgabegerät in den Einstellungen des Soundboards passt auf nichts. Ein Teil des Namens genügt

Streaming und Chat

Meldung	Bedeutung und was tun
OBS is not connected	OBS läuft nicht, der WebSocket-Server ist aus, oder Host, Port, Passwort stimmen nicht. OBS
Nicht mit Discord verbunden und kein Mikro-Kürzel hinterlegt …	Entweder Mit Discord verbinden oder dasselbe Kürzel eintragen, das in Discord unter Tastenbelegung steht
Dafür braucht es die Verbindung zu Discord - ein Tastenkürzel kann das nicht	Pegel und „Sprachkanal verlassen“ gehen nur mit Verbindung
keine Webhook-URL hinterlegt	Discord: die Webhook-URL eines Kanals in den Einstellungen eintragen
Twitch ist nicht eingerichtet - erst im Plugin anmelden	Bei Twitch anmelden
twitch 401 / 403 …	Das Token ist abgelaufen oder hat nicht die nötige Berechtigung. Neu anmelden
… braucht das Spotify-Konto - erst im Plugin anmelden	Der Befehl braucht die Spotify-Anmeldung. Bei Spotify anmelden
Spotify spielt gerade nirgends - erst einen Player öffnen	Es ist kein Spotify-Gerät aktiv. Öffne Spotify einmal
Kein Spotify-Gerät namens 'x' - da ist: …	Der Gerätename stimmt nicht. Die Meldung nennt die erreichbaren Geräte
Nichts gefunden zu 'x'	Die Suche nach Titel oder Playlist ergab nichts

Smart Home und Licht

Meldung	Bedeutung und was tun
Home Assistant ist noch nicht eingerichtet …	Adresse und Token fehlen
Token abgelehnt - in Home Assistant ein neues langlebiges Zugriffstoken anlegen	Das Token ist ungültig (Code 401)
Dienst oder Entität unbekannt - Namen und Adresse prüfen	Code 404: Name oder Adresse stimmen nicht
„x“ ist keine Entität - erwartet wird z.B. light.wohnzimmer	Die Entität muss die Form bereich.name haben
Home Assistant nicht erreichbar (…)	Adresse falsch, Rechner aus oder keine Antwort in 5 Sekunden
Die Adresse leitet weiter - trage die endgültige Adresse ein (vielleicht https statt http)	Das Plugin folgt keiner Weiterleitung, damit das Token nicht an einen fremden Rechner geht
Philips Hue ist noch nicht eingerichtet …	Adresse der Bridge eintragen und koppeln
Drück erst den Knopf an der Bridge und versuch es dann erneut	Beim Koppeln: Knopf an der Bridge drücken, dann sofort Mit der Bridge koppeln
Die Bridge kennt den Schlüssel nicht - neu koppeln	Der Schlüssel ist ungültig
Gruppe oder Szene gibt es in der Bridge nicht	Die Nummer stimmt nicht
Elgato Licht nicht erreichbar (…) / Das ist kein Elgato Licht - Adresse und Port prüfen	Adresse oder Port falsch, Licht aus oder in einem anderen Netz
ntfy ist noch nicht eingerichtet: das Thema fehlt in den Einstellungen.	Ein Thema eintragen

System und Windows

Meldung	Bedeutung und was tun
not found: …	Programm öffnen: der Pfad zur .exe stimmt nicht
only http(s) links are allowed / nur http(s) ist erlaubt	Aus Sicherheitsgründen nur Webadressen, keine file: o. ä.
Das ist nur ein Pfad - trage eine feste Adresse in den Einstellungen ein …	Web-Anfrage: ohne vollständige Adresse braucht das Plugin eine feste Adresse davor
kein Fenster gefunden zu 'x'	Fenster: kein Fenster mit diesem Titelteil oder Programmnamen
X.exe läuft nicht	Programme: es gibt keinen Prozess dieses Namens
Gesucht wird der Name des Programms, kein Pfad, z.B. chrome.exe	Bei Programme: nur den Namen angeben
Es läuft gerade kein Herunterfahren, das sich abbrechen ließe	Energie: nichts abzubrechen
text is longer than 500 characters	Tastatur: Text tippen nimmt höchstens 500 Zeichen
unknown key: 'x' / unknown modifier: x	Tastenkürzel: ein Name wird nicht erkannt, siehe Tastenkürzel
the clipboard is held by another program	Zwischenablage: ein anderes Programm hält sie gerade. Nochmal versuchen
Steam lässt sich nicht öffnen - ist es auf diesem Rechner installiert?	Steam fehlt

Werkzeuge

Meldung	Bedeutung und was tun
Es läuft kein Timer — zuerst „Timer starten“	Weiter ohne laufenden Timer
Wie lange? „minutes“ oder „seconds“ ausfüllen	Timer starten ohne Zeit
Ungültiges Format … , z.B. %d.%m.%Y %H:%M	Datum und Zeit: das Format ist kein gültiges strftime
Die Zwischenablage enthält keinen Text	Textwerkzeuge: nichts zum Umwandeln
Ein Würfel hat 2 bis 1000 Seiten	Zufall: ungültige Seitenzahl

Wenn nichts hilft

1. Diagnose kopieren (Einstellungen → Backend & Info).
2. Suche in %APPDATA%\MultiverseStreamDeck die Dateien backend.log, frontend.log und, falls sie existiert, backend-crash.log.
3. Schreibe uns, was du getan hast, was du erwartet hast und was passiert ist. Lege die Diagnose und die Dateien bei.

Achtung: Die Logdateien können Namen und Adressen aus deinen Belegungen enthalten. Prüfe sie, bevor du sie öffentlich postest. Die Konfigurationsdatei config.json enthält Passwörter und Token der Plugins im Klartext. Gib sie nie weiter.

---

Weiter: Datenschutz und Sicherheit · FAQ