Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/schasse/tmux-jump
Vimium/Easymotion like navigation for tmux.
https://github.com/schasse/tmux-jump
ace-jump easymotion tmux tpm vimium
Last synced: 3 months ago
JSON representation
Vimium/Easymotion like navigation for tmux.
- Host: GitHub
- URL: https://github.com/schasse/tmux-jump
- Owner: schasse
- License: gpl-3.0
- Created: 2019-04-25T17:38:16.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-05-09T08:49:38.000Z (about 1 year ago)
- Last Synced: 2024-01-24T07:03:59.786Z (5 months ago)
- Topics: ace-jump, easymotion, tmux, tpm, vimium
- Language: Ruby
- Homepage:
- Size: 13.8 MB
- Stars: 300
- Watchers: 5
- Forks: 14
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-tmux - tmux-jump
- awesome-stars - schasse/tmux-jump - Vimium/Easymotion like navigation for tmux. (Ruby)
README
![]()
[![Build Status](https://travis-ci.org/schasse/tmux-jump.svg?branch=master)](https://travis-ci.org/schasse/tmux-jump)
A fast way to jump wherever you want in your terminal without using the mouse. A plugin similar to [vimium](https://vimium.github.io/) and [easymotion](https://github.com/easymotion/vim-easymotion) but for tmux. tmux-jump is written in ruby and can easily be installed via tpm.
![tmux-jump-demo](https://user-images.githubusercontent.com/3882305/74186577-2f6aad80-4c4b-11ea-8054-91c54e3dd2af.gif)
From now to then I think about how to improve my dev tools. Copy and pasting inside the terminal is something I do everyday, all the time. This is one of the most obvious things make more efficient. [tmux-yank](https://github.com/tmux-plugins/tmux-yank) improved the situation a lot. Though, it felt still annoying to get to the string I wanted to copy. Either I used to enter tmux copy mode and moved the cursor to the string or I used the mouse. I looked for a plugin such as easymotion for vim or ace jump for emacs, but I couldn't find one. So I decided to write my own tmux plugin.
## Requirements
* [tmux](https://github.com/tmux/tmux) >= 3.1
* [ruby](https://www.ruby-lang.org/) >= 2.3## Installation via [TPM](https://github.com/tmux-plugins/tpm)
Add plugin to the list of TPM plugins in `~/.tmux.conf`:
```
set -g @plugin 'schasse/tmux-jump'
```
Hit tmux-prefix + I to fetch the plugin and source it. You should now be able to use the plugin.## Manual Installation
Clone the repository:
```
git clone https://github.com/schasse/tmux-jump ~/.tmux-jump
```Add the following to `.tmux.conf`:
```
run-shell ~/.tmux-jump/tmux-jump.tmux
```Reload tmux:
```
tmux source-file ~/.tmux.conf
```## Usage
* tmux-prefix + j and enter the first character of a word.
* The screen will rerender and highlight the keys to press to jump to the word.
* Type the key sequence of the word to jump to.
* The cursor moves to the word.tmux-jump can also be used in in any program and during copy mode.
You can customize the key binding in your `.tmux.conf`:
```
set -g @jump-key 's'
```You can also customize foreground and background color:
```
set -g @jump-bg-color '\e[0m\e[90m'
set -g @jump-fg-color '\e[1m\e[31m'
```And the keys position:
```
# keys will overlap with the word (default)
set -g @jump-keys-position 'left'# keys will be at the left of the word without overlap
set -g @jump-keys-position 'off_left'
```## Similar Projects
* [vimium](https://vimium.github.io/)
* [easymotion](https://github.com/easymotion/vim-easymotion)
* [ace-jump-mode](https://github.com/winterTTr/ace-jump-mode)