Repository navigation
libtmux 0.63.0 raises the minimum Python to 3.11 and brings the library in line with tmux 3.8. Pane.break_pane() now returns the destination window when it moves a window's only pane, and show_hook() reads the hooks tmux 3.8 added.
Highlights
- Breaking: Python 3.11+ is required. libtmux 0.62.0 was the last release supporting Python 3.10, which reached end of life in October 2026. On Python 3.10, pip keeps installing 0.62.0.
- Fix:
break_pane()returns the destination window (#879). Breaking out a window's only pane returns the destinationWindow, even if another client moved the pane first. On tmux 3.2a through 3.5 this could raiseIndexErrorafter the move had succeeded. - Fix: tmux 3.8 hooks and popups (#775).
show_hook()reads the hooks tmux 3.8 added, such aspane-createdandwindow-zoomed, with their sparse indices intact.display_popup()needs a terminal client to run its command on tmux 3.8. - Docs: task directories on the core classes. The
Server,Session,WindowandPaneclass pages group their methods by job (finding one thing, listing everything, sending input) and say what each call returns and raises. - Docs: every field described (#721). Option classes, the hook table and the format object carry the tmux manual's description for each field.
See the changelog for the full list.
What's Changed
- from_env(docs): Hide doctest setup with # doctest: +HIDE by @tony in #719
- Document dataclass fields that ship as bare autodoc stubs by @tony in #721
- Require ruff>=0.16.0 and adopt its default rule set by @tony in #722
- docs: Standardize via
CONTRIBUTING.md+WRITING.mdby @tony in #747 - Link libtmux.org and the package registry from the READMEs by @tony in #794
- ci(fix): Rebuild incompatible tmux caches by @tony in #835
- docs(feat[header]): Add the libtmux.org bars by @tony in #846
- fix(tests): fix flaky
test_capture_pane_flags[join_wrapped_numbers]by @tony in #655 - tmux(fix[3.8]): Support hooks and terminal fixtures by @tony in #825
- py(chore[floor]): Require Python 3.11 by @tony in #849
- docs(feat[header]): Link the port picker to home pages and add six ports by @tony in #852
- Server,Session,Window,Pane(docs): Add task directories by @tony in #857
- Pane(fix): Return the relinked sole-pane window by @tony in #879
Full Changelog: v0.62.0...v0.63.0