mirror of
https://github.com/swaywm/sway.git
synced 2026-06-13 14:33:19 -04:00
54b95f6196
--workspace was documented as accepting a name or a number, but the lookup only compared against the IPC name, so common workspaces such as "1: web" (num=1) could not be selected with --workspace 1. Parse a numeric argument and also compare against the num field. Update the manpage accordingly.
54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
sway-save-tree(1)
|
|
|
|
# NAME
|
|
|
|
sway-save-tree - Dump a workspace's tiling tree as append_layout-compatible JSON.
|
|
|
|
# SYNOPSIS
|
|
|
|
_sway-save-tree_ --workspace <name>
|
|
|
|
# DESCRIPTION
|
|
|
|
Reads the live tree of the running sway instance over the IPC socket, walks
|
|
the named workspace, prunes runtime fields, and emits a JSON document
|
|
suitable for *swaymsg append_layout*(5). Each leaf view becomes a
|
|
placeholder entry whose *swallows* array contains a regex-anchored match on
|
|
the view's *app_id* (Wayland) or *class* / *instance* (xwayland).
|
|
|
|
The output is sent to standard output. Pre-existing placeholders that were
|
|
loaded by *append_layout* and have not yet swallowed a window are echoed
|
|
verbatim from their *swallows* array.
|
|
|
|
This is the sway counterpart of i3-save-tree(1).
|
|
|
|
# OPTIONS
|
|
|
|
*--workspace* <name>
|
|
Name or number of the workspace to dump. Required. If the argument is
|
|
all digits, it is also matched against the workspace's number, so
|
|
*--workspace 1* finds a workspace named "1: web".
|
|
|
|
*-h, --help*
|
|
Show help and exit.
|
|
|
|
# LIMITATIONS
|
|
|
|
Floating windows are skipped in this release; only tiling children of the
|
|
workspace are emitted. A warning is printed to stderr when floating windows
|
|
are present.
|
|
|
|
# EXAMPLES
|
|
|
|
Save the layout of workspace 1 to a file, kill the running windows, and
|
|
restore the layout:
|
|
|
|
```
|
|
$ sway-save-tree --workspace 1 > /tmp/layout.json
|
|
$ swaymsg [workspace=1] kill
|
|
$ swaymsg append_layout /tmp/layout.json
|
|
```
|
|
|
|
# SEE ALSO
|
|
|
|
*sway*(5), *sway*(1), *swaymsg*(1)
|