tmux-python / tmux-python/tmuxp
Add support for tmux 2.3's pane status text
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 248
- Avg merge
- 2h 13m
- Merged PRs (30d)
- 1
Description
Since version 2.3 tmux is able to assign a title to a pane which can be shown using the pane-border-status option. Additionally the option pane-border-format allows to set that title. However, this option applies to all panes and if you want to have per-pane specific title you have to use escape sequences, at least I'm not aware of a more elegant solution. Using that, it is indeed possible to use this functionality with the current version of tmuxp, but the yaml file doesn't look very pretty:
- shell_command:
- printf '\033]2;%s\033\\' 'pane title'
- actual_command
It would be nice to add a dedicated attribute for that, something like title or status that essentially does the ugly printf above.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing how tmuxp reads YAML pane definitions and handles shell_command entries when creating panes. Compare that path with tmux 2.3's per-pane title escape sequence behavior. Done means a dedicated per-pane title or status attribute works without requiring users to write the printf sequence themselves.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, yaml
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100