transparent.nvim

Remove all background colors to make nvim transparent.

Installation

xiyaowong/transparent.nvim

Same as other normal plugins, use your favourite plugin manager to install.

NOTE:
It is recommended not to lazy load this plugin to avoid some strange phenomena.
The execution of each function in the plugin is very fast and the time consumption can be ignored.

Usage

All available options:

require("transparent").setup({
  groups = { -- table: default groups
    'Normal', 'NormalNC', 'Comment', 'Constant', 'Special', 'Identifier',
    'Statement', 'PreProc', 'Type', 'Underlined', 'Todo', 'String', 'Function',
    'Conditional', 'Repeat', 'Operator', 'Structure', 'LineNr', 'NonText',
    'SignColumn', 'CursorLineNr', 'EndOfBuffer',
  },
  extra_groups = {}, -- table: additional groups that should be cleared
  exclude_groups = {}, -- table: groups you don't want to clear
})

You can also add additional highlight groups by explicitly assigning the variable "g:transparent_groups", which is the more recommended way.

For example, if you want to add group ExtraGroup, you can do it like this:

vim.g.transparent_groups = vim.list_extend(vim.g.transparent_groups or {}, { "ExtraGroup" })
-- vimscript: let g:transparent_groups = extend(get(g:, 'transparent_groups', []), ["ExtraGroup"])

You can execute this statement anywhere and as many times as you want, without worrying about whether the plugin has already been loaded or not.

Here is an example about akinsho/bufferline.nvim. Simply copy it and paste it after initializing bufferline in your configuration.

vim.g.transparent_groups = vim.list_extend(
  vim.g.transparent_groups or {},
  vim.tbl_map(function(v)
    return v.hl_group
  end, vim.tbl_values(require('bufferline.config').highlights))
)

This plugin will provide a global variable: g:transparent_enabled(lua: vim.g.transparent_enabled)

Some plugins or themes support setting transparency, and you can use this variable as a flag.
eg: vim.g.tokyonight_transparent = vim.g.transparent_enabled

NOTE: The plugin will cache and automatically apply transparency settings, so you only need to call the following command.

FAQ

How to enable transparent for plugin panels?

You can try adding this highlight group to the options:

{
  extra_groups = {
    "NormalFloat", -- plugins which have float panel such as Lazy, Mason, LspInfo
    "NvimTreeNormal" -- NvimTree
  },
}

Commands

:TransparentEnable
:TransparentDisable
:TransparentToggle

Migration Guide 2023/3/20

1. remove enable=true in your config.

2. start Neovim

3. Run :TransparentEnable

It's done, the status of enable will cached and the transparent effect is applyed on you neovim, enjoy :)

Aknowledgement

vim-transparent