Design
Einstellungen
Die Seite Einstellungen (Reiter oben) hat zwei Spalten: links sechs Bereiche, rechts der gewählte. Der Bereich bleibt gemerkt, solange die Software läuft. Ein Punkt neben Updates & Sicherung sagt, dass es etwas Neues gibt.
Zwei Orte für Einstellungen, mit Absicht
Nicht alles gehört an denselben Ort:
| Was | Wo es liegt | Wandert zum Konto? |
|---|---|---|
| Was das Deck ist: Belegungen, Ordner, Widgets, Seiten, Farben, Helligkeit, Plugin-Auswahl | config.json | ja (außer den Plugin-Einstellungen), siehe Abgleich |
| Was das Fenster tut: Autostart, im Hintergrund starten, Schließen beendet | app.json | nein |
| Was das Backend tut: Update-Suche beim Start | config.json (app_settings) | nein |
Die Einstellungen zum Fenster und zu diesem Rechner gehören diesem PC. Ein zweiter PC will vielleicht gar nicht mit Windows starten. Wo die Dateien liegen, steht unter Dateien und Ordner.
Konto
Wer du bist und wie du angemeldet bist, siehe Konto und Abgleich.
- Konto: Bild und Name, dazu „Angemeldet über Discord“. Nicht angemeldet steht dort: „Deine Belegungen bleiben auf diesem PC. Melde dich an, um sie mitzunehmen.“
- Abmelden: entfernt das Konto.
- Anmelden / Neu anmelden: die Knöpfe der Anbieter (Discord, Google, Twitch). Der Hinweis dabei: „Die Anmeldung hier ist kein Ersatz für das Login beim Start.“
- Abgleich mit dem Konto: Hochladen und Herunterladen.
Kennt diese Fassung keinen Server (kein Konto möglich), steht dort „In diesem Build nicht eingerichtet“.
Geräte
Der Master, seine Firmware und alle Module, die dieses Konto schon einmal gesehen hat.
- Master-Modul mit Anschluss (an welchem COM-Port er hängt), Firmware und Protokoll, dazu der Knopf Master einrichten.
- Bei einer Lücke zwischen Firmware und Software steht hier der Protokollhinweis, siehe Updates.
- Meine Module: alles, was an diesem Konto schon einmal steckte, auch wenn gerade nichts angeschlossen ist. Ein Modul, das du nicht mehr hast, lässt sich vergessen. Seine Belegungen bleiben, sie hängen am Steckplatz. Siehe Module und Kette.
Plugins
Was dein Deck kann. Nur aktivierte Plugins laufen und stehen in der Leiste.
- eine Zahl und Plugins aktiviert, dazu der Knopf Plugins verwalten (führt in den Marktplatz)
- die Liste der Aktivierten als Chips. Ist noch nichts aktiviert: „Noch kein Plugin aktiviert. Unter „Plugins verwalten“ findest du, was es gibt.“
- Eigene Plugins mit Fehler: eigene Dateien, die sich nicht laden ließen, mit dem Grund
- Eigene Plugins: der Ordner für eigene Plugins mit dem Knopf Plugin-Ordner öffnen. Eine
.py-Datei darin wird beim Start geladen und erscheint im Marktplatz. Der Knopf So schreibst du ein Plugin führt zur Anleitung dafür
Allgemein
Wie sich das Programm auf diesem Rechner verhält. Diese Einstellungen wandern nicht zum Konto.
| Schalter | Wirkung |
|---|---|
| Mit Windows starten | Die Software startet, wenn du dich bei Windows anmeldest, damit die Tasten sofort greifen. Technisch ein Eintrag im Autostart deines Benutzers (ohne Administratorrechte). Der Schalter gilt nur für die installierte Fassung |
| Im Hintergrund starten | Beim Start durch Windows bleibt nur das Symbol im Infobereich, ohne Fenster. Das Deck arbeitet trotzdem. Ein Start von Hand zeigt das Fenster immer |
| Fenster schließen beendet das Programm | Aus (Vorgabe): Das Fenster legt sich in den Infobereich, und die Belegungen greifen weiter. An: Mit dem Fenster ist auch das Deck aus |
| Beim Start nach Updates suchen | Fragt GitHub höchstens alle sechs Stunden. Installiert wird nie von selbst. Ausdrücklich nachsehen kannst du immer unter Updates & Sicherung |
Lehnt Windows den Autostart-Eintrag ab, springt der Schalter zurück und sagt es: Ein Schalter, der „an“ zeigt, ohne dass etwas geschah, würde lügen.
Updates & Sicherung
- Software: Version, Oberfläche („Avalonia · .NET 8“) und Konfiguration (der Ordner mit deinen Daten).
- Updates: Nach Updates suchen, Software und Firmware aktualisieren, Release öffnen. Siehe Updates.
- Sicherung: erstellen, einspielen, Ordner öffnen. Siehe Sicherung.
Backend & Info
Der Prozess hinter der Oberfläche, Hilfe bei Problemen und Nachweise.
- Backend: Zustand, Endpunkt (
ws://127.0.0.1:9847, die lokale Adresse, über die die Oberfläche mit dem Backend spricht) und Prozess. - Backend neu starten: beendet den Prozess, den diese Software gestartet hat, und startet ihn wieder. Belegungen und Einstellungen liegen in der Konfiguration und überleben das. Das hilft zum Beispiel, wenn du den Master erst nach dem Start angesteckt hast.
- Simulator öffnen: dasselbe wie der Reiter Simulator.
- Hilfe bei Problemen → Diagnose kopieren: legt eine kurze Zusammenfassung in die Zwischenablage, die du einer Fehlermeldung beilegen kannst. Sie enthält: Zeitpunkt, Fassungen (Software, System, .NET), Zustand von Backend und Master (Anschluss, Firmware, Protokoll), Zahl der Module, ob ein Konto angemeldet ist, den Stand der Updates und die Namen der aktivierten Plugins mit denen, die getrennt oder nicht eingerichtet sind. Sie enthält keine Belegungen, Beschriftungen, Namen, Passwörter oder Token, und Pfade verlieren deinen Benutzernamen (er wird zu
%USERPROFILE%und<Benutzer>). Die Diagnose geht an andere und soll nichts verraten, was zum Suchen eines Fehlers nicht gebraucht wird. - Über: die Nachweise für fremde Bestandteile: Die Symbole stammen aus Font Awesome Free (CC BY 4.0). Die Zeichen von Discord, Google, Twitch und Spotify sind Marken ihrer Inhaber. Einzelheiten stehen in der Datei
NOTICE.md.
Weiter: Simulator · Fehlerbehebung