https://github.com/ddzero2c/tmux-easymotion
Easymotion like vim in tmux
https://github.com/ddzero2c/tmux-easymotion
easymotion neovim tmux tpm vim vimium
Last synced: 22 days ago
JSON representation
Easymotion like vim in tmux
- Host: GitHub
- URL: https://github.com/ddzero2c/tmux-easymotion
- Owner: ddzero2c
- Created: 2020-02-02T17:57:43.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-10-25T16:33:40.000Z (about 2 months ago)
- Last Synced: 2025-10-25T18:27:43.104Z (about 2 months ago)
- Topics: easymotion, neovim, tmux, tpm, vim, vimium
- Language: Python
- Homepage:
- Size: 61.5 KB
- Stars: 35
- Watchers: 3
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-tmux - tmux-easymotion - like plugin with pane jumping capabilities in tmux. (Plugins)
README
# TMUX Easymotion
[](https://github.com/ddzero2c/tmux-easymotion/actions/workflows/test.yml)
> [!NOTE]
> **📢 Active Development Notice**
>
> I've been receiving feature requests and will be actively adding new features going forward.
> The master branch may include breaking changes and experimental features.
>
> **If you prefer stability, please pin to [v1.0.0](https://github.com/ddzero2c/tmux-easymotion/releases/tag/v1.0.0):**
> ```bash
> set -g @plugin 'ddzero2c/tmux-easymotion@v1.0.0'
> ```
- Tmux prefix is `Ctrl+q`:
- Trigger key is `s`
Q: There are already many plugins with similar functionality, why do we need this one?
A: **This one can jump between panes**
### Installation via [TPM](https://github.com/tmux-plugins/tpm)
Add plugin to the list of TPM plugins in ~/.tmux.conf:
```bash
set -g @plugin 'ddzero2c/tmux-easymotion'
set -g @easymotion-key 's'
```
Press `prefix` + `I` to install
### Options:
```bash
# ============================================================================
# Key Bindings - Motion Types
# ============================================================================
# 1-Character Search (Traditional)
# Usage: prefix + → type a character → hints appear at all occurrences
# Use case: Quick jumps when the target character is unique or easy to spot
# set -g @easymotion-key 's' # Legacy 1-char search (default: 's', backward compatible)
set -g @easymotion-s 's'
# 2-Character Search (similar to leap.nvim)
# Usage: prefix + → type 2 chars → hints appear only where both match consecutively
# Use case: Reduce screen clutter by narrowing down matches with 2 characters
# Benefits:
# - Fewer hints on screen = easier to read
# - More precise targeting
# - Supports CJK (wide) characters
# - Works with case-sensitivity and smartsign options
set -g @easymotion-s2 'f'
# ============================================================================
# Other Configuration Options
# ============================================================================
# Keys used for hints (default: 'asdghklqwertyuiopzxcvbnmfj;')
set -g @easymotion-hints 'asdfghjkl;'
# Border characters
set -g @easymotion-vertical-border '│'
set -g @easymotion-horizontal-border '─'
# Use curses instead of ansi escape sequences (default: false)
set -g @easymotion-use-curses 'true'
# Debug mode - writes debug info to ~/easymotion.log (default: false)
set -g @easymotion-debug 'true'
# Performance logging - writes timing info to ~/easymotion.log (default: false)
set -g @easymotion-perf 'true'
# Case sensitive search (default: false)
set -g @easymotion-case-sensitive 'true'
# Enable smartsign feature (default: false)
# Works with all search modes (s, s2, etc.)
set -g @easymotion-smartsign 'true'
```
### Vim-like Configuration
```bash
set-window-option -g mode-keys vi
bind-key -T copy-mode-vi C-v send-keys -X begin-selection \; send-keys -X rectangle-toggle;
bind-key -T copy-mode-vi v send-keys -X begin-selection;
bind-key -T copy-mode-vi V send-keys -X select-line;
```
### Usage Examples
**Copy a word:**
`prefix` + `s` → type character → select hint → press `ve` and `y` to copy
**Paste:**
`prefix` + `]` to paste
### Run tests
```bash
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest test_easymotion.py -v --cache-clear
```
### Inspire by
- [tmux-yank](https://github.com/tmux-plugins/tmux-yank)
- [vim-easymotion](https://github.com/easymotion/vim-easymotion)
### Known issues
- ~~Render wield when tmux pane contain wide character.~~
~~- ex. `'哈哈'`.~~
- ~~Scrolled up panes are not supported~~
- ~~Broken when tmux window has split panes~~
- ~~Jump between panes is not supported~~