AeroSpace is an i3-like tiling window manager for macOS
- YouTube Demo
- AeroSpace Guide
- AeroSpace list of all commands
- AeroSpace list of additional CLI commands
Public Beta. Feedback is very much welcome
- I encourage you to try AeroSpace and file GitHub issues if something doesn't work for you. In particular, I'm interested in issues that block you from using AeroSpace on daily basis.
- I already use AeroSpace on daily basis and I'm happy with it
- The documentation covers all major things you need to know
- Expect minor breaking changes in the config format. Once the project reaches 1.0 the config is guaranteed to preserve backwards compatibility
- Manual tiling window manager based on a tree paradigm
- i3 inspired
- AeroSpace employs its own emulation of virtual workspaces instead of relying on native macOS Spaces due to their considerable limitations
- Plain text configuration (dotfiles friendly). See: default-config.toml
CLI scriptable[PLANNED]- Doesn't require disabling SIP (System Integrity Protection)
- Proper multi-monitor support (i3-like paradigm)
- Status menu icon displays current workspace name
Install via Homebrew to get autoupdates (Preferred)
brew install --no-quarantine --cask nikitabobko/tap/aerospace
If you see this message
Error: It seems there is already a Binary at '/opt/homebrew/bin/aerospace'.
Please do brew uninstall aerospace-cli && brew reinstall aerospace. Consider voting for this homebrew
issue
You would need a Mac.
brew install gsed xcodegen # https://github.com/yonaskolb/XcodeGen
./build-debug.shbrew install gsed xcodegen # https://github.com/yonaskolb/XcodeGen
./run-tests.shValues
- AeroSpace is targeted at advanced users and developers
- Keyboard centric
- Never break configuration files (Guaranteed once AeroSpace reaches 1.0 version)
- AeroSpace doesn't use GUI, unless necessarily
- AeroSpace will never provide a GUI for configuration. For advanced users, it's easier to edit a configuration file in text editor rather than navigating through checkboxes in GUI.
- Status menu icon is ok, because visual feedback is needed
- Provide practical features. Fancy appearance features are not practical (e.g. window borders, transparency, etc)
- If "dark magic" (aka "private APIs", "code injections", etc) can be avoided, it must be avoided
- Right now, AeroSpace uses only a single private API to get window ID of accessibility object. Everything else is macOS public accessibility API.
- AeroSpace will never require you to disable SIP (System Integrity Protection). For example, yabai requires you to disable SIP to use some of its features. AeroSpace will either find another way (e.g. emulation of workspaces) or will not implement this feature at all (window transparency and window shadowing are not practical features)
Non Values
- Play nicely with existing macOS features. If limitations are imposed then AeroSpace won't play nicely with existing macOS
features
- E.g. AeroSpace doesn't acknowledge the existence of macOS Spaces, and it uses emulation of its own workspaces
defaults write -g NSWindowShouldDragOnGesture YESNow, you can move windows by holding ctrl+cmd and dragging any part of the window (not necessarily the window title)
Source: reddit