Created
March 29, 2026 04:39
-
-
Save dimritium/52127bfc97d736fe042d812661e0d4fa to your computer and use it in GitHub Desktop.
Aerospace config
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # Place a copy of this config to ~/.aerospace.toml | |
| # After that, you can edit ~/.aerospace.toml to your liking | |
| # Config version for compatibility and deprecations | |
| # Fallback value (if you omit the key): config-version = 1 | |
| config-version = 2 | |
| # You can use it to add commands that run after AeroSpace startup. | |
| # Available commands : https://nikitabobko.github.io/AeroSpace/commands | |
| after-startup-command = [] | |
| # Start AeroSpace at login | |
| start-at-login = true | |
| # Normalizations. See: https://nikitabobko.github.io/AeroSpace/guide#normalization | |
| enable-normalization-flatten-containers = true | |
| enable-normalization-opposite-orientation-for-nested-containers = true | |
| # See: https://nikitabobko.github.io/AeroSpace/guide#layouts | |
| # The 'accordion-padding' specifies the size of accordion padding | |
| # You can set 0 to disable the padding feature | |
| accordion-padding = 30 | |
| # Possible values: tiles|accordion | |
| default-root-container-layout = 'tiles' | |
| # Possible values: horizontal|vertical|auto | |
| # 'auto' means: wide monitor (anything wider than high) gets horizontal orientation, | |
| # tall monitor (anything higher than wide) gets vertical orientation | |
| default-root-container-orientation = 'auto' | |
| # Mouse follows focus when focused monitor changes | |
| # Drop it from your config, if you don't like this behavior | |
| # See https://nikitabobko.github.io/AeroSpace/guide#on-focus-changed-callbacks | |
| # See https://nikitabobko.github.io/AeroSpace/commands#move-mouse | |
| # Fallback value (if you omit the key): on-focused-monitor-changed = [] | |
| on-focused-monitor-changed = ['move-mouse monitor-lazy-center'] | |
| # You can effectively turn off macOS "Hide application" (cmd-h) feature by toggling this flag | |
| # Useful if you don't use this macOS feature, but accidentally hit cmd-h or cmd-alt-h key | |
| # Also see: https://nikitabobko.github.io/AeroSpace/goodies#disable-hide-app | |
| automatically-unhide-macos-hidden-apps = false | |
| # List of workspaces that should stay alive even when they contain no windows, | |
| # even when they are invisible. | |
| # This config version is only available since 'config-version = 2' | |
| # Fallback value (if you omit the key): persistent-workspaces = [] | |
| # persistent-workspaces = ["1", "2", "3", "4", "5", "6", "7", "8", "9", "A", "B", | |
| # "C", "D", "E", "F", "G", "I", "M", "N", "O", "P", "Q", | |
| # "R", "S", "T", "U", "V", "W", "X", "Y", "Z"] | |
| persistent-workspaces = [] | |
| # A callback that runs every time binding mode changes | |
| # See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#mode | |
| on-mode-changed = [] | |
| # Possible values: (qwerty|dvorak|colemak) | |
| # See https://nikitabobko.github.io/AeroSpace/guide#key-mapping | |
| [key-mapping] | |
| preset = 'qwerty' | |
| # Gaps between windows (inner-*) and between monitor edges (outer-*). | |
| # Possible values: | |
| # - Constant: gaps.outer.top = 8 | |
| # - Per monitor: gaps.outer.top = [{ monitor.main = 16 }, { monitor."some-pattern" = 32 }, 24] | |
| # In this example, 24 is a default value when there is no match. | |
| # Monitor pattern is the same as for 'workspace-to-monitor-force-assignment'. | |
| # See: | |
| # https://nikitabobko.github.io/AeroSpace/guide#assign-workspaces-to-monitors | |
| [gaps] | |
| inner.horizontal = 15 | |
| inner.vertical = 15 | |
| outer.left = 15 | |
| outer.bottom = 15 | |
| outer.top = 15 | |
| outer.right = 15 | |
| # 'main' binding mode declaration | |
| # See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes | |
| # 'main' binding mode must be always presented | |
| # Fallback value (if you omit the key): mode.main.binding = {} | |
| [mode.main.binding] | |
| # All possible keys: | |
| # - Letters. a, b, c, ..., z | |
| # - Numbers. 0, 1, 2, ..., 9 | |
| # - Keypad numbers. keypad0, keypad1, keypad2, ..., keypad9 | |
| # - F-keys. f1, f2, ..., f20 | |
| # - Special keys. minus, equal, period, comma, slash, backslash, quote, semicolon, | |
| # backtick, leftSquareBracket, rightSquareBracket, space, enter, esc, | |
| # backspace, tab, pageUp, pageDown, home, end, forwardDelete, | |
| # sectionSign (ISO keyboards only, european keyboards only) | |
| # - Keypad special. keypadClear, keypadDecimalMark, keypadDivide, keypadEnter, keypadEqual, | |
| # keypadMinus, keypadMultiply, keypadPlus | |
| # - Arrows. left, down, up, right | |
| # All possible modifiers: cmd, alt, ctrl, shift | |
| # All possible commands: https://nikitabobko.github.io/AeroSpace/commands | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#exec-and-forget | |
| # You can uncomment the following lines to open up terminal with alt + enter shortcut | |
| # (like in i3) | |
| alt-enter = '''exec-and-forget osascript -e ' | |
| tell application "Ghostty" | |
| do script | |
| activate | |
| end tell' | |
| ''' | |
| # custom commands | |
| alt-f = 'fullscreen' | |
| alt-leftSquareBracket = 'workspace prev' | |
| # Bind 'alt-left' to switch to the previous workspace | |
| alt-rightSquareBracket= 'workspace next' | |
| alt-shift-m = 'focus-monitor next' | |
| alt-shift-n = 'focus-monitor prev' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#layout | |
| alt-slash = 'layout tiles horizontal vertical' | |
| alt-comma = 'layout accordion horizontal vertical' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#focus | |
| alt-h = 'focus left' | |
| alt-j = 'focus down' | |
| alt-k = 'focus up' | |
| alt-l = 'focus right' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#move | |
| alt-shift-h = 'move left' | |
| alt-shift-j = 'move down' | |
| alt-shift-k = 'move up' | |
| alt-shift-l = 'move right' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#resize | |
| alt-minus = 'resize smart -50' | |
| alt-equal = 'resize smart +50' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#workspace | |
| alt-1 = 'workspace 1' | |
| alt-2 = 'workspace 2' | |
| alt-3 = 'workspace 3' | |
| alt-4 = 'workspace 4' | |
| alt-5 = 'workspace 5' | |
| alt-6 = 'workspace 6' | |
| alt-7 = 'workspace 7' | |
| alt-8 = 'workspace 8' | |
| alt-9 = 'workspace 9' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#move-node-to-workspace | |
| alt-shift-1 = 'move-node-to-workspace 1' | |
| alt-shift-2 = 'move-node-to-workspace 2' | |
| alt-shift-3 = 'move-node-to-workspace 3' | |
| alt-shift-4 = 'move-node-to-workspace 4' | |
| alt-shift-5 = 'move-node-to-workspace 5' | |
| alt-shift-6 = 'move-node-to-workspace 6' | |
| alt-shift-7 = 'move-node-to-workspace 7' | |
| alt-shift-8 = 'move-node-to-workspace 8' | |
| alt-shift-9 = 'move-node-to-workspace 9' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#workspace-back-and-forth | |
| alt-tab = 'workspace-back-and-forth' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#move-workspace-to-monitor | |
| alt-shift-tab = 'move-workspace-to-monitor --wrap-around next' | |
| # See: https://nikitabobko.github.io/AeroSpace/commands#mode | |
| alt-shift-semicolon = 'mode service' | |
| # 'service' binding mode declaration. | |
| # See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes | |
| [mode.service.binding] | |
| esc = ['reload-config', 'mode main'] | |
| r = ['flatten-workspace-tree', 'mode main'] # reset layout | |
| f = ['layout floating tiling', 'mode main'] # Toggle between floating and tiling layout | |
| backspace = ['close-all-windows-but-current', 'mode main'] | |
| # sticky is not yet supported https://github.com/nikitabobko/AeroSpace/issues/2 | |
| #s = ['layout sticky tiling', 'mode main'] | |
| alt-shift-h = ['join-with left', 'mode main'] | |
| alt-shift-j = ['join-with down', 'mode main'] | |
| alt-shift-k = ['join-with up', 'mode main'] | |
| alt-shift-l = ['join-with right', 'mode main'] | |
| [workspace-to-monitor-force-assignment] | |
| 1 = 'main' # Main monitor | |
| 2 = 1 # Monitor sequence number from left to right. 1-based indexing |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment