| scripts | ||
| .gitignore | ||
| LICENSE | ||
| power-zoom.tmux | ||
| README.md | ||
tmux-power-zoom
Zoom pane to separate window, and unzoom back into the original location.
This way you can open other panes whilst focusing on the zoomed pane, without risking getting a crowded mess of panes.
Purpose
Quite often when I zoom a pane, work in it for a while and then figure out I need to open a pane to check something I have completely forgotten I am working in a zoomed pane, so as I open a new pane the new pane suddenly becomes squeezed in next to the original pane, often far to small to be practicaly usable.
This plugin zooms panes into a new window, so that it is convenient to open support panes. Hitting Smart Zoom again will unzoom and move the pane back to it's original location, if no other panes are present the temp window is closed.
The temp window is named using title and ID of the zoomed pane, so that if other panes were open and it is left running, it will later be a hint as the pupose of that window.
Usage
Hit <prefix> + @power_zoom_trigger to toggle Power Zoom. If @power_zoom_mouse is enabled, right double click also toggles Power Zoom.
Install
Dependencies
tmux 2.6 or higher.
Installation with Tmux Plugin Manager (recommended)
Add plugin to the list of TPM plugins in .tmux.conf:
set -g @plugin 'jaclu/tmux-power-zoom'
Hit prefix + I to fetch the plugin and source it. That's it!
Manual Installation
Clone the repo:
$ git clone https://github.com/jaclu/tmux-power-zoom.git ~/clone/path
Add this line to the bottom of .tmux.conf:
run-shell ~/clone/path/power-zoom.tmux
Reload TMUX environment with $ tmux source-file ~/.tmux.conf, and that's it.
Configuration Options
| Option | Default | Description |
|---|---|---|
@power_zoom_trigger |
Z | Key that triggers Power Zoom to toggle |
@power_zoom_without_prefix |
0 | If set to 1, trigger key is independent of <prefix> |
@power_zoom_mouse |
0 | If set to 1, right double click toggles Power Zoom |
TODO
Figure out how to use -t '{mouse}' with the mouse trigger to activate mouse-overed pane before zoom happens, to ensure the intended pane is zoomed.
Contributing
Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
The best way to send feedback is to file an issue at https://github.com/jaclu/tmux-menus/issues