A ritualistic colorscheme for (n)vim. Perform your dark magick using clearly defined contrasting colors with a pinch of earthly tint to for that homely feel.

Requirements

Most modern terminal supports 24bit color, and srcery works best with that, but 8bit color is also supported as a fallback.

We maintain a repository of terminal configurations if you also want to set your terminalm colorscheme to match vim.

Installation

Manually

Use colors/srcery.vim however you want, or use your favorite plugin manager to install. For some plugin themes to work you need to clone the entire project, and put it on your runtimepath.

Vim 8

Vim 8 has native support for loading plugins by using packages. All you need to do to, is to clone this repository into ~/.vim/pack/themes/opt.

git clone https://github.com/srcery-colors/srcery-vim ~/.vim/pack/themes/opt/srcery-vim

And then set your .vimrc accordingly.

packadd! srcery-vim
colorscheme srcery

The same works for Neovim, but you have to clone it into a path where Neovim can find it.

git clone https://github.com/srcery-colors/srcery-vim $XDG_CONFIG_HOME/nvim/pack/themes/opt

dein.vim

call dein#add('srcery-colors/srcery-vim')

vim-pathogen

cd ~/.vim/bundle
git clone https://github.com/srcery-colors/srcery-vim

vim-plug

Plug 'srcery-colors/srcery-vim'

packer

  use {'srcery-colors/srcery-vim', as = 'srcery'}

lazy.nvim

{
    "srcery-colors/srcery-vim",
    lazy = false,
    priority = 1000,
    config = function()
        vim.g.srcery_normal_float = 1
        vim.cmd([[colorscheme srcery]])
    end,
}

Usage

:color srcery

If you like what you see and decide to make srcery your default colorscheme, add the relevant line to your .vimrc:

colorscheme srcery

Configuration

Make sure that you set these variables before assigning colorscheme.

Colors

You can customize each of Srcery's colors, to customize say the red color:

let g:srcery_red = '#FF0000'

You can also separately set a different background color g:srcery_background, instead of the default g:srcery_black

Options

var	description	default
g:srcery_bold	Enables bold text	1 (enabled)
g:srcery_italic	Enables italic text	Enabled if available
g:srcery_underline	Enables underlined text	1 (enabled)
g:srcery_undercurl	Enables undercurled text	1 (enabled)
g:srcery_strikethrough	Enables strikethrough text	1 (enabled)
g:srcery_inverse	Enables inverse highlighting for visual selection, search, etc	1 (enabled)
g:srcery_guisp_fallback	Use alternate highlighting for for colored underline/undercurl. Set to either fd or bg, or NONE	NONE

Screenshots

TBD

Plugin support

Lightline

Lightline colorscheme. To use it, include 'srcery' value in lightline configuration, like so:

let g:lightline = {
      \ 'colorscheme': 'srcery',
      \ }

Lualine

Lualine colorscheme. It's the same as Lightline's. Enable it in your configuration:

require('lualine').setup {
  options = {
    theme = 'srcery',
  },
}

Airline

Thanks to MindTooth, Srcery now includes an Airline theme.

Attribution

This project started as essentially a palette swap of Gruvbox and all credit goes to the maintainers of that fantastic color scheme.

These themes have also been an inspiration

• Nord
• moonfly
• Base16
• Badwolf
• Jellybeans
• Molokai

License

Copyright (c) 2018 for portions of Srcery are held by morhetz morhetz@gmail.com as part of Gruvbox. All other Copyright (c) 2021 for Srcery are held by Daniel Berg mail@roosta.sh and contributers of Srcery.

• MIT License