Home

Awesome

vivid-zsh

vivid LS_COLORS as zsh plugins.

installable anywhere that supports git repositories as plugins.

why do i need this?

simply put, this is faster than calling an external CLI.

benchmark results via hyperfine

CommandMean [ms]Min [ms]Max [ms]Relative
plugin0.2 ± 0.40.03.11.00
cli3.8 ± 2.41.927.316.36 ± 27.48
$ hyperfine --shell "zsh" --warmup=5 'vivid_theme=nord source vivid-zsh.plugin.zsh' -n plugin 'export LS_COLORS="$(vivid generate nord)"' -n cli

yes, this is faster than rust. insane.

how do i install this?

it depends on what you are using for managing your zsh plugins.

antidote

  1. add ryanccn/vivid-zsh to your .zsh_plugins.txt
  2. set
    vivid_theme="<name of theme>"
    
    before antidote load

antigen

  1. antigen bundle ryanccn/vivid-zsh
  2. set
    vivid_theme="<name of theme>"
    
    in your ~/.zshrc before antigen loads

oh my zsh

  1. clone the repo into the oh my zsh directory
    $ git clone https://github.com/ryanccn/vivid-zsh ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/vivid-zsh
    
  2. add the plugin to your ~/.zshrc
    plugins=(
       # other plugins...
       vivid-zsh
    )
    
  3. configure vivid_theme="<name of theme>" before oh my zsh is initialized

manual (no plugin manager)

  1. clone the repo
    $ mkdir -p ~/.zsh
    $ git clone https://github.com/ryanccn/vivid-zsh.git ~/.zsh/vivid-zsh
    
  2. add this to your .zshrc
    vivid_theme="<name of theme>"
    source ~/.zsh/vivid-zsh/vivid-zsh.zsh
    
  3. restart your shell

how does this work?

how do i build themes locally?

  1. install vivid
  2. run ./build.sh

license

mit