C++ API

method libtmux-cxx latest

Server.panes

Source and package

Qualified name: libtmux::Server::panes
Namespace: libtmux
Declared in: Server
Package: libtmux-cxx
Source: include/libtmux/server.hpp
Other languages: Perlmethod Erlangfunction PowerShellcmdlet Juliafunction Elixirfunction Haskell Common Lispfunction PythonRubyLuaTypeScriptRustGoJavaC#SwiftKotlinScalaOCamlF#function Clojurefunction

[[C++ nodiscard attributeAsks the compiler to warn when a result is discarded. An explicit cast to void acknowledges that the result is intentionally ignored.Language documentation]] expected<std::vector<Pane>, CommandFailure> panes() const; method readonly [source] ¶

Examples#

List server objects. Read independent snapshots of every session, window, pane, and client. Iterating these vectors makes no further tmux calls. The detached fixture has one session, one window, one pane, and no attached clients. libtmux-cxx is not published to a package registry yet, so this builds it from its repository. Use Clang 18 or newer with libc++, CMake 3.25 or newer, Ninja, Git, and tmux 3.3a or newer on Linux. In an empty directory, fetch the documented library revision:

$ git clone https://github.com/libtmux/libtmux-cxx.git libtmux-source && \
  git -C libtmux-source checkout 542fdc204ff3cfa56f5484327cda0c69bad2307d

Build and install the C++23 library and its public testing component into this directory:

$ cmake -S libtmux-source -B libtmux-build -G Ninja \
    -DCMAKE_TOOLCHAIN_FILE="$PWD/libtmux-source/cmake/toolchains/clang-libcxx.cmake" \
    -DCMAKE_C_COMPILER=clang \
    -DCMAKE_CXX_COMPILER=clang++ \
    -DCMAKE_BUILD_TYPE=Release \
    -DLIBTMUX_BUILD_TESTS=OFF \
    -DLIBTMUX_BUILD_EXAMPLES=OFF \
    -DLIBTMUX_BUILD_TESTING_LIBRARY=ON && \
  cmake --build libtmux-build --parallel 2 && \
  cmake --install libtmux-build --prefix "$PWD/libtmux-prefix"

Save this complete consumer project as CMakeLists.txt: View source

cmake_minimum_required(VERSION 3.25)
project(libtmux_api_example LANGUAGES CXX)

find_package(libtmux REQUIRED COMPONENTS testing)

add_executable(api_example main.cpp)
target_link_libraries(api_example PRIVATE libtmux::libtmux libtmux::testing)

Save this complete program as main.cpp. ScopedTmuxServer owns a private daemon and stops it when the program exits. Ordinary applications use Server for their own socket; these examples use the fixture until setup moves to ordinary server objects. View source

#include <cstdio>

#include <libtmux/libtmux.hpp>
#include <libtmux/testing/scoped_server.hpp>

int main() {
  // The fixture owns this private server and cleans it up on every return path.
  auto fixture = libtmux::test::ScopedTmuxServer::start({
      .session_name = "api",
      .socket_namespace = libtmux::test::SocketNamespace::consumer("api"),
  });
  if (!fixture.has_value()) {
    std::fprintf(stderr, "%s\n", fixture.error().c_str());
    return 1;
  }
  auto server = libtmux::Server::at_socket_path(fixture->socket_path());
  if (!server.has_value()) {
    std::fprintf(stderr, "%s\n", server.error().diagnostic.c_str());
    return 1;
  }

  const auto sessions = server->sessions();
  const auto windows = server->windows();
  const auto panes = server->panes();
  const auto clients = server->clients();
  if (!sessions.has_value()) {
    std::fprintf(stderr, "%s\n", sessions.error().diagnostic.c_str());
    return 1;
  }
  if (!windows.has_value()) {
    std::fprintf(stderr, "%s\n", windows.error().diagnostic.c_str());
    return 1;
  }
  if (!panes.has_value()) {
    std::fprintf(stderr, "%s\n", panes.error().diagnostic.c_str());
    return 1;
  }
  if (!clients.has_value()) {
    std::fprintf(stderr, "%s\n", clients.error().diagnostic.c_str());
    return 1;
  }
  if (sessions->size() != 1 || windows->size() != 1 || panes->size() != 1 ||
      !clients->empty()) {
    std::fputs("unexpected detached server contents\n", stderr);
    return 1;
  }
  std::printf("sessions=%zu windows=%zu panes=%zu clients=%zu\n", sessions->size(),
              windows->size(), panes->size(), clients->size());
  return 0;
}

Build against the installed library and run the saved program. An operation error produces a failing exit status:

$ cmake -S . -B build -G Ninja \
    -DCMAKE_PREFIX_PATH="$PWD/libtmux-prefix" \
    -DCMAKE_CXX_COMPILER=clang++ \
    -DCMAKE_CXX_FLAGS=-stdlib=libc++ && \
  cmake --build build --parallel 2 && \
  ./build/api_example

Expected output:

sessions=1 windows=1 panes=1 clients=0

tmux command#

The tmux commands behind panes.

list-panes -a server scope, cmd_list_panes_server

tmux C API#

The C declarations in tmux that implement these commands.

cmd_list_panes_entry cmd_list_panes_server

In other ports#

List the server's panes

Equivalents of List the server's panes in other languages
Language	Equivalent
Python	`libtmux.Server.panes`
Ruby	`LibTmux::Server#list_panes`
Lua	`libtmux.Snapshot.panes`
PowerShell	`LibTmux\Get-TmuxPane` Use the `-Server` parameter set to acquire panes across the server.
Julia	`LibTmux.panes` `panes` with a `Snapshot` reads every captured physical pane. Use `paneoccurrences` for session placements.
Erlang	`tmux_snapshot:panes/1` Returns unique captured physical panes without tmux I/O.
Elixir	`LibTmux.Snapshot.panes/1` Returns a `Selection` of every captured physical pane without contacting tmux.
Haskell	No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
Common Lisp	`libtmux:panes` `panes` on a snapshot returns captured physical panes once each.
TypeScript	`server.Server.panes`
Rust	`server.Server.panes`
Go	`tmux.Server.Panes`
Java	`io.github.libtmux.Server.panes`
Clojure	`libtmux.core/panes!` Acquires a new graph and returns its pane occurrences.
Kotlin	`io.github.libtmux.kotlin.Server.panes`
Scala	`io.github.libtmux.scaladsl.Server.panes`
C#	`LibTmux.Server.Panes`
F#	`LibTmux.FSharp.Server.panes` Builds a deferred pane query on the shared .NET `LibTmux.Server`. `Query.list` acquires panes across that server.
Swift	`Server.panes()`
OCaml	`Libtmux.Snapshot.panes`
Perl	`LibTmux::Snapshot::panes` One entry per captured physical pane; raw listings preserve contextual rows separately.

Scripting & web

Compiled & native

JVM

.NET

BEAM

tmux

Server.panes

Examples#

tmux command#

tmux C API#

In other ports#

Examples#

tmux command#

tmux C API#

In other ports#

Related types#