https://github.com/MagnetizedFreckles/centerscroll.nvim

A simple utility to keep cursor always vertically centered. Focused on minimizing stuttering.
https://github.com/MagnetizedFreckles/centerscroll.nvim

Last synced: 29 days ago
JSON representation

A simple utility to keep cursor always vertically centered. Focused on minimizing stuttering.

• Host: GitHub
• URL: https://github.com/MagnetizedFreckles/centerscroll.nvim
• Owner: MagnetizedFreckles
• License: mit
• Created: 2024-01-02T21:04:13.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-02-08T13:25:40.000Z (5 months ago)
• Last Synced: 2024-02-08T14:36:22.470Z (5 months ago)
• Language: Lua
• Size: 11.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• my-neovim-pluginlist - MagnetizedFreckles/centerscroll.nvim - commit/MagnetizedFreckles/centerscroll.nvim)  (View / Screen position)

README

        
# centerscroll.nvim

***The code is most probably of very low quality, and some things could, or should, be done differently.***

***PRs and explanations are always welcome, thank you.***

A small plugin that makes line with cursor stay in the middle of the screen, regardless of position in the file.  

Made because every builtin and 'simpler' solution is, well, bad, in one way or another.

## Why not just use scrolloff option?

The main problem with it is that it doesn't center the line with cursor when it's half the screen or less near the end of file.

That was the dealbreaker for me.

## Why not setting keymaps with "motion+zz"?

I used this for quite a while, and it mostly worked for me.  

Problems arise though when you need to navigate through large file.

This causes lots of lag and stuttering, which is very annoying.  

Interestingly enough, the "scrolloff" way is far less jittery.

So, I guess, the ideal way is to somehow combine these two different ways into one.  

That's what I aim to do.

Plugin shouldn't conflict with your existing keymaps, and it also should dynamically adapt to your screen size.

However, there may be bugs, since I'm very inexperienced, to say the least.

## Issues

When nearing end of the file, plugin may append "zz" after automatic newline insertion,

and I don't know how to fix this.

## Installation

[lazy.nvim](https://github.com/folke/lazy.nvim):

```lua

return {

    "MagnetizedFreckles/centerscroll.nvim",

    config = true,

}

```

[packer.nvim](https://github.com/wbthomason/packer.nvim):  

*Coming soon ig*