Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaclu/tmux-power-zoom
Zoom pane to separate window, and unzoom it back into it's original location
https://github.com/jaclu/tmux-power-zoom
tmux tmux-configuration tmux-plugins
Last synced: 3 months ago
JSON representation
Zoom pane to separate window, and unzoom it back into it's original location
- Host: GitHub
- URL: https://github.com/jaclu/tmux-power-zoom
- Owner: jaclu
- License: mit
- Created: 2022-02-04T16:31:03.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-16T14:28:19.000Z (8 months ago)
- Last Synced: 2024-03-16T17:45:18.576Z (8 months ago)
- Topics: tmux, tmux-configuration, tmux-plugins
- Language: Shell
- Homepage:
- Size: 94.7 KB
- Stars: 38
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tmux - tmux-power-zoom
README
# Tmux-Power-Zoom
Zoom pane to separate window, and un-zoom 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.
You can also restore by triggering the power-zoom action on the place-holder
pane.
## Recent changes
- Had forgotten to abort if attempt to zoom only pane - fixed
- Removed a previous config variable `power_zoom_mouse`
- Recent changes resulted in compatiblity with tmux 2.0
- Repeated zooms of the same pane now works as expected
- Made to work when shell is fish, what an odd beast that is...
- Fixed some issues that prevented this to run on older versions of tmux.
## Purpose
Often when zooming a pane, working in it for a while and then figure out
a new pane is needed to look something up, the zoomed state is forgotten.
When opening a new pane this way, the new pane becomes squeezed in next
to the original pane, often far to small to be practically usable.
This plugin zooms panes into a new window and makes it convenient to open support
panes. Hitting Smart Zoom again unzooms and move the pane back to it's
original location. The temp window closes, if no other panes are present.
The temp windows name uses ID of the zoomed pane, so that if other
panes were open and left running, there is a hint about
the purpose of that window.
## Usage
Hit `` + `@power_zoom_trigger` to toggle Power Zoom.
If `@power_zoom_mouse_action` is defined, that mouse action also toggles
Power Zoom.
## Install
### Dependencies
`tmux 2.0` or higher. Needs select-pane -T option. Could be made to work on
earlier version with a bit of rewrite, if anybody has such a need,
create an Issue.
### Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)
Add plugin to the list of TPM plugins in `.tmux.conf`:
```tmux
set -g @plugin 'jaclu/tmux-power-zoom'
```
Hit `prefix + I` to fetch the plugin and source it.
### Manual installation
Clone the repository:
```bash
git clone https://github.com/jaclu/tmux-power-zoom.git ~/clone/path
```
Add this line to the bottom of `.tmux.conf`:
```tmux
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 ``
`@power_zoom_mouse_action` | | Defines a mouse action trigger, supports modifiers
typically 1 is left button and 3 is right button
Examples:
DoubleClick3Pane
S-DoubleClick3Pane
M-DoubleClick3Pane
TrippleClick1Pane
## Contributing
Contributions are welcome, and they're appreciated. Every little bit
helps, and credit is always given.
The best way to send feedback is to file an issue at
[tmux-power-zoom/issues](https://github.com/jaclu/tmux-power-zoom/issues)
### License
[MIT](LICENSE.md)