Konfigurationsformat

SpaceLauncher-Konfigurationsexporte sind JSON-Dateien, die Sie lesen, diffen, auf einen anderen Mac kopieren oder mit eigenen Skripten verarbeiten können.

Diese Seite ist eine vertrauensorientierte Referenz, keine vollständige API-Spezifikation. Das Format kann sich weiterentwickeln; Tools sollten unbekannte Felder nach Möglichkeit erhalten.

Exporttypen

SpaceLauncher schreibt zwei JSON-Pakettypen.

.slbindings exportiert nur Tastenbelegungen:

• format: name.guoc.SpaceLauncher.key-bindings
• version: derzeit 1
• keyBindings: ein Array von Tastenbelegungsregeln

.slbackup exportiert ein vollständiges App-Backup:

• format: name.guoc.SpaceLauncher.backup
• version: derzeit 1
• configuration: die vollständige AppConfiguration

Die Paket-version ist nicht dasselbe wie die schemaVersion der App-Konfiguration. Die aktuelle AppConfiguration-Schemaversion ist 2.

Vollständige Konfiguration

Eine vollständige AppConfiguration enthält:

• schemaVersion
• commandTrees
• bindings
• disabledApplications
• suggestedDisabledApplicationPaths

commandTrees ist die aktuell persistierte Struktur. bindings wird zusätzlich codiert — für Tools und ältere Importpfade.

Tastenbelegungsregel

Jede Regel ist eine FlatKeysAndActionRow mit diesen Hauptfeldern:

• id: UUID
• enabled: Boolescher Wert
• applicationScope: entweder allBut(paths) oder only(paths)
• keys: Tastencode-Sequenz der Auslösetasten
• action: Aktions-Payload, optional mit menschenlesbarer Beschreibung im Feld description
• leaderKey: Halte- oder Tipp-Leader-Definition
• holdContinuationIndexAfterAction: optionale Fortsetzungseinstellung für Halte-Leader

applicationScope hat zwei Formen:

{
  "allBut": {
    "paths": []
  }
}

{
  "only": {
    "paths": [
      "/Applications/TextEdit.app"
    ]
  }
}

Beispiel

Dieses .slbindings-Beispiel enthält eine Belegung: Leertaste halten, dann F und D drücken, um den Ordner „Downloads“ zu öffnen.

{
  "appVersion": "3.0.0 (300)",
  "exportedAt": "2026-06-07T12:00:00Z",
  "format": "name.guoc.SpaceLauncher.key-bindings",
  "keyBindings": [
    {
      "action": {
        "description": "Open Downloads",
        "openFolder": {
          "applicationPath": null,
          "folderPath": "~/Downloads"
        }
      },
      "applicationScope": {
        "allBut": {
          "paths": []
        }
      },
      "enabled": true,
      "id": "11111111-2222-4333-8444-555555555555",
      "keys": [
        3,
        2
      ],
      "leaderKey": {
        "hold": {
          "info": {
            "keepsTapFunction": true,
            "keyCode": 49
          }
        }
      }
    }
  ],
  "version": 1
}

Tastencode 49 ist die Leertaste im Standard-Mac-Tastaturlayout. Die Tastencodes 3 und 2 sind F und D.

Importverhalten

Beim Import von Tastenbelegungen können neue Regeln in Ihre aktuelle Konfiguration eingefügt oder alle aktuellen Tastenbelegungen ersetzt werden. Beim Zusammenführen prüft SpaceLauncher die Identität einer Belegung anhand von Leader-Taste, Auslösetasten und App-Bereich auf Duplikate.

Die Wiederherstellung eines vollständigen Backups ist anders: Das Wiederherstellen einer .slbackup-Datei ersetzt die App-Konfiguration. Sie ist für die Wiederherstellung aus einem Backup gedacht, nicht für teilweises Zusammenführen.

Warum das wichtig ist

Das Format ist menschenlesbar und skriptfähig. Sie können eine Belegung inspizieren, Änderungen in einem Diff vergleichen, eine Konfiguration zwischen Rechnern migrieren oder Regeln mit eigenen Tools erzeugen. SpaceLauncher legt außerdem fortlaufende, zeitgestempelte lokale Backups der gesicherten Konfiguration an und warnt vor dem Sichern vor Kurzbefehl-Konflikten.