1
0
Fork
You've already forked wallust
0
"a better pywal", but it's more than that :)
  • Rust 64.6%
  • Shell 16%
  • PowerShell 8.4%
  • Elvish 4.2%
  • CSS 1.7%
  • Other 5.1%
Find a file
2025年05月12日 19:00:04 +00:00
.woodpecker woodpecker: fix deprecation 2025年01月20日 23:14:32 -05:00
benches benches: require iter feature and refactor some of it's code 2024年02月18日 18:50:29 -05:00
completions update wallust_theme version and update assets with new gogh themes 2025年03月22日 18:05:18 -05:00
docs fix #117 , remove comment on kmeans backend 2025年02月19日 20:47:43 -05:00
man new minor version: 3.3.0 2025年03月24日 11:01:02 -05:00
src colorspaces: a bit more idiomatic refactor 2025年03月31日 13:17:39 -05:00
tests fix up cache test 2025年03月24日 10:37:41 -05:00
.gitignore .gitignore: add book/ 2024年07月24日 22:12:26 -05:00
book.toml restructure docs: 2024年07月24日 22:13:09 -05:00
build.nix nix: fix build of wallust ( #67 ) 2024年07月25日 18:41:02 +00:00
build.rs update some themes completitions and fix conflicts with buildgen 2025年01月23日 23:13:18 -05:00
Cargo.lock Cargo.lock: update ( #153 ) 2025年05月11日 23:08:13 +00:00
Cargo.toml new minor version: 3.3.0 2025年03月24日 11:01:02 -05:00
default.nix nix: fix build of wallust ( #67 ) 2024年07月25日 18:41:02 +00:00
flake.lock flake.lock: update ( #148 ) 2025年05月05日 02:53:42 +00:00
flake.nix nix: fix build of wallust ( #67 ) 2024年07月25日 18:41:02 +00:00
LICENSE root commit 2023年03月24日 17:54:06 -05:00
Makefile new minor version: 3.3.0 2025年03月24日 11:01:02 -05:00
README.md Update README.md 2025年05月12日 19:00:04 +00:00
schema.json update wallust_theme version and update assets with new gogh themes 2025年03月22日 18:05:18 -05:00
wallust.toml new minor version: 3.3.0 2025年03月24日 11:01:02 -05:00

wallust - Generate colors from an image

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


gif

sources: adwaita - scenic view of mountains - rms by marco novo - pixels - linus talking

If coming from v2, please check v3 breaking changes.

Usage

wallust run my_wallpaper.png

use wallust -h for an overview and wallust --help for a more detailed explanation

Docs

For ease of use you can check detailed docs with man pages (rather than cmd -hing everytime):

  • man wallust, information about terminal colors and template syntax;
  • man wallust.5, config docs;
  • man wallust-subcommand, displays a man page for subcommand.

There is also a web page for documentation! It's based on plain markdown, so you could also read it locally at docs/ directory.

Features

  • Includes man pages and completions!
  • Feature rich templating:
    • You can use a subset of Jinja2 (default).
    • Alternatively, simply use the pywal syntax (requires selecting it on the config file).
  • 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).
  • Configuration file at wallust.toml (but wallust can work without one!):
    • 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.
    • 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}
Methods Description
Backends How to extract the colors from the image. (e.g pywal uses convert)
ColorSpace Get the most prominent color, and sort them according to the Palette, configurable by a threshold
Palette Makes a scheme palette with the gathered colors, (e.g. sets light background)

Installation

You can see if your distro has wallust in their repos by the following chart. For detail information you can check some distro installation instruction that the maintainers have left.

With cargo

cargo install wallust

This will use the lastest (non pre-release) version.

With git

Simply git clone https://codeberg.org/explosion-mental/wallust.

Recommended way is to use the Makefile, since this will install man pages and completions.

  1. Edit Makefile to meet your local setup (should be fine as is for most linux distros).
  2. Build it with make
  3. Install wallust (if necessary as root): make install

Optionally, installing only the binary can be done with the following, which moves the binary into your $CARGO_HOME/bin:

cargo install --path .

or build it and copy the binary to one folder present in your $PATH like /usr/local/bin

cargo build --release
cp -f ./target/release/wallust /usr/local/bin

Background

I've started this tool mainly for speed reasons given that I use a keybinding that runs pywal with a random wallpaper image, this resulted in a noticeable delay in between, which was really annoying as I changed my wallpaper.

Now I know that pywal uses image magick convert to gather the colors, which caused the slowness in pywal, since convert takes some time by itself to gather the colors.

Wallust can also use convert with the wal backend, but it's even more powerful since it brings up integrated native methods (no need for external commands, like convert, but are nice if you have it), and even much more sofisticated algorithms like kmeans or the SIMD backend fast_resize. This made the need to let the user decide what fit best, and not hardcode one way of reading the image.

While the goal was focused on speed, the use case move on to upgrade functionality that both wallust and the archived python tool shared.

I use rust given the great wide library (crates) that it offered and it's native capabilities. I also tried rewriting pywal in C after watching a tsoding video where he implmements a histogram in C for manipulating an image. That was the push I needed to start this journey on this rusty color theoryish codebase.

Related