In a buffer with "hybrid" line numbers (:set number relativenumber
),
numbertoggle switches to absolute line numbers (:set number norelativenumber
)
automatically when relative numbers don't make sense.
Relative numbers are used in a buffer that has focus, and is in normal mode, since that's where you move around. They're turned off when you switch out of Vim, switch to another split, or when you go into insert mode.
Using Vim's package manager:
$ git clone --branch main git@github.com:jeffkreeftmeijer/vim-numbertoggle.git ~/.vim/pack/plugins/start/vim-numbertoggle
:set number
Once help tags are generated, you can view the manual with :help numbertoggle
.
If you use tmux, add set-option -g focus-events on
to your tmux config (~/.tmux.conf
) (#45).