Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/charlietag/tmux-split-statusbar
tmux plugin for splitting status bar into 2 parts - window + left/right status
https://github.com/charlietag/tmux-split-statusbar
tmux tmux-configs tmux-plugin
Last synced: 3 months ago
JSON representation
tmux plugin for splitting status bar into 2 parts - window + left/right status
- Host: GitHub
- URL: https://github.com/charlietag/tmux-split-statusbar
- Owner: charlietag
- Created: 2019-11-06T01:25:30.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-10-30T14:45:26.000Z (about 1 year ago)
- Last Synced: 2024-04-18T16:01:41.277Z (7 months ago)
- Topics: tmux, tmux-configs, tmux-plugin
- Language: Shell
- Homepage:
- Size: 131 KB
- Stars: 21
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-tmux - tmux-split-statusbar - window + left/right status (Status Bar)
README
# Tmux Plugin -split status bar
This is an plugin that split stats bar into 2 parts (lines)
`window part` - First line
`status-left / status-right` part - Second line
This plugin provides function to hide status-left / status-right as well, if you want to focus, pure silence environment.
This plugin is compatible with Tmux plugin manager([TPM](https://github.com/tmux-plugins/tpm))
This pllugin should work with any themes well.
# Installation
## Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)
### Notice:
Due to using the command set -g**a** status-left / status-right
`And it would be better put "tmux-split-statusbar" config lines **AFTER** `status style like` setup !`
### Requirements:
Requirements 1 : Make sure set these config lines **AFTER** `theme plugin`
(keep this plugin at the very bottom of tmux.conf)
Better **JUST** before this line
```bash
run -b '~/.tmux/plugins/tpm/tpm'
```
Requirements 2 : `tmux` version 3.0 (or higher), `bash`.
Add plugin to the list of TPM plugins in `.tmux.conf`:
set -g @plugin 'charlietag/tmux-split-statusbar'
Hit `prefix + I` to fetch the plugin and source it.
Status bar should be splited now
## Manual Installation
Clone the repo:
$ git clone https://github.com/charlietag/tmux-split-statusbar.git ~/clone/path
Add this line to the bottom of `.tmux.conf`:
run-shell ~/clone/path/tmux-split-statusbar.tmux
Reload TMUX environment:
# type this in terminal
$ tmux source-file ~/.tmux.conf
Status bar should be splited now
# Examples
Status bar splited (on): double lines
Status bar splited (off): single line
Status bar hide (on)
Status bar hide (off)
# Customization
Here are all available options with their default values:
```bash
@split-statusbar-mode 'on' # [ on | off]
@split-statusbar-swap-lines 'off' # [ on | off ]
# Enable this option to swap rows,
# may be useful for those who prefer a status bar on top:
# set -g status-position top
@split-statusbar-bindkey '-n F11' # [ M-s | -n F11 | ... ]
# bindkey for toggle statusbar-mode
# define yourself just like bind-key, default: M-s
@split-status-hide-bindkey '-n F12' # [ M-d | -n F12 | ... ]
# bindkey for status-left / status-right hiding
# define yourself just like bind-key, default: M-d
```
Don't forget to reload tmux environment (`$ tmux source-file ~/.tmux.conf`)
after you do this.
# Usage
Sample config in ~/.tmux.conf
```bash
set -g @plugin 'charlietag/tmux-split-statusbar'
set -g @split-statusbar-mode 'on' # [ on | off]
set -g @split-statusbar-swap-lines 'off' # [ on | off]
set -g @split-statusbar-bindkey '-n F11' # [ M-s | -n F11 | ... ]
# bindkey for toggle statusbar-mode
# define yourself just like bind-key, default: M-s
set -g @split-status-hide-bindkey '-n F12' # [ M-d | -n F12 | ... ]
# bindkey for status-left / status-right hiding
# define yourself just like bind-key, default: M-d
```
# Also read
- [.tmux.conf](https://github.com/charlietag/tmux_settings/blob/master/tmux.conf) - Tmux configuration sample by CharlieTag
# Other goodies
- [tmux-themes](https://github.com/charlietag/tmux-themes) - simple colorful theme made by CharlieTag
# License
[MIT license](https://opensource.org/licenses/MIT)
# Change Log
* 2020/07/01
* https://github.com/charlietag/tmux-split-statusbar/compare/v0.0.0...v0.0.1
* fully compatible with https://github.com/tmux-plugins/tmux-continuum (auto-save-session in hide status mode)
* add reload function to **reinitialize status bar** (for working with tmux themes like [charlietag/tmux-themes](https://github.com/charlietag/tmux-themes))
* Use the following command to **reset status bar to new themes**
```bash
~/.tmux/plugins/tmux-split-statusbar/tmux-split-statusbar.tmux reload
```
* 2021/07/14
* https://github.com/charlietag/tmux-split-statusbar/compare/v0.0.1...v0.0.2
* Fix issue Unwanted characters in window status #1
* https://github.com/charlietag/tmux-split-statusbar/issues/1
* 2023/01/13
* https://github.com/charlietag/tmux-split-statusbar/compare/v0.0.2...v0.0.3
* xargs `-i` is deprecated, use `-I{}` instead
* 2023/10/30
* https://github.com/charlietag/tmux-split-statusbar/compare/v0.0.3...v0.1.0
* Add split-statusbar-swap-lines by [@awerebea](https://github.com/awerebea)