Introduction

crates-io downloads license dependency-status status-badge CodeBerg MatrixChat

If comming from v2, please check v3 breaking changes.

wallust is a command line tool for creating 16 color palettes, since it was the original intent of pywal, the tool that inspired the creation of wallust.

gif

Features

  • Includes man pages and completions!
  • Sets terminal colors on all (or the current, -u) active terminals:
  • Cache scheme palettes, overwritten by -w:
    • Linux: $XDG_CACHE_HOME or $HOME/.cache
    • MacOs: $HOME/Library/Caches
    • Windows: {FOLDERID_LocalAppData}
  • Read pywal/terminal-sexy colorschemes with wallust cs.
  • Built-in themes with wallust theme (compile time feature).
  • Optional Configuration file, wallust.toml:
    • wallust checks for ~/.config/wallust/wallust.toml for the config file, if not found it will use default implementations.
    • Configuration variables are avaliable as cli flags.
    • Optional templating with a subset of Jinja2 or pywal syntax if selected.
    • Configurable methods for backends, colorspaces, palettes and threshold.
    • OS dependant path:
      • Linux: $XDG_CONFIG_HOME or $HOME/.config
      • MacOs: $HOME/Library/Application Support
      • Windows: {FOLDERID_RoamingAppData}
MethodsDescription
BackendsHow to extract the colors from the image. (e.g pywal uses convert)
ColorSpaceGet the most prominent color, and sort them according to the Palette, configurable by a threshold
PaletteMakes a scheme palette with the gathered colors, (e.g. sets light background)