Dateien und Ordner

Wo die Software liegt und wo sie ihre Daten ablegt. Alles, was du eingerichtet hast, liegt in deinem Benutzerordner, getrennt vom Programm. Deshalb überleben deine Einstellungen ein Update und, wenn du es willst, auch eine Deinstallation.

Das Programm

Je nachdem, für wen du installiert hast:

Installation	Ordner
nur für dich	%LOCALAPPDATA%\Programs\Multiverse Stream Deck
für alle Benutzer	C:\Program Files\Multiverse Stream Deck

Darin:

Datei	Wofür
MultiverseStreamDeck.exe	die Oberfläche
backend\MultiverseBackend.exe	das Backend
.env	Angaben des Builds, etwa welcher Server gemeint ist und die öffentliche Kennung der Discord-Anwendung. Keine Geheimnisse

Die .env liegt neben dem Programm. Wer sie ändert, ändert, wohin sich diese Kopie der Software verbindet. Ein geheimer Schlüssel des Servers gehört nie hinein.

Deine Daten

%APPDATA%\MultiverseStreamDeck (zum Öffnen: Windows + R, den Pfad eintippen, Enter).

Datei / Ordner	Inhalt
config.json	Alles Persönliche: Belegungen, Ordner, Widgets, Seiten, Farben, Helligkeit, Plugin-Einstellungen (mit Passwörtern und Token im Klartext), die Auswahl der Plugins, das Konto (der Anmeldeschlüssel ist verschlüsselt)
session.token	Das Wort, mit dem sich die Oberfläche beim Backend anmeldet. Bei jedem Start neu
app.json	Einstellungen zum Fenster und diesem PC: Autostart, im Hintergrund starten, Schließen beendet
window.json	Größe, Ort und maximierter Zustand des Fensters
backend.log	Ausgabe des Backends, von der Oberfläche mitgeschrieben
frontend.log	Verbindungsfehler der Oberfläche
backend-crash.log	Nur nach Abstürzen in einer eingebauten Bibliothek: die Stapel aller Arbeitsabläufe, dazu je Start eine Zeile mit der Fassung
backups\	deine Sicherungen, deck-JJJJMMTT-hhmmss.json, höchstens 20
backgrounds\	das Hintergrundbild je Bildschirm (<position>.<endung>)
icons\	eigene Symbole (der Dateiname ist ein Fingerabdruck des Inhalts)
covers\	die Cover von „Was gerade läuft“
firmware\	die heruntergeladene Firmware für den Master (master-<Version>.bin)
updates\	das heruntergeladene Setup eines Software-Updates (MultiverseStreamDeck-Setup-<Version>.exe)
plugins\	eigene Plugins (.py-Dateien), siehe Plugins verwalten

Auch wenn du Windows neu aufsetzt, genügt es, config.json (und wenn nötig icons\, backgrounds\) zu sichern. Plugin-Zugangsdaten sind dann allerdings in dieser Datei. Gib sie nicht weiter.

Die config.json von Hand ändern? Beende zuerst die Software (Infobereich-Symbol → Beenden), lege eine Kopie an und starte danach neu. Ein Fehler im JSON verhindert den Start des Backends. Eine Datei mit einem Byte-Order-Mark (wie sie manche Editoren schreiben) wird gelesen.

Aufbau der config.json

Die obersten Schlüssel:

Schlüssel	Inhalt	Wandert zum Konto und in die Sicherung
adopted	übernommene Module: UUID → Name	ja
modules	die Modulübersicht: Art, zuletzt gesehene Position, Firmware je UUID	ja
folders	Ordner: Name → {Tastenindex: Aktion}	ja
brightness	Helligkeit je Position, all als Ersatz (0 bis 255)	ja
led_colors	LED-Farbe je Position, all als Ersatz (#RRGGBB)	ja
key_bindings	Belegungen der Tasten, Schlüssel "<position>:<index>"	ja
fader_bindings	Belegungen der Schieberegler, derselbe Schlüssel	ja
encoder_bindings	Belegungen der Drehregler, derselbe Schlüssel	ja
screen_widgets	Widgets, Schlüssel "<position>:<seite>"	ja
screen_pages	Zahl der Seiten je Position	ja
screen_page_names	Namen der Seiten je Position	ja
enabled_plugins	Liste der aktivierten Plugins	ja
plugins	Einstellungen der Plugins	nein
cloud	das Konto, mit verschlüsseltem Anmeldeschlüssel	nein
server_config	was der Server über den Build sagt (öffentliche Angaben), damit sie ohne Netz da sind	nein
screen_backgrounds	Pfade der Hintergrundbilder	nein
app_settings	Einstellungen dieses Rechners (Update-Suche beim Start)	nein

Eine Belegung sieht so aus:

{
  "plugin": "obs",
  "command": "switch_scene",
  "params": { "scene": "Gaming" },
  "icon": "scene",
  "label": "Gaming"
}

Der Schlüssel "-1:2" in key_bindings ist die dritte Taste (Zählung ab 0) des Moduls an Position -1. Die Kacheln des Masters stehen bei Position 0: "0:0" ist die erste Kachel, "0:25" die erste auf Seite 2.

Die Datei ist abwärtskompatibel: Ältere Fassungen werden beim Laden umgeschrieben (Belegungen, die an die UUID gebunden waren, die alten festen Plätze für Widgets, ein Konto aus der Zeit vor den Anbietern). Unbekannte Schlüssel werden nicht gelesen.

---

Zurück: Dokumentation · Datenschutz