Skip to main content
This page documents Neovide-specific settings in lua/config/neovide.lua. These settings only apply when running Neovim inside Neovide, a modern GUI client.
All configuration is wrapped in a vim.g.neovide check, so these settings have no effect when running in a terminal.

​
Font settings

Configures the GUI font for Neovide.
OptionValueDescription
guifont"Maple Mono NF:h11"Font family and size (h11 = 11pt)
To adjust the font size, modify the number after :h in the font string:
  • :h9 - 9pt (smaller)
  • :h11 - 11pt (default)
  • :h13 - 13pt (larger)
  • :h15 - 15pt (much larger)
Example:
vim.opt.guifont = "Maple Mono NF:h13"

​
Window appearance

Controls the Neovide window chrome and decorations.
OptionValueDescription
neovide_window_decorationsfalseHide window title bar and borders for minimal UI
neovide_fullscreencommented outStart in fullscreen mode (disabled by default)
With window decorations disabled, you get a clean, borderless window. Use your window manager’s controls to move or resize the window.

​
Clipboard integration

Custom clipboard paste keybinding for Neovide. Keybinding: <C-S-v> (Ctrl+Shift+V)
Modes: All modes (n, v, s, x, o, i, l, c, t)
Action: Paste from system clipboard
Source: lua/config/neovide.lua:19 
vim.keymap.set({ "n", "v", "s", "x", "o", "i", "l", "c", "t" }, "<C-S-v>>", function()
  vim.api.nvim_paste(vim.fn.getreg("+"), true, -1)
end, { desc = "Paste from system clipboard" })
Why this is needed:Neovide doesn’t have a terminal to handle standard terminal paste sequences, so this custom binding ensures clipboard paste works consistently across all modes.

​
Floating window effects

Visual effects for floating windows and popups.

​
Blur effects

OptionValueDescription
neovide_floating_blur_amount_x6.0Horizontal blur intensity
neovide_floating_blur_amount_y6.0Vertical blur intensity
Higher values create stronger blur. Set to 0.0 to disable blur entirely.

​
Shadow and lighting

OptionValueDescription
neovide_floating_shadowtrueEnable drop shadow on floating windows
neovide_floating_z_height10Height of floating windows (affects shadow depth)
neovide_light_angle_degrees45Angle of light source for shadows (in degrees)
neovide_light_radius5Size of light source (affects shadow softness)
These settings simulate a 3D effect for floating windows:
  • z_height: Higher values make windows appear to float further from the background
  • light_angle: 45° creates shadows that go diagonally down-right
  • light_radius: Larger radius creates softer, more diffused shadows
Adjust these values to match your aesthetic preferences.

​
Corner radius

OptionValueDescription
neovide_floating_corner_radius2.0Rounded corner radius for floating windows
This works together with vim.o.winborder = "rounded" set in options.lua to create consistently rounded UI elements.

​
Window transparency

Opacity and blur settings for the main Neovide window.
OptionValueDescription
neovide_opacity0.85Overall window opacity (0.0 = transparent, 1.0 = opaque)
neovide_normal_opacity0.85Opacity specifically for normal mode
neovide_window_blurredtrueApply blur effect to background behind transparent window
Recommended opacity ranges:
  • 0.95-1.0 - Minimal transparency, best for bright environments
  • 0.85-0.95 - Subtle transparency (default)
  • 0.70-0.85 - Noticeable transparency, good for aesthetics
  • 0.50-0.70 - High transparency, requires solid background
Window blur:When neovide_window_blurred is enabled, content behind Neovide gets blurred. This works best on macOS and requires compositor support on Linux.
Very low opacity values (below 0.7) can make text difficult to read. Consider your wallpaper and ambient lighting.

​
Cursor effects

Cursor animation and visual enhancements.
OptionValueDescription
neovide_cursor_smooth_blinktrueSmooth cursor blinking animation
Neovide includes many cursor animation options. This config only enables smooth blinking. See Neovide cursor documentation for additional cursor effects.

​
Complete configuration reference

Here’s the full list of Neovide settings configured: 
-- Font
vim.opt.guifont = "Maple Mono NF:h11"

-- Window
vim.g.neovide_window_decorations = false

-- Floating window blur
vim.g.neovide_floating_blur_amount_x = 6.0
vim.g.neovide_floating_blur_amount_y = 6.0

-- Floating window shadows
vim.g.neovide_floating_shadow = true
vim.g.neovide_floating_z_height = 10
vim.g.neovide_light_angle_degrees = 45
vim.g.neovide_light_radius = 5

-- Floating window corners
vim.g.neovide_floating_corner_radius = 2.0

-- Window transparency
vim.g.neovide_opacity = 0.85
vim.g.neovide_normal_opacity = 0.85
vim.g.neovide_window_blurred = true

-- Cursor
vim.g.neovide_cursor_smooth_blink = true
For more Neovide configuration options, see the official Neovide documentation.
Many additional Neovide features are available but not configured here, including particle effects, cursor trails, and custom animations.

Build docs developers (and LLMs) love

Get started for freeTalk to us