https://github.com/fu5ha/i3-vim-nav

Seamlessly navigate i3 windows and vim splits
https://github.com/fu5ha/i3-vim-nav

Last synced: 10 days ago
JSON representation

Seamlessly navigate i3 windows and vim splits

• Host: GitHub
• URL: https://github.com/fu5ha/i3-vim-nav
• Owner: fu5ha
• License: lgpl-2.1
• Created: 2017-07-29T05:43:06.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-09-23T18:23:34.000Z (about 4 years ago)
• Last Synced: 2024-10-16T05:57:41.593Z (21 days ago)
• Language: Go
• Homepage:
• Size: 1.67 MB
• Stars: 99
• Watchers: 4
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# i3-vim-nav

Seamlessly change focus between i3 windows and Vim splits using the same hotkey.

# Installation

## Dependencies

This depends on you having a couple packages installed. Most notably, `xdotool/libxdo`, the second of which should be installed as a dependency of the first. If you want to build the binary from source and you're on Fedora, you'll also need the `libxdo-devel` package. We also currently require you to be using a version of vim with either python or python3 support.

## Vim plugin

First, install the Vim plugin.

 

### Using vim-plug

In your .vimrc (vim) or .config/nvim/init.vim (neovim):

```vim

Plug 'termhn/i3-vim-nav'

	

" i3 integration

nnoremap   :call Focus('right', 'l')

nnoremap   :call Focus('left', 'h')

nnoremap   :call Focus('up', 'k')

nnoremap   :call Focus('down', 'j')

```

	

### Using Pathogen

1. cd ~/.vim/bundle

2. git clone https://github.com/termhn/i3-vim-nav

3. add the following to your .vimrc

```vim

" i3 integration

nnoremap   :call Focus('right', 'l')

nnoremap   :call Focus('left', 'h')

nnoremap   :call Focus('up', 'k')

nnoremap   :call Focus('down', 'j')

```

	

## Binary

Next, install the binary on your PATH. If you have go installed, this can be done simply by

```

go get -u github.com/termhn/i3-vim-nav

```

If not, you can symlink the binary from its downloaded directory (this changes based on which plugin manager you used and if you're using vim or neovim) into /usr/local/bin. For example, if you used Pathogen on default Vim, this would be:

```

ln -s ~/.vim/bundle/i3-vim-nav/i3-vim-nav /usr/local/bin

```

Then, in your i3 config (adjust the path to the executable as necessary if you installed it differently). Feel free to change the key bind as you please.

```

bindsym --release $mod+h exec --no-startup-id "i3-vim-nav h"

bindsym --release $mod+j exec --no-startup-id "i3-vim-nav j"

bindsym --release $mod+k exec --no-startup-id "i3-vim-nav k"

bindsym --release $mod+l exec --no-startup-id "i3-vim-nav l"

```

Note: I've gotten a bug where in some installations of i3, it seems to not respect user $PATH additions, even though it seems to recognize them in the variable. If it doesn't work when placed in a user $PATH directory, try hard-coding the path to the binary in the exec commands.