Hardtime helps you break that annoying habit vimmers have of scrolling up and down the page using jjjjj and kkkkk but without compromising the rest of our vim experience.

It works using a timeout on the keys you want to stop repeating, i.e. h, j, k, l, UP, DOWN, LEFT, RIGHT. This timeout is set to 1000 milliseconds. After this time you can use a movement key again.

Stop repeating jjjjj... Stop repeating kkkk...

Kick the habit now!

Inspired by vim-hardmode, but where hardmode fell short was that sometimes h,j,k,l are needed! Hardtime lets you use these keys but only once every second. You can still create macros in hardtime where you need to move down lines, and you can still move that one character over to make that edit.

• Drew Neil has a great blog post on Habit breaking, habit making
• Practising some Vim golf will certainly improve your movement skills
• Vim help, :h word-motions and :h motion are both great resources
• A good Vim wiki article

Once installed you can call the command :HardTimeOn to activate hardtime, conversely you can use :HardTimeOff to swtich it off. You can also use :HardTimeToggle toggle it on an off.

If you want hardtime to run in every buffer you can set let g:hardtime_default_on = 1 in your .vimrc.

Add the following variables to your .vimrc to enable customisations.

Set the list of keys to use with hardtime

g:list_of_normal_keys = [ "w", "W", "b", "B" ]
g:list_of_visual_keys = [ "o", "n", "w", "b" ]

These default to [ "h", "j", "k", "l", "-", "+", "<UP>", "<DOWN>", "<LEFT>", "<RIGHT>" ].

It is possible to tweak the timeout allowed between keypresses. specifying the time in milliseconds.

g:hardtime_timeout = 2000

This allows you increase the amount of time

The default is 1000.

To enable the notification about HardTime being enabled set

let g:hardtime_showmsg = 1

The default is 0.

To enable hardtime to ignore certain buffer patterns set

let g:hardtime_ignore_buffer_patterns = [ "CustomPatt[ae]rn", "NERD.*" ]

The default is [].

The quickfix window cannot be added to the ignore buffers array to have hardtime ignore it set

let g:hardtime_ignore_quickfix = 1

The default is 0.

To make hardtime allow a key if it is different from the previous key, set

let g:hardtime_allow_different_key = 1

This, for example, makes it possible to input "jh", but not "jj".

The default is 0.

This setting will let you press a key n number of times before hardtime starts ignoring subsequent keypresses.

let g:hardtime_maxcount = 2

Setting this value to 2 will allow a user to press jj but not jjj.

The default is 1.

I recommend installing using Vundle:

Add Bundle 'takac/vim-hardtime' to your ~/.vimrc and then:

• either within Vim: :BundleInstall
• or in your shell: vim +BundleInstall +qall