Core LibrarystableAPI Reference

Choose documentation 3

stable

Current version

stable
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

Python API

class libtmux stable

Obj

Dataclass of generic tmux object.

Source and package
Qualified name
libtmux.neo.Obj
Module
libtmux.neo
Package
libtmux
Source
src/libtmux/neo.py
class libtmux.neo.Obj

Description#

Notes

tmux may return fields from an object's active children along with the object itself. The practical consequence:

  • On a Session row (list-sessions), every pane_* and window_* field resolves to the session's current window's active pane — not "the session's pane" (no such thing). session.active_window.window_id and session.active_window.active_pane.pane_id are the canonical accessors for the same values.
  • On a Window row (list-windows), every pane_* field resolves to that window's active pane.
  • On a Client row (list-clients), every session_*, window_*, and pane_* field reflects the client's attached session, current window, and active pane.

A reader who treats session.pane_id as the literal session's pane id (rather than "active pane of this session's current window") will be surprised when the active window changes.

Discussed in Architecture

Members180#

Esc

Type to search.

Reference preview Open reference