aerospace fork
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869= aerospace-subscribe(1)include::util/man-attributes.adoc[]// tag::purpose[]:manpurpose: Subscribe to AeroSpace events and receive notifications via socket// end::purpose[]:manname: aerospace-subscribe
// =========================================================== Synopsis== Synopsis[verse]// tag::synopsis[]aerospace subscribe [-h|--help] [--all] [--no-send-initial] [<event>...]
// end::synopsis[]
// =========================================================== Description== Description
// tag::body[]{manpurpose}
This command connects to the AeroSpace server and receives real-time event notifications as JSON lines.The connection remains open until terminated (e.g., via Ctrl+C).
On connect, the current state is sent immediately (focus-changed with current window/workspace, mode-changed with current mode, etc.).
// =========================================================== Optionsinclude::util/conditional-options-header.adoc[]
-h, --help:: Print help
--all:: Subscribe to all event types
--no-send-initial:: Do not send the initial state on connect
// =========================================================== Argumentsinclude::./util/conditional-arguments-header.adoc[]
The following events can be subscribed to:
focus-changed:: Fired when window focus changes. Includes `windowId`, `workspace`.
focused-monitor-changed:: Fired when the focused monitor changes. Includes `workspace`, `monitorId`.
focused-workspace-changed:: Fired when the focused workspace changes. Includes `workspace`, `prevWorkspace`.
mode-changed:: Fired when the binding mode changes. Includes `mode`.
window-detected:: Fired when a new window is detected. Includes `windowId`, `workspace`, `appBundleId`, `appName`.
binding-triggered:: Fired when a keyboard binding is triggered. Includes `binding`, `mode`.
// =========================================================== Output Formatinclude::util/conditional-output-format-header.adoc[]
Events are output as JSON lines (one JSON object per line):
----{"_event":"focused-monitor-changed","monitorId":1,"workspace":"M"}{"_event":"focused-workspace-changed","prevWorkspace":"M","workspace":"M"}{"_event":"mode-changed","mode":"main"}{"_event":"focus-changed","windowId":28218,"workspace":"M"}----
// end::body[]
// =========================================================== Footerinclude::util/man-footer.adoc[]