Download Latest Version
v1.74.0 - Improved docs, tmux 3.7a and 3.7b support source code.zip (1.3 MB)
Get an email when there's a new version of tmuxp
| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| README.md | 2026-07-04 | 2.5 kB | |
| v1.74.0 - Improved docs, tmux 3.7a and 3.7b support source code.tar.gz | 2026-07-04 | 1.1 MB | |
| v1.74.0 - Improved docs, tmux 3.7a and 3.7b support source code.zip | 2026-07-04 | 1.3 MB | |
| Totals: 3 Items | 2.4 MB | 0 | |
tmuxp 1.74.0 pairs a libtmux upgrade with a documentation overhaul. It bumps libtmux to 0.61.0 — hardening tmux 3.7 patch-line support — and teaches tmuxp debug-info to report the exact tmux patch release (3.7a/3.7b) instead of the numeric-normalized version. The docs also gain theme-aware inline diagrams and a concept-first rewrite that leads with what each feature is before its configuration.
Highlights
libtmux 0.61.0
The libtmux floor moves from ~=0.60.0 to ~=0.61.0, hardening tmux 3.7 patch-line support. libtmux's Pane.break_pane() now keeps tmux's own default window name on tmux 3.7a/3.7b instead of forcing libtmux, and a new get_version_str() helper exposes the raw tmux version string. tmux 3.2a–3.6 are unaffected.
tmuxp debug-info reports the exact tmux patch release
tmuxp debug-info now shows tmux's full version, keeping the point-release letter (for example 3.7a) that was previously normalized away to 3.7. Because tmux patch releases can differ in behavior, the precise release is what a bug report needs.
Themed diagrams across the docs
Diagrams now render as theme-aware inline graphics that follow the site's light/dark palette and code styling, replacing the old static ASCII art. The workspace-builders guide gains a load → build → attach flow diagram, and the examples page shows each pane example as a faithful tmux window layout.
Concept-first documentation pass
The docs now open with what each feature is before its configuration, in a consistent second-person voice, with advanced and Python-only material marked opt-in. New diagrams trace the plugin hook lifecycle, the CLI request flow, the workspace hierarchy, and what tmuxp load does inside an existing session.
Development
The build-time mermaid diagram renderer, previously bundled with the docs, now comes from the reusable sphinx-gp-mermaid package. Rendered output is unchanged.
What's Changed
- Docs: build-time mermaid + tmux-layout diagram rendering by @tony in https://github.com/tmux-python/tmuxp/pull/1071
- docs: voice-guide compliance pass, diagrams, and fixes by @tony in https://github.com/tmux-python/tmuxp/pull/1072
- Docs: consume sphinx-gp-mermaid, drop the vendored renderer by @tony in https://github.com/tmux-python/tmuxp/pull/1073
- libtmux 0.61.0 by @tony in https://github.com/tmux-python/tmuxp/pull/1074
Full Changelog: https://github.com/tmux-python/tmuxp/compare/v1.73.0...v1.74.