NAME¶

lswt - list Wayland toplevels

SYNOPSIS¶

DESCRIPTION¶

lswt lists all toplevels ("Windows") advertised by a Wayland server.

The default output prints the title and app-id the toplevels and - if available - their state in human readable form.

The state is a four wide character field, corresponding to the four possible toplevel states: maximized, minimized, activated and fullscreen. If one of these states is true for a toplevel, the respective character in the field is set to the first letter of the state name, otherwise it is -.

lswt provides two output formats intended to be machine parseable: JSON and CSV. If the CSV output is chosen, a custom format must be provided, which specifies the information about the toplevels lswt should print. The JSON output is versioned.

The information is querried from the Wayland server via one of the following protocols:

• ext-foreign-toplevel-list-v1 (preferred)
• wlr-foreign-toplevel-management-unstable-v1

As of now, only the ext- protocol supports unique toplevel IDs and only the wlr- protocol supports toplevel states.

lswt also supports a watch mode, which will run continuosly and log whenever toplevels change their app-id or title. The watch mode is incompatible with the JSON and CSV output formats.

OPTIONS¶

-h, --help

-v, --version

-w, --watch

-j, --json

-c custom-format, --custom custom-format

AUTHOR¶

Leon Henrik Plickat