pywal16.nvim

OK, hold my beer while I'll try to explain what this repository is.

Pywal16.nvim (this repo) is a fork/modification of the unmaintained pywal.nvim, aiming to support a transparent background, 16 colors palettes, and more plugins.

This fork is made to work with pywal16, which is itself a fork of pywal, generating/supporting 16 colors colorschemes (original pywal project only supports 9 colors).

Here is what the nvim/pywal ecosystem looked like when I started this fork:

pywal version	editor	colorscheme
dylanaraps/pywal (archived)	vim	dylanaraps/wal.vim (archived)
dylanaraps/pywal (archived)	neovim	AlphaTechnolog/pywal.nvim (archived) oncomouse/Lushwal.nvim sonjiku/yawnc.nvim RedsXDD/neopywal.nvim ...
eylles/pywal16	vim	?
eylles/pywal16	neovim	uZer/pywal16.nvim ◄ (you are here!)

This colorscheme is compatible with "classic" 16 colors palettes (solarized, molokai, base16, etc.), and has been made to preserve the "red", "green" and "yellow" implicit meanings. Please note that the presaved themes bundled in pywal16 or pywal don't all take profit of the 16 colors. You can find some extra colorschemes I made in my dotfiles repository.

Pywal.nvim from AlphaTechnolog was a reimplementation of dylanaraps/(py)wal.vim totally written in lua, with extra plugin support.

This plugin takes advantage of termguicolors (which was unsupported by wal.vim) and won't use/declare any ctermbg or ctermfg.

• pywal16.nvim
  • Screenshots
  • Plugin Support
  • Installation
  • Active theme
  • Enable lualine theme
  • Enable the feline theme (untested with pywal16, I don't use feline)
  • Using the core to get the colors
  • How it works
  • Hack me
  • Thanks
  • Enjoy

Screenshots

using a custom pywal16 colorscheme with 16 different colors, preserving red, yellow and green for error, warn, etc.

using wallpaper generated themes

Plugin Support

• NeoVim (checkhealth...)
• BetterWhitespace
• BufferLine
• Coc
• Diff
• Feline
• GitGutter
• GitSigns
• Indent-BlankLine
• Illuminate
• LSP
• LspSaga
• LspTrouble
• Lualine
• Neogit
• NvimTree
• nvim-navic
• Nvim-scrollbar
• Telescope
• Tree-sitter
• ...

Feel free to fork or to PR other integrations.

Installation

You can install this plugin with packer:

use { 'uZer/pywal16.nvim', as = 'pywal16' }

With lazy:

{
  'uZer/pywal16.nvim',
  -- for local dev replace with:
  -- dir = '~/your/path/pywal16.nvim',
  config = function()
    vim.cmd.colorscheme("pywal16")
  end,
}

With vim-plug:

Plug 'uZer/pywal16.nvim', { 'as': 'pywal16' }

Active theme

To enable the theme, call this in your neovim config:

local pywal16 = require('pywal16')

pywal16.setup()

Or with vim script:

colorscheme pywal16

It will set automatically the vim.opt.termguicolors to true

Enable lualine theme

Place this in your lualine config:

local lualine = require('lualine')

lualine.setup {
  options = {
    theme = 'pywal16-nvim',
  },
}

Enable the feline theme

note: this part comes from AlphaTechnolog project I forked, I don't use feline so I never tested this part of the theme

You can put this to your config to activate the feline config:

local present, feline = pcall(require, 'feline')

if not present then
  return
end

local present, pywal16_feline = pcall(require, 'pywal16.feline')

if not present then
  return
end

feline.setup({
  components = pywal16_feline,
})

Then you should see the feline bar working successfully.

Using the core to get the colors

If you want to get the colors into a lua dictionary:

local colors = require('pywal16.core').get_colors()

How it works

pywal/pywal16 automatically generates a file called colors-wal.vim in ~/.cache/wal/colors-wal.vim, this file contains all the colors that are necesary to works for vim and looks like this:

" Special
let wallpaper  = "/home/user/Pictures/winter-purple.jpg"
let background = "#110914"
let foreground = "#e3cfe2"
let cursor     = "#e3cfe2"

" Colors
let color0  = "#110914"
let color1  = "#A378B6"
let color2  = "#B687AD"
let color3  = "#D9A2AF"
let color4  = "#F8DDAD"
let color5  = "#AD90CF"
let color6  = "#D2ACD6"
let color7  = "#e3cfe2"
let color8  = "#9e909e"
let color9  = "#A378B6"
let color10 = "#B687AD"
let color11 = "#D9A2AF"
let color12 = "#F8DDAD"
let color13 = "#AD90CF"
let color14 = "#D2ACD6"
let color15 = "#e3cfe2"

The theme only reads this file/these variables and then create a colors dictionary to create a theme based in the colors.

Please note that in "classic" colorschemes (the ones shipped with your terminal, base16, etc.), some color shades are always at the same position of the palette (green, red...) and have meanings for humans (red is for errors, orange is for warnings, etc.).

With this colorscheme, I made my best to preserve these positions in the 16color palette (the numbers) for colors with implicit meaning from classic themes. This will only make sense if you use predefined colorschemes (solarized, molokai, etc.). Please also be aware that most colorschemes shipped in pywal/pywal16 don't exactly implement the 16color palettes (most use only 9), which can make you feel sad at some point. Make your own :)

TL;DR: for non-colorblind people, if you use predefined colorschemes instead of your wallpaper, errors will be in red shades most of the time, which is pretty much what we expect, right?

Hack me

Feel free to modify anything you want in this theme on your own fork, or to open PR if you want to add and/or change some features on this one. I changed most of the initial colors, added some plugin support and highlights, but mostly didn't touch the original files. I'm slow to review PRs, sorry in advance.

Thanks

dylanaraps (pywal)

eylles (pywal16)

AlphaTechnolog (original pywal.nvim)

Contributors

Enjoy

If you like this work you can give it a star :)