1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
| This is a fork of [chriskempson](https://github.com/chriskempson)'s [base16-vim](https://github.com/chriskempson/base16-vim) which refreshes and commits new themes weekly automatically and has a documented build process. |
| :-- |
| Development has continued beyond the automation of the repository since the moment of the fork. See [the full diff here](https://github.com/fnune/base16-vim/compare/c8a7da6...HEAD). |
# Base16 Vim
See the [Base16 repository](https://github.com/chriskempson/base16) for more information.
This theme was built with [base16-builder-python](https://github.com/InspectorMustache/base16-builder-python).
Supports graphical Vim and console Vim.
Over [70 themes](https://github.com/chriskempson/base16-schemes-source/blob/master/list.yaml) plus light/dark variations are available. Here are some of my favorites:
The `classic-dark` theme:
![base16-vim classic-dark](/screenshots/base16-vim-screenshot-classic-dark.png)
The `horizon-dark` theme:
![base16-vim horizon-dark](/screenshots/base16-vim-screenshot-horizon-dark.png)
The `onedark` theme:
![base16-vim onedark](/screenshots/base16-vim-screenshot-onedark.png)
## Terminal Themes
For terminal Vim (non-gui) please ensure you are using a base16 terminal theme.
* [iTerm2](https://github.com/chriskempson/base16-iterm2)
## Installation
Add `colorscheme base16-default-dark` to your `~/.vimrc`.
### Vundle
Add the following to your `~/.vimrc` file and run `PluginInstall` in Vim.
Plugin 'fnune/base16-vim'
### vim-plug
Add the following to your `~/.vimrc` file and run `PlugInstall` in Vim.
Plug 'fnune/base16-vim'
### Pathogen
cd ~/.vim/bundle
git clone https://github.com/fnune/base16-vim.git
### Manual
cd ~/.vim/colors
git clone git://github.com/fnune/base16-vim.git base16
cp base16/colors/*.vim .
## 256 colorspace
If using a Base16 terminal theme designed to keep the 16 ANSI colors intact (a "256" variation) **and** have sucessfully modified your 256 colorspace with [base16-shell](https://github.com/chriskempson/base16-shell) you'll need to add the following to your `~/.vimrc` **before** the colorsheme declaration.
let base16colorspace=256 " Access colors present in 256 colorspace
This will cause vim to access the colours in the modified 256 colorspace. Please **do not** enable this simply because you have a 256 color terminal as this will cause colors to be displayed incorrectly.
## Troubleshooting
There is a script to help troubleshoot colour issues called `colortest` available in the [Base16 Shell](https://github.com/fnune/base16-shell) repository.
If you are using a ISO-8613-3 compatible terminal (
[vim docs](https://github.com/vim/vim/blob/23c1b2b018c8121ca5fcc247e37966428bf8ca66/runtime/doc/options.txt#L7876),
[neovim docs](https://neovim.io/doc/user/options.html#'termguicolors')), and
you see a green or blue line, try to enable `termguicolors`:
```vim
set termguicolors
```
### Green line numbers
![green line numbers screenshot](https://raw.github.com/chriskempson/base16-vim/master/without-base16colorspace-256-with-256-terminal-theme.png)
If your Vim looks like the above image you are using a 256 terminal theme without setting `let base16colorspace=256` in your `~/.vimrc`. Either set `let base16colorspace=256` in your `~/.vimrc` or use a non 256 terminal theme.
### Blue line numbers
![blue line numbers screenshot](https://raw.github.com/chriskempson/base16-vim/master/with-base16colorspace-256-without-base16-shell.png)
If your Vim looks like the above image you are setting `let base16colorspace=256` in your `~/.vimrc` but either not running [Base16 Shell](https://github.com/fnune/base16-shell) or [Base16 Shell](https://github.com/fnune/base16-shell) is not working for your terminal. Either ensure [Base16 Shell](https://github.com/fnune/base16-shell) is working by running the `colortest` available in the [Base16 Shell](https://github.com/fnune/base16-shell) repository or not setting `let base16colorspace=256` in your `~/.vimrc`.
## Customization
If you want to do some local customization, you can add something like this to your `~/.vimrc`:
```vim
function! s:base16_customize() abort
call Base16hi("MatchParen", g:base16_gui05, g:base16_gui03, g:base16_cterm05, g:base16_cterm03, "bold,italic", "")
endfunction
augroup on_change_colorschema
autocmd!
autocmd ColorScheme * call s:base16_customize()
augroup END
```
## Building
Dependencies:
- Python, at least version 3.5
- The `pybase16` command from [base16-builder-python](https://github.com/InspectorMustache/base16-builder-python)
- The `make` command
```
# Install dependencies (you probably already have pip/pip3 and make)
apt install build-essential # for make
pip3 install pybase16-builder
# Build the packages
make
```
|