Smart tmux window names like IDE tablines
Project description
tmux-window-name
Smart tmux window names like IDE tablines.
Quick Example
Windows with same directory basename get disambiguated:
| Path | Display |
|---|---|
~/projects/app |
projects/app |
~/work/app |
work/app |
~/projects/app (nvim) |
nvim:projects/app |
See tests for more scenarios.
Installation
Recommended: Use with Oh My Tmux for best experience.
Homebrew (recommended)
brew install leftrk/tap/tmux-window-name
Add to ~/.tmux.conf:
run-shell $(brew --prefix tmux-window-name)/libexec/tmux_window_name.tmux
TPM
set -g @plugin 'leftrk/tmux-window-name'
Press prefix + I to install.
Common Options
| Option | Description | Default |
|---|---|---|
@tmux_window_name_max_name_len |
Max window name length | 20 |
@tmux_window_name_use_tilde |
Replace $HOME with ~ |
False |
@tmux_window_name_icon_style |
Icon display style | 'name' |
Example:
set -g @tmux_window_name_max_name_len "30"
set -g @tmux_window_name_icon_style "'name_and_icon'"
See docs/options.md for all configuration options.
Hooks
Automatic rename after nvim launch/exit or directory change.
See docs/hooks.md for examples.
Notes
- Load before
tmux-resurrectif using it tmux rename-window ""re-enables auto-rename after manual rename
Development
uv sync --group dev
uv run pytest
uv run ruff format
License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tmux_window_name-1.0.3.tar.gz.
File metadata
- Download URL: tmux_window_name-1.0.3.tar.gz
- Upload date:
- Size: 39.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
10de280a0e3c0264ef212a514c68e1b8226998f2e98e36e907548643583eb1f9
|
|
| MD5 |
c9e22934f99679a72e97c2ac8dece448
|
|
| BLAKE2b-256 |
fe75792eb1fb5b3e6bd1590d4ab125cf69f502a7a6d23ddb337736ac29f46566
|
File details
Details for the file tmux_window_name-1.0.3-py3-none-any.whl.
File metadata
- Download URL: tmux_window_name-1.0.3-py3-none-any.whl
- Upload date:
- Size: 9.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
02978c5196b0e5b3122d9f06924b44604181e83c9a1297ee403ca51dfc239c85
|
|
| MD5 |
e486a15349c31467da258e460e5a26b8
|
|
| BLAKE2b-256 |
d329371995e596d7d9b02240166f9530bbf468d02fd4ecbe631cdfe8ddd06e8e
|
