aerospace fork
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147= aerospace-move(1)include::util/man-attributes.adoc[]// tag::purpose[]:manpurpose: Move the focused window in the given direction// end::purpose[]:manname: aerospace-move
// =========================================================== Synopsis== Synopsis[verse]// tag::synopsis[]aerospace move [-h|--help] [--window-id <window-id>] [--boundaries <boundary>] [--boundaries-action <boundary-action>] [--fail-if-fullscreen] [--fail-if-macos-native-fullscreen] (left|down|up|right)
// end::synopsis[]
// =========================================================== Description== Description
// tag::body[]Move the focused window in the given direction. See the "Examples" section for more details.
Deprecated name: `move-through`
// =========================================================== Optionsinclude::./util/conditional-options-header.adoc[]
-h, --help:: Print help
--window-id <window-id>::include::./util/window-id-flag-desc.adoc[]
--boundaries <boundary>::Defines move boundaries. +`<boundary>` possible values: `(workspace|all-monitors-outer-frame)`. +The default is: `workspace`
--boundaries-action <boundary-action>::Defines the behavior when requested to move across the `<boundary>`. +`<boundary-action>` possible values: `(stop|fail|create-implicit-container)`. +The default is: `create-implicit-container`
--fail-if-fullscreen::Exit with non-zero code if the target window is fullscreen by the `fullscreen` command.
--fail-if-macos-native-fullscreen::Exit with non-zero code if the target window is in macOS native fullscreen.
// =========================================================== Examplesinclude::util/conditional-examples-header.adoc[]
. Given this layout+----h_tiles├── window 1 (focused)└── window 2----+`move right` will result in the following layout+----h_tiles├── window 2└── window 1 (focused)----
. Given this layout+----h_tiles├── window 1├── window 2 (focused)└── v_tiles ├── window 3 └── window 4----+`move right` will result in the following layout+----h_tiles├── window 1└── v_tiles ├── window 3 ├── window 2 (focused) └── window 4----
. Given this layout+----h_tiles├── window 1└── v_tiles ├── window 3 ├── window 2 (focused) └── window 4----+`move left` will result in the following layout+----h_tiles├── window 1├── window 2 (focused)└── v_tiles ├── window 3 └── window 4----
. *Implicit container example*+In some cases, `move` needs to implicitly create a container to fulfill your command.+Given this layout+----h_tiles├── window 1├── window 2 (focused)└── window 3----+`move up` will result in the following layout+----v_tiles├── window 2 (focused)└── h_tiles ├── window 1 └── window 3----+`v_tiles` is an implicitly created container.+*Remark*: If `--boundaries` is set to `all-monitors-outer-frame` and there is a monitor in the `up` direction,the implicit container isn't created.+Instead, `window 2` would be moved to the monitor above the current.
// end::body[]
// =========================================================== Footerinclude::util/man-footer.adoc[]