black-metal-theme-neovim

KO | EN

gitlite — search

#javascript #python #react #ai #go #golang #android #rust #java #awesome #kubernetes #security #ios #mcp

black-metal-theme-neovim

(★ 357)

A collection of black-metal themed neovim colorschemes.

File Explorer

Download Latest Version (.zip)

- bathory-alt.lua
- bathory-light-alt.lua
- bathory-light.lua
- bathory.lua
- black-metal-light-alt.lua
- black-metal-light.lua
- burzum-alt.lua
- burzum-light-alt.lua
- burzum-light.lua
- burzum.lua
- dark-funeral-alt.lua
- dark-funeral-light-alt.lua
- dark-funeral-light.lua
- dark-funeral.lua
- darkthrone-alt.lua
- darkthrone-light-alt.lua
- darkthrone-light.lua
- darkthrone.lua
- emperor-alt.lua
- emperor-light-alt.lua
- emperor-light.lua
- emperor.lua
- gorgoroth-alt.lua
- gorgoroth-light-alt.lua
- gorgoroth-light.lua
- gorgoroth.lua
- immortal-alt.lua
- immortal-light-alt.lua
- immortal-light.lua
- immortal.lua
- impaled-nazarene-alt.lua
- impaled-nazarene-light-alt.lua
- impaled-nazarene-light.lua
- impaled-nazarene.lua
- khold-alt.lua
- khold-light-alt.lua
- khold-light.lua
- khold.lua
- marduk-alt.lua
- marduk-light-alt.lua
- marduk-light.lua
- marduk.lua
- mayhem-alt.lua
- mayhem-light-alt.lua
- mayhem-light.lua
- mayhem.lua
- nile-alt.lua
- nile-light-alt.lua
- nile-light.lua
- nile.lua
- taake-alt.lua
- taake-light-alt.lua
- taake-light.lua
- taake.lua
- thyrfing-alt.lua
- thyrfing-light-alt.lua
- thyrfing-light.lua
- thyrfing.lua
- venom-alt.lua
- venom-light-alt.lua
- venom-light.lua
- venom.lua
- windir-alt.lua
- windir-light-alt.lua
- windir-light.lua
- windir.lua
- - bathory.toml
  - burzum.toml
  - dark-funeral.toml
  - darkthrone.toml
  - emperor.toml
  - gorgoroth.toml
  - immortal.toml
  - impaled-nazarene.toml
  - khold.toml
  - marduk.toml
  - mayhem.toml
  - nile.toml
  - taake.toml
  - thyrfing.toml
  - venom.toml
  - windir.toml
- - bathory.fish
  - burzum.fish
  - dark-funeral.fish
  - darkthrone.fish
  - emperor.fish
  - gorgoroth.fish
  - immortal.fish
  - impaled-nazarene.fish
  - khold.fish
  - marduk.fish
  - mayhem.fish
  - nile.fish
  - taake.fish
  - thyrfing.fish
  - venom.fish
  - windir.fish
- - bathory.theme
  - burzum.theme
  - dark-funeral.theme
  - darkthrone.theme
  - emperor.theme
  - gorgoroth.theme
  - immortal.theme
  - impaled-nazarene.theme
  - khold.theme
  - marduk.theme
  - mayhem.theme
  - nile.theme
  - taake.theme
  - thyrfing.theme
  - venom.theme
  - windir.theme
- - bathory.ini
  - burzum.ini
  - dark-funeral.ini
  - darkthrone.ini
  - emperor.ini
  - gorgoroth.ini
  - immortal.ini
  - impaled-nazarene.ini
  - khold.ini
  - marduk.ini
  - mayhem.ini
  - nile.ini
  - taake.ini
  - thyrfing.ini
  - venom.ini
  - windir.ini
- - bathory.zsh
  - burzum.zsh
  - dark-funeral.zsh
  - darkthrone.zsh
  - emperor.zsh
  - gorgoroth.zsh
  - immortal.zsh
  - impaled-nazarene.zsh
  - khold.zsh
  - marduk.zsh
  - mayhem.zsh
  - nile.zsh
  - taake.zsh
  - thyrfing.zsh
  - venom.zsh
  - windir.zsh
- - bathory
  - burzum
  - dark-funeral
  - darkthrone
  - emperor
  - gorgoroth
  - immortal
  - impaled-nazarene
  - khold
  - marduk
  - mayhem
  - nile
  - taake
  - thyrfing
  - venom
  - windir
- - bathory.conf
  - burzum.conf
  - dark-funeral.conf
  - darkthrone.conf
  - emperor.conf
  - gorgoroth.conf
  - immortal.conf
  - impaled-nazarene.conf
  - khold.conf
  - marduk.conf
  - mayhem.conf
  - nile.conf
  - taake.conf
  - thyrfing.conf
  - venom.conf
  - windir.conf
