LSWT(1)

NAME

lswt - list Wayland toplevels

SYNOPSIS
lswt [-j] [--json] [-c custom-format] [--custom custom-format]
lswt [-h] [--help]
lswt [-w] [--watch]
lswt [-v] [--version]

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
    Print help text and exit.

-v, --version
    Print version and exit.

-w, --watch
    Run in watch mode.

-j, --json
    Output data in the JSON format.

-c custom-format, --custom custom-format
    Output data in the CSV format. A custom format must be provided which specifies which information about the toplevels lswt should print. This format is a string where each character corresponds to one field. Fields can be specified multiple times. At least one field must be provided. The following fields are supported:
        CHARACTER | FIELD
        t | title
        a | app-id
        i | unique identifier
        A | activated? ("focused?")
        f | fullscreen?
        m | minimized?
        M | maximized?

AUTHOR

Leon Henrik Plickat (leonhenrik.plickat@stud.uni-goettingen.de)