Move i3 Window
move_windowMove the focused container or a selected window by class/title to a direction, workspace, output, scratchpad, or screen center.
Instructions
Move the focused container (or one matched by class/title/instance/mark/con_id) to exactly one destination: a direction (with pixel amount), a workspace, an output, the scratchpad, or a screen position (center). Reversible; returns per-command success. To change focus rather than move, use focus_window; to move whole workspaces between monitors, use manage_workspace.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mark | No | Select the window to move by mark (criteria). | |
| title | No | Select the window to move by title (criteria). | |
| con_id | No | Select the window to move by exact i3 id (criteria). | |
| instance | No | Select the window to move by WM_CLASS instance (criteria). | |
| amount_px | No | Pixels to move when `direction` is set. Default 10. | |
| direction | No | Move the container this direction. | |
| to_center | No | Center a floating container on its output. Default false. | |
| to_output | No | Move the container to this output, e.g. 'HDMI-1'. | |
| to_workspace | No | Move the container to this workspace (name or number). | |
| window_class | No | Select the window to move by X11 class (criteria). | |
| to_scratchpad | No | Move the container to the scratchpad. Default false. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | First error message across the payload, or null on full success. | |
| success | Yes | True only if every command in the payload succeeded. | |
| outcomes | No | Per-command outcomes, in payload order. |