Window.list_panes
Behavior: Live acquisition.
Source and package
- Qualified name
-
LibTmux:: Window# list _panes - Module
- LibTmux
- Declared in
Window- Package
- libtmux
- Source
- gems/libtmux/lib/libtmux/entity.rb
- Other languages
- Perlmethod Erlangfunction PowerShellcmdlet Juliafunction Elixir Haskell Common Lispfunction Python Lua TypeScriptRustGoJavaC#C++SwiftKotlinScalaOCamlfunction F#function Clojurefunction
-
Description#
Behavior contract: Live acquisition.
Examples#
List panes across the server, within one session, and within one window. Use Ruby 3.3 or newer with Bundler, and tmux 3.3a or newer, on Unix with
/bin/catand/bin/shavailable. In an empty directory, save thisGemfile:source "https://rubygems.org"gem "libtmux", "0.1.2"Save this complete program as
list_panes.rb. ItsServer.startblock owns a private tmux server and stops it on exit, including after an error. View source# frozen_string_literal: truerequire "libtmux"beginLibTmux::Server.start do |server|work = server.new_session(name: "work", command: ["/bin/cat"], receipt: true)work.pane.split(direction: :horizontal, command: ["/bin/cat"])server.new_session(name: "other", command: ["/bin/cat"])puts "server panes: #{server.list_panes.length}"puts "work panes: #{work.entity.list_panes.length}"puts "window panes: #{work.window.list_panes.length}"endrescue StandardError => errorwarn "#{error.class}: #{error.message}"exit 1endInstall the gem and run the program. An operation or cleanup error makes it exit unsuccessfully:
Terminal window $ bundle install && \bundle exec ruby list_panes.rbExpected output:
server panes: 3work panes: 2window panes: 2
tmux command#
The tmux commands behind list_panes.
list-panes -t window scope, cmd_list_panes_window tmux C API#
The C declarations in tmux that implement these commands.
Guides#
Pages that discuss list_panes.
In other ports#
List a window's panes
| Language | Equivalent |
|---|---|
| Python | libtmux |
| PowerShell | Lib Use the -Window parameter set to acquire panes in one window. |
| Julia | Lib panes with a captured WindowSnapshot reads panes in that window; missing coverage is an error. |
| Erlang | tmux Pass panes, a captured physical window and its snapshot for a local relationship read. |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| Common Lisp | libtmux: panes traverses a captured window without contacting tmux. |
| TypeScript | window |
| Rust | window |
| Go | tmux |
| Java | io |
| Clojure | libtmux Traverses one capture locally. It does not issue a list-panes command. |
| Kotlin | io |
| Scala | io |
| C# | Lib |
| F# | Lib Builds a deferred pane query from one LibTmux.Window and its server. Query.list acquires panes scoped to that window ID. |
| C++ | libtmux:: |
| Swift | Snapshot |
| OCaml | Libtmux Reads captured panes in one global window without I/O. |
| Perl | Lib Reads this physical window’s captured panes without I/O. |
No equivalent is recorded in Lua or Elixir.