programs.aerospace.enable
Whether to enable AeroSpace window manager.
Type: boolean
Default:
false
Example:
true
Declared by:
programs.aerospace.package
The aerospace package to use.
Type: null or package
Default:
pkgs.aerospace
Declared by:
programs.aerospace.launchd.enable
Configure the launchd agent to manage the AeroSpace process.
The first time this is enabled, macOS will prompt you to allow this background item in System Settings.
You can verify the service is running correctly from your terminal.
Run: launchctl list | grep aerospace
-
A running process will show a Process ID (PID) and a status of 0, for example:
12345 0 org.nix-community.home.aerospace -
If the service has crashed or failed to start, the PID will be a dash and the status will be a non-zero number, for example:
- 1 org.nix-community.home.aerospace
In case of failure, check the logs with cat /tmp/aerospace.err.log.
For more detailed service status, run launchctl print gui/$(id -u)/org.nix-community.home.aerospace.
NOTE: Enabling this option will configure AeroSpace to not manage its own
launchd agent. Specifically, it will set start-at-login = false and
after-login-command = [] in the configuration file, as those are now handled
by Home Manager and launchd instead.
Type: boolean
Default:
false
Declared by:
programs.aerospace.launchd.keepAlive
Whether the launchd service should be kept alive.
Type: boolean
Default:
true
Declared by:
programs.aerospace.settings
AeroSpace configuration, see https://nikitabobko.github.io/AeroSpace/guide#configuring-aerospace for supported values.
Type: TOML value
Default:
{ }
Example:
{
gaps = {
outer = {
bottom = 8;
left = 8;
right = 8;
top = 8;
};
};
mode = {
main = {
binding = {
alt-h = "focus left";
alt-j = "focus down";
alt-k = "focus up";
alt-l = "focus right";
};
};
};
on-window-detected = [
{
"if" = {
app-id = "com.apple.finder";
};
run = "move-node-to-workspace 9";
}
{
check-further-callbacks = true;
"if" = {
app-id = "com.apple.systempreferences";
app-name-regex-substring = "settings";
during-aerospace-startup = true;
window-title-regex-substring = "substring";
workspace = "workspace-name";
};
run = [
"layout floating"
"move-node-to-workspace S"
];
}
];
}
Declared by: