xlsclients(1)

xlsclients1

List client applications running on a display

Usage

xlsclients [-display displayname] [-a] [-l] [-m maxcmdlen]

xlsclients {-help | -version}

Overview

Xlsclients is a utility for listing information about the client applications running on a display. It may be used to generate scripts representing a snapshot of the user's current session.

Options

-display displayname

This option specifies the X server to contact.

-a

This option indicates that clients on all screens should be listed. By default, only those clients on the default screen are listed.

-l

List in long format, giving the window name, icon name, and class hints, in addition to the machine name and command string shown in the default format.

-m maxcmdlen

This option specifies the maximum number of characters in a command to print out. The default is 10000.

-help

Print the program usage and exit.

-version

Print the program version and exit.

Environment

DISPLAY

To get the default host, display number, and screen.

Releases

11 releases since Debian 4.0 (Etch); the text changed 6 times.

  1. 4.0–5.0
  2. 6.0
  3. 7
  4. 8–9
  5. 10–12
  6. 13
  7. Arch

-help since Arch Linux 2026-11-01; -version since Debian 8 (Jessie).

Author

Jim Fulton, MIT X Consortium

From xorg-xlsclients 1.1.6-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.