You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

7.8 KiB

Raw Permalink Blame History

Configuration

Global Vim Settings

Neovide supports settings via global variables with a neovide prefix. They enable configuring many parts of the editor and support dynamically changing them at runtime.

Functionality

Hello, is this Neovide?

Not really a configuration option, but g:neovide only exists and is set to v:true if this Neovim is in Neovide. It's not set else. Useful for configuring things only for Neovide in your init.vim:

if exists("g:neovide")
    " Put anything you want to happen only in Neovide here
endif

Refresh Rate

let g:neovide_refresh_rate=140

Setting g:neovide_refresh_rate to a positive integer will set the refresh rate of the app. This is limited by the refresh rate of your physical hardware, but can be lowered to increase battery life.

Transparency

let g:neovide_transparency=0.8

Setting g:neovide_transparency to a value between 0.0 and 1.0 will set the opacity of the window to that value.

Floating Blur Amount

let g:neovide_floating_blur_amount_x = 2.0
let g:neovide_floating_blur_amount_y = 2.0

Available since 0.9.

Setting g:neovide_floating_blur_amount_x and g:neovide_floating_blur_amount_y controls the blur radius on the respective axis for floating windows.

Scroll Animation Length

let g:neovide_scroll_animation_length = 0.3

Sets how long the scroll animation takes to complete, measured in seconds.

No Idle

let g:neovide_no_idle=v:true

Setting g:neovide_no_idle to a boolean value will force neovide to redraw all the time. This can be a quick hack if animations appear to stop too early.

Fullscreen

let g:neovide_fullscreen=v:true

Setting g:neovide_fullscreen to a boolean value will set whether the app should take up the entire screen. This uses the so called "windowed fullscreen" mode that is sometimes used in games which want quick window switching.

Remember Previous Window Size

let g:neovide_remember_window_size = v:true

Setting g:neovide_remember_window_size to a boolean value will determine whether the window size from the previous session or the default size will be used on startup. The commandline option --geometry will take priority over this value.

Profiler

let g:neovide_profiler = v:false

Setting this to v:true enables the profiler, which shows a frametime graph in the upper left corner.

Input Settings

Use Logo Key

let g:neovide_input_use_logo=v:true

Setting g:neovide_input_use_logo to a boolean value will change how logo key (also known as super key, command key or windows key) is handled, allowing all key combinations containing logo to be forwarded to neovim.

macOS Alt is Meta

let g:neovide_input_macos_alt_is_meta=v:false

Unreleased yet.

Interprets Alt + whatever actually as <M-whatever>, instead of sending the actual special character to Neovim.

Touch Deadzone

let g:neovide_touch_deadzone=6.0

Setting g:neovide_touch_deadzone to a value equal or higher than 0.0 will set how many pixels the finger must move away from the start position when tapping on the screen for the touch to be interpreted as a scroll gesture.

If the finger stayed in that area once lifted or the drag timeout happened, however, the touch will be interpreted as tap gesture and the cursor will move there.

A value lower than 0.0 will cause this feature to be disabled and all touch events will be interpreted as scroll gesture.

Touch Drag Timeout

let g:neovide_touch_drag_timeout=0.17

Setting g:neovide_touch_drag_timeout will affect how many seconds the cursor has to stay inside g:neovide_touch_deadzone in order to begin "dragging"

Once started, the finger can be moved to another position in order to form a visual selection. If this happens too often accidentally to you, set this to a higher value like 0.3 or 0.7.

Cursor Settings

Animation Length

Short Cursor Animation Length Long Cursor Animation Length

let g:neovide_cursor_animation_length=0.13

Setting g:neovide_cursor_animation_length determines the time it takes for the cursor to complete it's animation in seconds. Set to 0 to disable.

Animation Trail Length

Short Cursor Trail Length Long Cursor Trail Length

let g:neovide_cursor_trail_length=0.8

Setting g:neovide_cursor_trail_length determines how much the trail of the cursor lags behind the front edge.

Antialiasing

let g:neovide_cursor_antialiasing=v:true

Enables or disables antialiasing of the cursor quad. Disabling may fix some cursor visual issues.

Unfocused Outline Width

let g:neovide_cursor_unfocused_outline_width=0.125

Specify cursor outline width in ems. You probably want this to be a positive value less than 0.5. If the value is <=0 then the cursor will be invisible. This setting takes effect when the editor window is unfocused, at which time a block cursor will be rendered as an outline instead of as a full rectangle.

Cursor Particles

There are a number of vfx modes you can enable which produce particles behind the cursor. These are enabled by setting g:neovide_cursor_vfx_mode to one of the following constants.

None at all

let g:neovide_cursor_vfx_mode = ""

The default, no particles at all.

Railgun

let g:neovide_cursor_vfx_mode = "railgun"

Torpedo

let g:neovide_cursor_vfx_mode = "torpedo"

Pixiedust

let g:neovide_cursor_vfx_mode = "pixiedust"

Sonic Boom

let g:neovide_cursor_vfx_mode = "sonicboom"

Ripple

let g:neovide_cursor_vfx_mode = "ripple"

Wireframe

let g:neovide_cursor_vfx_mode = "wireframe"

Particle Settings

Options for configuring the particle generation and behavior.

Particle Opacity

let g:neovide_cursor_vfx_opacity=200.0

Sets the transparency of the generated particles.

Particle Lifetime

let g:neovide_cursor_vfx_particle_lifetime=1.2

Sets the amount of time the generated particles should survive.

Particle Density

let g:neovide_cursor_vfx_particle_density=7.0

Sets the number of generated particles.

Particle Speed

let g:neovide_cursor_vfx_particle_speed=10.0

Sets the speed of particle movement.

Particle Phase

let g:neovide_cursor_vfx_particle_phase=1.5

Only for the railgun vfx mode.

Sets the mass movement of particles, or how individual each one acts. The higher the value, the less particles rotate in accordance to each other, the lower, the more line-wise all particles become.

Particle Curl

let g:neovide_cursor_vfx_particle_curl=1.0