Repository files navigation

Srcery is a color scheme with clearly defined contrasting colors and aslightly earthy tone.

You don’t need to do anything for this colorscheme to work in gVim or MacVim.

To use Srcery in the terminal you need to change your terminal emulator’sso-called “ASCII” colors to the ones in the table below. There's a list ofterminal configurations in thesrcery-terminal repository.

IMG	TERMCOL	NR	VAR	HEX	RGB	HSL
	black	0	g:srcery_black	#1C1B19	28, 27, 25	40, 6%, 10%
	red	1	g:srcery_red	#EF2F27	239, 47, 39	2, 86%, 55%
	green	2	g:srcery_green	#519F50	81, 159, 80	119, 33%, 47%
	yellow	3	g:srcery_yellow	#FBB829	251, 184, 41	41, 96%, 57%
	blue	4	g:srcery_blue	#2C78BF	44, 120, 191	209, 63%, 46%
	magenta	5	g:srcery_magenta	#E02C6D	224, 44, 109	338, 74%, 53%
	cyan	6	g:srcery_cyan	#0AAEB3	10, 174, 179	182, 89%, 37%
	white	7	g:srcery_white	#BAA67F	186, 166, 127	40, 30%, 61%
	brightblack	8	g:srcery_bright_black	#918175	145, 129, 117	26, 11%, 51%
	brightred	9	g:srcery_bright_red	#F75341	247, 83, 65	6, 92%, 61%
	brightgreen	10	g:srcery_bright_green	#98BC37	152, 188, 55	76, 55%, 48%
	brightyellow	11	g:srcery_bright_yellow	#FED06E	254, 208, 110	41, 99%, 71%
	brightblue	12	g:srcery_bright_blue	#68A8E4	104, 168, 228	209, 70%, 65%
	brightmagenta	13	g:srcery_bright_magenta	#FF5C8F	255, 92, 143	341, 100%, 68%
	brightcyan	14	g:srcery_bright_cyan	#2BE4D0	43, 228, 208	174, 77%, 53%
	brightwhite	15	g:srcery_bright_white	#FCE8C3	252, 232, 195	39, 90%, 88%

Additionally Srcery uses somexterm 256colorsto pad out the color selection, no extra configuration needed.

IMG	NAME	NR	VAR	HEX	RGB	HSL
	orange	202	g:srcery_orange,g:srcery_orange_cterm	#FF5F00	255, 95, 0	22, 100%, 50%
	bright_orange	208	g:srcery_bright_orange,g:srcery_bright_orange_cterm	#FF8700	255, 135, 0	32, 100%, 50%
	hard_black	233	g:srcery_hard_black,g:srcery_hard_black_cterm	#121212	18, 18, 18	0, 0%, 7%
	xgray1	235	g:srcery_xgray1,g:srcery_xgray1_cterm	#262626	38, 38, 38	0, 0%, 15%
	xgray2	236	g:srcery_xgray2,g:srcery_xgray2_cterm	#303030	48, 48, 48	0, 0%, 19%
	xgray3	237	g:srcery_xgray3,g:srcery_xgray3_cterm	#3A3A3A	58, 58, 58	0, 0%, 23%
	xgray4	238	g:srcery_xgray4,g:srcery_xgray4_cterm	#444444	68, 68, 68	0, 0%, 27%
	xgray5	239	g:srcery_xgray5,g:srcery_xgray5_cterm	#4E4E4E	78, 78, 78	0, 0%, 31%
	xgray6	240	g:srcery_xgray6,g:srcery_xgray6_cterm	#585858	88, 88, 88	0, 0%, 35%

Download or clone srcery's repository to a location of your choosing and set yourruntimepath correctly, otherwise srcery will not work as it relies on theautoload functionality.

You can also install with your favourite plugin manager.

Vim 8 has native support for loading plugins by usingpackages. 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-vimcolorscheme srcery

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

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

calldein#add('srcery-colors/srcery-vim')

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

Plug'srcery-colors/srcery-vim'

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

: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

Srcery includes a few toggles due to discrepancies in the various setups possible.To change any of these you'd put something like this in your.vimrc

letg:srcery_italic=1

Make sure that you set these variables before assigningcolorscheme.

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

letg:srcery_red='#FF0000'

Inside a 256-color terminal emulator, additional colors are configurablevia setting the corresponding variable with the _cterm suffix, e.g.

letg:srcery_hard_black_cterm=232

Refer to thetable for a full list of color variables, hexes and more.

This will only work onset termguicolors and in gVim, to override terminalcolors, do so in yourterminalconfiguration.

Enables bold text.

Default: 1

Enables italic text.

Default: gui 1, term 0

Enables underlined text.

Default: 1

Enables undercurled text.

Default: 1

Enables strikethrough text.

Default: 1

Enable or disable inverse highlighting (foreground becomes background,vice versa). This is used for visual selection, search highlights andsome other things.

Srcery will fall back to other methods of highlighting if this isdisabled.

Default: 1

Highlight search matches using inverse colors.

Default: 0

When enabled will highlight matching delimiters using inverse colors.(:DoMatchParen)

Works best withRainbow parenthesis.

Default: 0

Dims lisp dialects delimiters to a fairly dark gray (xgray5 specifically).

Default: 0

Sets up alternate highlighting for colored underline/undercurl. Someenvironments are unable to color underline, so this setting will set either thebackground or foreground to whatever color the underline is supposed to be.

This comes in handy if colored underline doesn't work, or underline is disabledentirely.

Default: 'NONE'

Possible Values: 'fg', 'bg'

Italicize types if italic is enabled.

Default: 0

Let's you customize the background color. This var takes a list with twovalues, with a quoted HEX in the first position, and a terminal color index forthe second position. This lets you set both a 24-bit color, and a 8bit terminalcolor index.

You can specify'NONE' as one of the values to make it transparent, as such['NONE', 'NONE'] would be the same as the previous optiong:srcery_bg_passthrough = 1.

You can specify'DEFAULT' as one of the values in order to use thatposition's default value.

Default:[g:srcery_black, 0]

If enabled, will set the terminal background in vim to hard black.Note that this currently only works in Vim, not Neovim.

Default: 1

viml, bash

clojure, elisp

c, rust

python, js

git, terminal

Typeface used in screenshots isIosevka

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

letg:lightline= {\'colorscheme':'srcery',\}

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

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

Thanks toMindTooth, Srcery now includes anAirline theme.

These don't require any additional configuration.

• ale
• coc.nvim
• ctrlp.vim
• fzf.vim
• nerdtree
• nvim-cmp
• nvim-treesitter
• telescope-nvim
• vim-clap
• vim-gitgutter
• vim-indent-guides
• vim-sneak
• vim-startify

Plugin support is still a work in progress and more will come, if there isanything missing that you'd like to add please open an issue and let me know.

This project started as essentially a palette swap ofGruvbox and all credit goes to themaintainers of that fantastic color scheme. I wanted something a bit sharper, butI loved the syntax color choices of Gruvbox. I also tried to make the theme assimple to use as possible, which was inspired byFlattened. Other themes that influencedSrcery:

• Base16
• Badwolf
• Jellybeans
• Molokai

Ensure that 256 colors are enabled in vim by setting this optionbefore setting the colorscheme.

sett_Co=256

If you want to use GUI colors in terminal make sure that tmux passthrough 24-bit color codes. For example, if you useTermite add it to theterminal overrides setting:

set -ga terminal-overrides",xterm-termite:Tc"

For other terminals, replacexterm-termite with the relevantterminal type. (stored in$TERM).

SeeArch wikiand thisissue.

Check outsrcery-emacs