/tmux-mouse-swipe

Tmux plugin, uses mouse horizontal swipe to switch window and vertical to switch session

Primary LanguageShellMIT LicenseMIT

Tmux-Mouse-Swipe

Right click and swipe left or right in any pane to switch window in that direction or swipe up or down to switch session.

As always any suggestions for improvements are welcome!

Purpose

When you are at the keyboard obviously a key sequence is both faster and more natural to switch sessions or windows. I use this tool mostly just getting a quick overview when having the terminal on a side screen, in such cases mouse swiping is handy.

The reason I wrote it as a posix script is that since it gets run multiple times in quick sequence, on my iPad running iSH, there is a noticeable performance boost not having to repeatedly start bash scripts.

Installation

Comparability: tmux version 3.0 or higher

With Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'jaclu/tmux-mouse-swipe'

Hit <prefix> + I to fetch the plugin and source it.

Manual Installation

Clone the repository:

git clone https://github.com/jaclu/tmux-mouse-swipe.git ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/mouse_swipe.tmux

From the terminal, reload TMUX environment:

tmux source-file ~/.tmux.conf

Usage

Once installed, try pressing down right button and swipe up, down, left or right on any pane.

Once you release the button, tmux should switch window after horizontal swipe and session after vertical.

If you only have one Window or Session, a message will be displayed that the requested action can not be performed, depending on swipe direction.

Minimal movement

Since drag isn't registered until you move one character cell, and at least one more cell of movement is needed to detect direction, minimal movement distance is two characters.

Not purely vertical / horizontal swipes

If both vertical and horizontal swiping is detected, the axis with the most delta is assumed to be the intended direction. Risk for miss-interpertaion is reduced by making a slightly longer swipe.

Pane borders

tmux sends mouse coordinates relative to the pane that the mouse is over, so if you cross a pane border during the swipe, the direction of movement will most likely not be the intended.

Basic modifications

If you want to bind this to another mouse event, search for the MOUSE SUPPORT section in the tmux man page for details on how to bind mouse events. Change the binds towards the end of mouse_swipe.tmux in the top directory of this repository.

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 tmux-mouse-swipe/issues

License

MIT