구성 포맷

SpaceLauncher 구성 내보내기는 JSON 파일입니다. 읽고, 비교하고, 다른 Mac으로 복사하고, 직접 만든 스크립트로 처리할 수 있습니다.

이 페이지는 신뢰를 위한 참고 자료이지 완전한 API 사양이 아닙니다. 포맷은 발전할 수 있으므로, 도구는 가능하면 알 수 없는 필드를 보존해야 합니다.

내보내기 유형

SpaceLauncher는 두 가지 JSON 패키지를 기록합니다.

.slbindings는 키 바인딩만 내보냅니다:

• format: name.guoc.SpaceLauncher.key-bindings
• version: 현재 1
• keyBindings: 키 바인딩 규칙 배열

.slbackup은 앱 전체 백업을 내보냅니다:

• format: name.guoc.SpaceLauncher.backup
• version: 현재 1
• configuration: 전체 AppConfiguration

패키지의 version은 앱 구성의 schemaVersion과 다릅니다. 현재 AppConfiguration 스키마 버전은 2입니다.

전체 구성

전체 AppConfiguration에는 다음이 포함됩니다:

• schemaVersion
• commandTrees
• bindings
• disabledApplications
• suggestedDisabledApplicationPaths

commandTrees가 현재 저장되는 구조입니다. bindings도 도구 및 이전 가져오기 경로와의 호환을 위해 함께 인코딩됩니다.

키 바인딩 규칙

각 규칙은 FlatKeysAndActionRow이며 주요 필드는 다음과 같습니다:

• id: UUID
• enabled: 불리언
• applicationScope: allBut(paths) 또는 only(paths)
• keys: 트리거 키 코드 시퀀스
• action: 동작 페이로드. 사람이 읽을 설명은 description에 저장 가능
• leaderKey: 길게 누르기 또는 짧게 누르기 리더 정의
• holdContinuationIndexAfterAction: 길게 누르기 리더의 선택적 계속 설정

applicationScope에는 두 가지 형태가 있습니다:

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

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

예시

이 .slbindings 예시에는 바인딩이 하나 있습니다. Space를 길게 누르고 F와 D를 누르면 다운로드 폴더가 열립니다.

{
  "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
}

키 코드 49는 표준 Mac 키보드 배열의 Space입니다. 키 코드 3과 2는 F와 D입니다.

가져오기 동작

키 바인딩 가져오기는 새 규칙을 현재 설정에 병합하거나, 현재 키 바인딩을 모두 대치할 수 있습니다. 병합할 때 SpaceLauncher는 리더 키, 트리거 키, 앱 적용 범위로 바인딩의 동일성을 확인해 중복을 검사합니다.

전체 백업 복원은 다릅니다. .slbackup 복원은 앱 구성을 대치합니다. 이는 백업 복구용이지 부분 병합용이 아닙니다.

왜 중요한가

이 포맷은 사람이 읽을 수 있고 스크립트로 처리할 수 있습니다. 바인딩을 살펴보고, diff로 변경 사항을 비교하고, 머신 간에 설정을 옮기고, 직접 만든 도구로 규칙을 생성할 수 있습니다. SpaceLauncher는 저장된 구성의 타임스탬프 로컬 백업도 차례로 보관하며, 저장 전에 단축키 충돌을 경고합니다.