i3tree icon indicating copy to clipboard operation
i3tree copied to clipboard

Human-friendly display of i3's tree layout

OVERVIEW

i3tree is a program I wrote to help myself adjust to version 4 of the i3 tiling window manager. It displays the containers your windows are children of and what layout those containers are using.

INSTALLATION

i3tree requires an installation of the i3 window manager, perl, and the following perl module.

  • AnyEvent::I3

USAGE

Just run it.

EXAMPLES

$  i3tree
Workspace 1 (horizontal)
        Window foo@bar: ~
        Split (vertical)
                Window foo@bar: ~
                Window foo@bar: ~
Workspace 2 (vertical)
        Window foo@bar: ~
        Window foo@bar: ~

CONVENIENCE

You could either start i3tree from a running terminal, or launch it inside a floating window. Here's the configuration needed:

for_window [title="^i3tree$"] floating enable
bindsym $mod+t exec xterm -hold -title i3tree -e ~/path/to/i3tree

LIMITATIONS

i3tree shows containers from all workspaces. It could be useful to optionally limit this to only the current workspace.

THANKS

Thanks to everyone who has contributed to i3.