/gruvbox-material

Gruvbox with Material Palette

Primary LanguageVim scriptMIT LicenseMIT

𝑶𝒓𝒊𝒈𝒊𝒏𝒂𝒍 𝑮𝒓𝒖𝒗𝒃𝒐𝒙 𝑮𝒓𝒖𝒗𝒃𝒐𝒙 𝑴𝒂𝒕𝒆𝒓𝒊𝒂𝒍
𝒉𝒂𝒓𝒅 original-hard material-hard
𝒎𝒆𝒅𝒊𝒖𝒎 original-medium material-medium
𝒔𝒐𝒇𝒕 original-soft material-soft

Gruvbox Material is based on Gruvbox, but with a very different color palette, almost all foreground colors are adjusted.

The syntax highlighting logic in this branch is the same as the original gruvbox, and I will periodically merge changes from gruvbox-community/gruvbox.

In addition, I've developed neosyn branch that uses completely different syntax highlighting logic, and it has also been optimized for common file types and plugins.

Installation

Via Plugin Manager

Take vim-plug for example:

Plug 'sainnhe/gruvbox-material'

For better syntax highlighting support, please install sheerun/vim-polyglot.

Manually

  1. Clone this repository.
  2. Copy /path/to/gruvbox-material/colors/* to ~/.vim/colors/
  3. To install airline theme, copy /path/to/gruvbox-material/autoload/airline/themes/gruvbox_material.vim to ~/.vim/autoload/airline/themes/gruvbox_material.vim
  4. To install lightline theme, copy /path/to/gruvbox-material/autoload/lightline/colorscheme/gruvbox_material.vim to ~/.vim/autoload/lightline/colorscheme/gruvbox_material.vim

AUR

There is a package available for Arch Linux users in AUR: gruvbox-material-git

Usage

Vim

Put this in your vimrc:

set termguicolors

colorscheme gruvbox-material

" for soft background
colorscheme gruvbox-material-soft

" for hard background
colorscheme gruvbox-material-hard

If you want to apply this color scheme temporarily, run this command in vim(this may cause color broken):

:colorscheme gruvbox-material

Airline

To enable airline color scheme, put this in your vimrc:

let g:airline_theme = 'gruvbox_material'

To apply it without reloading:

:AirlineTheme gruvbox_material

Lightline

To enable lightline color scheme, put this in your vimrc:

let g:lightline = {}
let g:lightline.colorscheme = 'gruvbox_material'

" or this line
let g:lightline = {'colorscheme' : 'gruvbox_material'}

To apply it without reloading:

:let g:lightline.colorscheme = 'gruvbox_material'
:call lightline#init()
:call lightline#colorscheme()

Customization

  • By default, italic is enabled. To disable italic, add let g:gruvbox_material_kill_italic=1 to your vimrc.
  • By default, bold is partly enabled. To completely enable bold, add let g:gruvbox_material_enable_bold=1 to your vimrc.
  • By default, bold is enabled in lightline color scheme. To disable bold in lightline color scheme, add let g:gruvbox_material_lightline_kill_bold=1 to your vimrc.

Contribution

Check this gist for detailed instructions to hack this color scheme: hack-color-schemes.md

Related Projects

License

MIT && Anti-996