---
name: "xlsclients"
section: "1"
platform: "linux"
package: "xorg-xlsclients"
version: "1.1.6-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xlsclients"
---

# xlsclients(1)

list client applications running on a display

## NAME

xlsclients - list client applications running on a display

## SYNOPSIS

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

xlsclients -help | -version
```

## DESCRIPTION

**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.

## SEE ALSO

[**X**(7)](/X/7.md), [**xwininfo**(1)](/xwininfo/1.md), [**xprop**(1)](/xprop/1.md)

## AUTHOR

Jim Fulton, MIT X Consortium