# libtmux.Server.clients

- **Module:** libtmux
- **Package:** libtmux
- **Language:** Python
- **Kind:** property
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/server.py#L2461
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-server-clients/

tmux command: [`list-clients`](/en/tmux/latest/manual/list-clients/)

```
libtmux.Server.clients(self) -> QueryList[Client]
```

Clients attached to this tmux server.

Each attached terminal is a separate :class:`Client`. ``server.clients``
returns the typed view; ``client.client_readonly``, ``client.client_termtype``,
``client.client_session`` etc. read tmux's ``client_*`` format tokens.

Returns an empty :class:`~libtmux._internal.query_list.QueryList` when
tmux's [`list-clients`](/en/tmux/latest/manual/list-clients/) fails for any reason — no running daemon, a
missing socket, a permission error, or a subprocess failure. To
distinguish "no clients attached" from "tmux unreachable", call
:meth:`Server.is_alive` or :meth:`Server.raise_if_dead`.

## Examples

```python
>>> with control_mode() as ctl:
...     names = [c.client_name for c in server.clients]
...     ctl.client_name in names
True
```

## Returns

:class:`~libtmux._internal.query_list.QueryList` of :class:`Client`

## In other ports

### List the server's attached clients

- PowerShell: [`LibTmux\Get-TmuxClient`](/en/powershell/latest/reference/libtmux-get-tmuxclient/) (cmdlet). Acquires attached clients through [`-Server`](/en/powershell/latest/reference/libtmux-get-tmuxclient/#LibTmux%5CGet-TmuxClient.parameter.Server) and returns shared .NET `LibTmux.Client` objects.
- Julia: [`LibTmux.clients`](/en/julia/latest/reference/libtmux-clients/) (function). `clients` reads attached clients from a captured `Snapshot` without contacting tmux.
- Ruby: [`LibTmux::Server#list_clients`](/en/ruby/latest/reference/libtmux-server-list_clients/) (method)
- TypeScript: [`server.Server.clients`](/en/ts/latest/reference/server-server-clients/) (method)
- Rust: [`server.Server.clients`](/en/rs/latest/reference/server-server-clients/) (method)
- Go: [`tmux.Server.Clients`](/en/go/latest/reference/tmux-server-clients/) (method)
- Java: [`io.github.libtmux.Server.Server.clients`](/en/java/latest/reference/io-github-libtmux-server-server-clients/) (method)
- C#: [`LibTmux.Server.Clients`](/en/csharp/latest/reference/libtmux-server-clients/) (property)
- C++: [`libtmux::Server::clients`](/en/cxx/latest/reference/libtmux-server-clients/) (method)
- Swift: [`Server.clients()`](/en/swift/latest/reference/server-clients()/) (method)
- Kotlin: [`io.github.libtmux.kotlin.Server.clients`](/en/kotlin/latest/reference/io-github-libtmux-kotlin-server-clients/) (method)
- Scala: [`io.github.libtmux.scaladsl.Server.clients`](/en/scala/latest/reference/io-github-libtmux-scaladsl-server-clients/) (method)
- F#: [`LibTmux.FSharp.Server.clients`](/en/fsharp/latest/reference/libtmux-fsharp-server-clients/) (function). Builds a deferred client query on the shared .NET `LibTmux.Server`. `Query.list` acquires attached clients.