Per-shortcut overrides

Every switcher shortcut normally uses the global settings. shortcutOverrides lets a shortcut disagree: a compact alphabetical list for one hotkey, full-size window previews for another, from the same install.

This pairs with scopedShortcutList, which creates additional hotkeys that open the switcher pre-filtered to a subset of windows. Together: one hotkey for "all my windows as previews", another for "just this app's windows, as a list".

Targets

An override names the shortcut it applies to in its target field:

{
  "shortcutOverrides": [
    {
      "target": "switchWindows",
      "layoutMode": "windowPreview",
      "panelScalePercent": "140",
      "sortOrder": "mruWindows"
    },
    {
      "target": "scoped.0",
      "layoutMode": "list",
      "listWidthPercent": "60",
      "showMinimized": "false"
    }
  ]
}

Any field you omit inherits the global setting. An override with nothing but a target is the same as having no override at all, and is dropped when the file is next written.

Fields

Field names mostly match the global key of the same name — see the config reference for what each one does. Three are shortened: showMinimized, showHidden and showWindowless map to showMinimizedWindows, showHiddenApps and showWindowlessApps.

spaceScope takes an extra value here, "inherit", which follows the global setting.

Per-shortcut overrides of the global settings. Each entry names its shortcut in "target"; every other field is optional and inherits the global value when absent.

Unknown fields are preserved as-is rather than dropped, so opening your config with an older version of the app will not strip overrides it doesn't understand yet.

Scoped shortcuts

scopedShortcutList defines extra global hotkeys, each opening the switcher already filtered. Add and remove them under Settings → Profiles.

{
  "scopedShortcutList": [
    { "id": "0", "scope": "currentAppWindows", "name": "scopedSwitch1" },
    { "id": "1", "scope": "minimizedOnly", "name": "scopedSwitch2" }
  ]
}

Scoped switcher shortcuts — each opens the panel already filtered to one subset of windows.

Ids are allocated monotonically and never reused, so an entry keeps its recorded chord and its shortcutOverrides entry across adds, removes and reordering. id is a decimal string, matching how the list is stored.

Direct app hotkeys

Unrelated to scoped shortcuts, but often wanted alongside them: directActivationBindings assigns a bundle ID to each of nine "focus or launch this app" hotkey slots. It is always exactly nine entries; an empty string leaves a slot unused.

{
  "directActivationBindings": [
    "com.apple.Safari",
    "com.googlecode.iterm2",
    "",
    "",
    "",
    "",
    "",
    "",
    ""
  ]
}

The chords for these slots are, again, recorded outside this file.

Worked example

A setup with three distinct switchers:

{
  "layoutMode": "iconDock",
  "sortOrder": "mru",
  "spaceScope": "allSpaces",

  "scopedShortcutList": [
    { "id": "0", "scope": "currentAppWindows", "name": "scopedSwitch1" }
  ],

  "shortcutOverrides": [
    {
      "target": "switchWindows",
      "layoutMode": "windowPreview",
      "sortOrder": "mruWindows",
      "panelScalePercent": "130"
    },
    {
      "target": "scoped.0",
      "layoutMode": "list",
      "listWidthPercent": "50",
      "showWindowTitleLabel": "true",
      "spaceScope": "inherit"
    }
  ]
}

• ⌘Tab — icon grid of apps, most-recent first, across all Spaces.
• ⌘` — large window previews of the front app, ordered by most recent window.
• The scoped hotkey — a narrow list of the current app's windows with full titles.