Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TheSast/tmux-transient-status
Automatically make your tmux status bar vanish when unneded.
https://github.com/TheSast/tmux-transient-status
shell statusbar tmux tmux-plugin tmux-plugins tmux-status tpm
Last synced: 3 months ago
JSON representation
Automatically make your tmux status bar vanish when unneded.
- Host: GitHub
- URL: https://github.com/TheSast/tmux-transient-status
- Owner: TheSast
- License: other
- Created: 2023-04-29T20:57:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-26T23:31:42.000Z (10 months ago)
- Last Synced: 2024-04-24T04:21:37.227Z (6 months ago)
- Topics: shell, statusbar, tmux, tmux-plugin, tmux-plugins, tmux-status, tpm
- Language: Shell
- Homepage:
- Size: 2.94 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-tmux - tmux-transient-status
README
Tmux Transient Status
=======
This tmux [tpm](https://github.com/tmux-plugins/tpm) plugin makes your status bar appear only after the `` key is pressed (and for a small amout of time thereafter).
Preview
-------
Installation
------------
You can install this plugin through [tpm](https://github.com/tmux-plugins/tpm):
1. Install [tpm](https://github.com/tmux-plugins/tpm) (duh)
2. Add this line to your `tmux.conf`:
```tmux
set -g @plugin 'thesast/tmux-transient-status'
```
3. Install the plugin with `I`, unless you changed `@tpm-install`, in which case you should use the keybind you set.
Configuration
-------------
This plugins offers two options to be set in your `tmux.conf` with these defaults:
```tmux
set -g @transient-status-delay '0.5'
set -g @transient-status-stall '2.5'
```
The first one controls the amount of seconds the status bar will wait after you press `` before appearing (set to `0` to make it instant).
The second one controls the amount of seconds the status bar will linger for after you are done with your command (set to `0` to disable lingering).
FAQ
---
### Why does `send-prefix` not work sometimes?
Make sure to source your `tmux.conf` (and run tpm in it!) after you bind a key to `send-prefix`, as the plugin is *not* hot-reloaded.
### Why is my status bar not hiding correctly?
See the previous answer as it also applies to ``.
This plugin only deals with the primary `` not the secondary one or any other extra ones.
Other plugins
-------------
You might also like these plugins:
- [tmux-powerline](https://github.com/erikw/tmux-powerline) - A tmux plugin giving you a hackable status bar consisting of dynamic & beautiful looking powerline segments, written purely in bash.
This was shown in [preview](#preview).
- [tmux-nav-master](https://github.com/TheSast/tmux-nav-master) - Easy cross-navigation between tmux and other terminal applications.
- [tmux-keylocker](https://github.com/TheSast/tmux-locker) - Lock away your tmux keybinds temporarely.
Licence
-------
[MIT and Apache 2.0](COPYRIGHT.md)