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.

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.

SUPPORTED PROTOCOLS¶

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.

OPTIONS¶

-h, --help

-v, --version

-w, --watch

-j, --json

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

--force-protocol protocol-name

AUTHOR¶

Leon Henrik Plickat