i3-save-tree(1)

i3-save-tree1

Usage

i3-save-tree [{--workspace=name | number}] [--output=name]

Overview

Dumps a workspace (or an entire output) to stdout. The data is supposed to be edited a bit by a human, then later fed to i3 via the append_layout command.

The append_layout command will create placeholder windows, arranged in the layout the input file specifies. Each container should have a swallows specification. When a window is mapped (made visible on the screen) that matches the specification, i3 will put it into that place and kill the placeholder.

If neither argument is specified, the currently focused workspace will be used.

Options

--workspace=name|number

Specifies the workspace that should be dumped, e.g. 1. This can either be a name or the number of a workspace.

--output=name

Specifies the output that should be dumped, e.g. LVDS-1.

Version

Version 0.1

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

Author

Michael Stapelberg, "<michael at i3wm.org>"

From i3-wm 4.25.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.