https://github.com/imomaliev/tmux-peacock
Tmux per session color
https://github.com/imomaliev/tmux-peacock
tmux tmux-plugin tmux-theme
Last synced: 12 months ago
JSON representation
Tmux per session color
- Host: GitHub
- URL: https://github.com/imomaliev/tmux-peacock
- Owner: imomaliev
- License: mit
- Created: 2021-03-14T16:53:16.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-30T20:39:07.000Z (over 1 year ago)
- Last Synced: 2025-02-28T17:56:17.851Z (over 1 year ago)
- Topics: tmux, tmux-plugin, tmux-theme
- Language: Shell
- Homepage:
- Size: 13.7 KB
- Stars: 28
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tmux Peacock
Plugin that changes tmux styles based on session name.
[](https://asciinema.org/a/399925)
### Installation with Tmux Plugin Manager (recommended)
Add plugin to the list of TPM plugins:
```tmux.conf
set -g @plugin 'imomaliev/tmux-peacock'
```
Press prefix + I to install it.
### Manual Installation
Clone the repo:
```bash
$ git clone https://github.com/imomaliev/tmux-peacock.git ~/clone/path
```
Add this line to your .tmux.conf:
```tmux.conf
run-shell ~/clone/path/peacock.tmux
```
Reload TMUX environment with:
```bash
$ tmux source-file ~/.tmux.conf
```
### Configurations
#### Customize styles
If you would like to config your status bar you could use personalized hooks for session and window styles
```tmux.conf
set-option -g '@peacock:hooks:session-style' "/path/to/hook.sh"
set-option -g '@peacock:hooks:window-style' "/path/to/hook.sh"
```
This hooks are expected to be executable `.sh` files.
In which you could set desired tmux config and styles on per session basis. `$TMUX_PEACOCK_SESSION_COLOUR` env variable is provided.
Here are some examples from my dotfiles
[tmux.conf](https://github.com/imomaliev/dotfiles/blob/7eebbc6e1b68240eba9cf76386db6bbdfb09435f/roles/tmux/files/tmux.conf#L76)
[session-style-hook](https://github.com/imomaliev/dotfiles/blob/7eebbc6e1b68240eba9cf76386db6bbdfb09435f/roles/tmux/files/hooks/set_session_style.sh)
### Inspirations
Tmux peacock inspired by https://github.com/johnpapa/vscode-peacock
### License
[MIT](LICENSE)