https://github.com/simnalamburt/tmux-pane

:desktop_computer: Key-bindings for tmux pane control
https://github.com/simnalamburt/tmux-pane

Last synced: 3 months ago
JSON representation

:desktop_computer: Key-bindings for tmux pane control

• Host: GitHub
• URL: https://github.com/simnalamburt/tmux-pane
• Owner: simnalamburt
• License: mit
• Fork: true (tmux-plugins/tmux-pain-control)
• Created: 2015-08-16T14:43:48.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2020-01-13T10:43:21.000Z (almost 5 years ago)
• Last Synced: 2024-06-10T00:38:10.407Z (5 months ago)
• Language: Shell
• Homepage:
• Size: 130 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
tmux-pane

========

Tmux plugin for controlling panes. You can install this plugin with [TPM].

```shell

# .tmux.conf

set -g @plugin 'simnalamburt/tmux-pane'

```

This plugin was forked from [tmux-pain-control] and customized for my use cases.

[TPM]: https://github.com/tmux-plugins/tpm

[tmux-pain-control]: https://github.com/tmux-plugins/tmux-pain-control

 

Bindings

--------

Notice most of the bindings emulate vim cursor movements.



**Resizing panes**

- `prefix + h`


  resize current pane 5 cells to the left

- `prefix + j`


  resize 5 cells in the down direction

- `prefix + k`


  resize 5 cells in the up direction

- `prefix + l`


  resize 5 cells to the right

These mappings are `repeatable`.

The amount of cells to resize can be configured with `@pane_resize` option. See

[configuration section](#configuration) for the details.







**Splitting panes**

- `prefix + \ `


  split current pane horizontally

- `prefix + -`


  split current pane vertically

Newly created pane always has the same path as the original pane.








**Swapping windows**

- `prefix + <` - moves current window one position to the left

- `prefix + >` - moves current window one position to the right

 

Configuration

--------

You can set `@resize_vertical` and `@resize_horizontal` Tmux option to choose number of resize cells for the

resize bindings.

```shell

set-option -g @resize_vertical "5"       # Default: "3"

set-option -g @resize_horizontal "15"    # Default: "10"

```

 

### License

[MIT](LICENSE.md)