tmux-python / tmux-python/tmuxp

Add support for tmux 2.3's pane status text

Open
#384 4 comments 14 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement pinned
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.