/vim-dim

Dim (/dɪm/; a contraction of Default IMproved) is a clone of Vim’s default colorscheme, with some improvements.

Primary LanguageVim Script

Dim

Dim (/dɪm/; a contraction of Default IMproved) is a clone of Vim’s default colorscheme, with some improvements:

  • It only uses ANSI colors, so you can assign colors in your terminal emulator yourself
  • Syntax highlighting is consistent on light and dark backgrounds

Dim comes with Grim: a monochrome version that limits syntax coloring to grayscales.

Installation

git clone --branch 1.x git@github.com:jeffkreeftmeijer/vim-dim.git ~/.vim/pack/plugins/start/vim-dim

After installing, set your :colorscheme to dim or grim.

" ~/.vimrc
colorscheme dim

Pessimistic versioning branches

Dim adheres to semantic versioning, meaning it'll try to keep backwards compatibility in minor and patch releases. In short:

  • A breaking change will bump the major version number (1.0.0 -> 2.0.0)
  • An added feature will bump the minor version number (1.0.0 -> 1.1.0)
  • A bug fix will bump the patch version number (1.0.0 -> 1.0.1)

Since Vim's plugin manager doesn't allow specifying version ranges, Dim provides "pessimistic versioning branches" itself to allow users to lock to a specific version range:

  • The branch named 1.x is updated for every released version in the 1.x range (~> 1.0 or >= 1.0.0 and < 2.0.0)
  • The branch named 1.1 is updated for every released version in the 1.1.x range (~> 1.1.0 or >= 1.1.0 and < 1.2.0)

To install the latest version in the 1.x range, clone Dim's 1.x branch:

git clone --branch 1.x git@github.com:jeffkreeftmeijer/vim-dim.git ~/.vim/pack/plugins/start/vim-dim

When updating through git pull later, Dim will be updated to any new version, but not to 2.x.

Comparison

colorscheme default colorscheme dim
wwdc16.terminal wwdc16 dark with Vim's default color schemewwdc16 light with Vim's default color scheme wwdc16 dark with Dimwwdc16 light with Dim
appsignal.terminal appsignal dark with Vim's default color schemeappsignal light with Vim's default color scheme appsignal dark with Dimappsignal light with Dim
Dimmed comments, line numbers, folds, color columns and completion menus. Comments and line numbers in Vim's default color scheme Comments and line numbers in the Dim color scheme
Inverted selections Selections in Vim's default color scheme Selections in the Dim color scheme
Clear diff coloring Diff coloring in Vim's default color scheme Diff coloring in the Dim color scheme