Skip to content

Commit fc5e6c4

Browse files
committed
docs(CHANGES): tmux_cmd UTF-8 encoding fix for non-UTF-8 locales
why: Document the user-visible bug fix for the 0.58.x release. what: - Add Fixes entry for tmux_cmd encoding on non-UTF-8 locales
1 parent 55c33af commit fc5e6c4

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

CHANGES

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,17 @@ $ uvx --from 'libtmux' --prerelease allow python
4545
_Notes on the upcoming release will go here._
4646
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
4747

48+
### Fixes
49+
50+
#### Subprocess encoding on non-UTF-8 locales (#679)
51+
52+
{class}`~libtmux.common.tmux_cmd` and {class}`~libtmux._internal.control_mode.ControlMode`
53+
now pass `encoding="utf-8"` to `subprocess.Popen`, ensuring tmux output
54+
is decoded correctly regardless of the system locale. Previously, on
55+
non-UTF-8 locales, the {data}`~libtmux.formats.FORMAT_SEPARATOR` character
56+
(U+241E) was corrupted during decoding, causing list accessors
57+
({attr}`~libtmux.Server.sessions`, etc.) to return empty results.
58+
4859
## libtmux 0.57.1 (2026-05-18)
4960

5061
Restores the "lenient-by-default" behavior for

0 commit comments

Comments
 (0)