# LibTmux::Server#list_clients

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Ruby
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-ruby/blob/da7b6191b9439e3c84fa1c9eeaa9168263ee7af4/gems/libtmux/lib/libtmux/operations.rb#L93
- **Page:** https://libtmux.org/en/ruby/v0.1.1/reference/libtmux-server-list_clients/

```
def list_clients: (
  ?timeout: ::Numeric,
  ?cancel: untyped
) -> ::Array[
  {
    name: ::String,
    pid: ::Integer,
    created: ::Integer,
    tty: ::String?,
    session_id: ::String?,
    control: bool
  }
]
```

Behavior: Live acquisition.

Behavior contract: Live acquisition.

## Parameters

- `timeout` (`::Numeric`)
- `cancel` (`untyped`)

## tmux command

The tmux commands behind `list_clients`.

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

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_list_clients_entry`](/en/tmux/latest/reference/c-variable-cmd_list_clients_entry/) (attribute)
- [`cmd_list_clients_exec`](/en/tmux/latest/reference/c-function-cmd-list-clients-c-cmd_list_clients_exec/) (function)

## In other ports

List the server's attached clients

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Server.clients`](/en/py/latest/reference/libtmux-server-clients/) (property) |
| 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. |
| Elixir | [`LibTmux.Snapshot.clients/1`](/en/elixir/latest/reference/libtmux-snapshot-clients-1/) (function). Returns a `Selection` of captured attached clients without contacting tmux. |
| 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.clients`](/en/java/latest/reference/io-github-libtmux-server-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) |
| C# | [`LibTmux.Server.Clients`](/en/csharp/latest/reference/libtmux-server-clients/) (property) |
| 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. |
| C++ | [`libtmux::Server::clients`](/en/cxx/latest/reference/libtmux-server-clients/) (method) |
| Swift | [`Server.clients()`](/en/swift/latest/reference/server-clients()/) (method) |

No equivalent is recorded in Lua.