- - bathory.toml
  - burzum.toml
  - dark-funeral.toml
  - darkthrone.toml
  - emperor.toml
  - gorgoroth.toml
  - immortal.toml
  - impaled-nazarene.toml
  - khold.toml
  - marduk.toml
  - mayhem.toml
  - nile.toml
  - taake.toml
  - thyrfing.toml
  - venom.toml
  - windir.toml
- - bathory.json
  - burzum.json
  - dark-funeral.json
  - darkthrone.json
  - emperor.json
  - gorgoroth.json
  - immortal.json
  - impaled-nazarene.json
  - khold.json
  - marduk.json
  - mayhem.json
  - nile.json
  - taake.json
  - thyrfing.json
  - venom.json
  - windir.json
- - bathory.toml
  - burzum.toml
  - dark-funeral.toml
  - darkthrone.toml
  - emperor.toml
  - gorgoroth.toml
  - immortal.toml
  - impaled-nazarene.toml
  - khold.toml
  - marduk.toml
  - mayhem.toml
  - nile.toml
  - taake.toml
  - thyrfing.toml
  - venom.toml
  - windir.toml
- - config.lua
  - init.lua
  - terminal.lua
  - util.lua
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Black Metal Neovim

![logo](https://github.com/user-attachments/assets/ea628526-a058-4aeb-832f-c99d36d508a0)

The definitive collection of black-metal inspired neovim colorschemes!

This new version is based on the great work done by @cdmill on https://github.com/cdmill/neomodern.nvim. Big hail to him!

If you want to support the project, buy a T-shirt with the logo on [printify](https://black-metal-neovim.printify.me/product/19851229/neovim-graphic-unisex-softstyle-t-shirt-alternative-style-for-music-lovers)!

## Included themes

Here are the included themes. Each band has a default theme (on the left) and an alternative variant (on the right).

### Bathory

![bathory-full](https://github.com/user-attachments/assets/504edd20-df33-4399-bb4a-1b203b8d6a64)

### Burzum

![burzum-full](https://github.com/user-attachments/assets/bfc67176-9c71-4ede-b99e-36048102140d)

### Dark Funeral

![dark-funeral-full](https://github.com/user-attachments/assets/79850c1c-f5ea-4fac-b6d5-e11e0a1db808)

### Darkthrone

![darkthrone-full](https://github.com/user-attachments/assets/25baf96c-85e5-4f84-ac40-39278c71d3f0)

### Emperor

![emperor-full](https://github.com/user-attachments/assets/e12d7afa-06ca-4ccb-881f-3d1d433f7b47)

### Gorgoroth

![gorgoroth-full](https://github.com/user-attachments/assets/4a0cc06f-8f3d-4414-a2e0-2ca1999e896d)

### Immortal

![immortal-full](https://github.com/user-attachments/assets/720931e6-d8d4-479d-986a-088c0937fd7f)

### Impaled Nazarene

![impaled-nazarene-full](https://github.com/user-attachments/assets/bd818bea-1cf1-4ef9-9687-775c2f7440b0)

### Khold

![khold-full](https://github.com/user-attachments/assets/78d95824-0ad7-4cdc-98ea-0d29bf56f798)

### Marduk

![marduk-full](https://github.com/user-attachments/assets/9dca9fea-7a70-490c-b2de-798dcfa8d3f4)

### Mayhem

![mayhem-full](https://github.com/user-attachments/assets/5ccc7621-97e3-4601-b5b8-c550b3dd7042)

### Nile

![nile-full](https://github.com/user-attachments/assets/05b73f47-5bf5-479a-a940-3447fd9e1474)

### Taake

![taake-full](https://github.com/user-attachments/assets/96cfb452-e1ef-4fbb-8c2f-1bb8fc3177dc)

### Thyrfing

![thyrfing-full](https://github.com/user-attachments/assets/ab786221-3c18-48d1-9eff-b4412577ae7f)

### Venom

![venom-full](https://github.com/user-attachments/assets/bacd0404-cf31-4872-ad64-25066bd27a72)

### Windir

![windir-full](https://github.com/user-attachments/assets/7d584730-c8bb-42db-9f49-774a7db14aeb)

## Rationale

Each theme palette is a slight variation of the base one. I picked two accent colors from an album cover for each band. I also included an alternative variant for each album with a not-black background.

## Installation

With lazy.nvim:

```lua
-- Using lazy.nvim
{
  "metalelf0/black-metal-theme-neovim",
  lazy = false,
  priority = 1000,
  config = function()
    require("black-metal").setup({
      -- optional configuration here, e.g.:
      trve = true, -- switch this to false if you want light variants
    })
    require("black-metal").load()
  end,
}
```

## Configuration

There are 16 themes included, each with a dark, alternative and light variant. Yes, I know, light variants aren't `TRVE`. There is no light in trve black metal, so light variants are disabled by default -- pass `{ trve = false }` to `setup(options)` if you insist on using them.
The light theme is used when `{ variant = "light" }` is passed to `setup(options)` or when `vim.o.background = "light"` (and `trve = false`).

If you are ok with the default config, just load themes with `:colorscheme <band_name>`, `:colorscheme <band_name>-alt`, `:colorscheme <band_name>-light` (light), or `:colorscheme <band_name>-light-alt` (light, alternative bg). If you need further customization, here you go:

Default options are given below:

```lua
require("black-metal").setup({
  -----MAIN OPTIONS-----
  --
  -- Can be one of: bathory | burzum | dark-funeral | darkthrone | emperor | gorgoroth | immortal | impaled-nazarene | khold | marduk | mayhem | nile | taake | thyrfing | venom | windir
  theme = "bathory",
  -- Can be one of: 'light' | 'dark', or set via vim.o.background
  variant = "dark",
  -- Use an alternate, lighter bg
  alt_bg = false,
  -- If true, docstrings will be highlighted like strings, otherwise they will be
  -- highlighted like comments. Note, behavior is dependent on the language server.
  colored_docstrings = true,
  -- If true, highlights the {sign,fold} column the same as cursorline
  cursorline_gutter = true,
  -- If true, highlights the gutter darker than the bg
  dark_gutter = false,
  -- if true favor treesitter highlights over semantic highlights
  favor_treesitter_hl = false,
  -- Don't set background of floating windows. Recommended for when using floating
  -- windows with borders.
  plain_float = false,
  -- Show the end-of-buffer character
  show_eob = true,
  -- If true, enable the vim terminal colors
  term_colors = true,
  -- Keymap (in normal mode) to toggle between light and dark variants.
  toggle_variant_key = nil,
  -- Don't set background
  transparent = false,
  -- There is no light in trve black metal: if true, light variants are disabled
  -- and loading one falls back to dark. Set to false to allow light variants.
  trve = true,

-----DIAGNOSTICS and CODE STYLE-----
  --
  diagnostics = {
    darker = true, -- Darker colors for diagnostic
    undercurl = true, -- Use undercurl for diagnostics
    background = true, -- Use background color for virtual text
  },
  -- The following table accepts values the same as the `gui` option for normal
  -- highlights. For example, `bold`, `italic`, `underline`, `none`.
  code_style = {
    comments = "italic",
    conditionals = "none",
    functions = "none",
    keywords = "none",
    headings = "bold", -- Markdown headings
    operators = "none",
    keyword_return = "none",
    strings = "none",
    variables = "none",
  },

-----PLUGINS-----
  --
  -- The following options allow for more control over some plugin appearances.
  plugin = {
    lualine = {
      -- Bold lualine_a sections
      bold = true,
      -- Don't set section/component backgrounds. Recommended to not set
      -- section/component separators.
      plain = false,
    },
    cmp = { -- works for nvim.cmp and blink.nvim
      -- Don't highlight lsp-kind items. Only the current selection will be highlighted.
      plain = false,
      -- Reverse lsp-kind items' highlights in blink/cmp menu.
      reverse = false,
    },
  },

-- CUSTOM HIGHLIGHTS --
  --
  -- Override default colors
  colors = {},
  -- Override highlight groups
  highlights = {},
})
-- Convenience function that simply calls `:colorscheme <theme>` with the theme
-- specified in your config.
require("black-metal").load()
```

## Customization

Example using custom colors and highlights:

```lua
require("black-metal").setup {
  colors = {
    orange = '#ff8800', -- define a new color
    keyword = '#817faf', -- redefine an existing color
  },
  highlights = {
    ...
    ["@keyword"] = { fg = "$keyword", fmt = 'bold' },
    ["@function"] = { bg = "$orange", fmt = 'underline,italic' },
    ...
  },
}
```

See `black-metal.palette` for color names.

## Cover references

- Bathory: Hammerheart, 1990
- Burzum: Filosofem, 1996
- Dark Funeral: The secrets of the black arts, 1996
- Darkthrone: Transilvanian Hunger, 1994
- Emperor: In the nightside eclipse, 1994
- Gorgoroth: Twilight of the Idols - In Conspiracy with Satan, 2003
- Immortal: At the heart of winter, 1999
- Impaled Nazarene: Tol Cormpt Norz Norz Norz..., 1993
- Khold: Phantom, 2002
- Marduk: Panzer Division Marduk, 1999
- Mayhem: The dawn of the black hearts, 1995
- Nile: Black seeds of vengeance, 2000
- Taake:  Hordalands doedskvad, 2005
- Thyrfing: Valdr Galga, 1999
- Venom: Welcome to hell, 1981
- Windir: Arntor, 1999

## Disclaimers

- I know Nile don't play black metal, but I don't want to name the repo 'Black Metal and Technical Death Metal' ;).
- Darkthrone don't have an alternative variant. Bear with it. It's Transilvanian Hunger. Black and white, no need for any other color.
- Bands and album choices have been made completely on personal taste. If your fave band is missing, just ask and I'll try adding it.

black-metal-theme-neovim

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

black-metal-theme-neovim

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README