wallust(5)

🌸 NAME 🌸

wallust — the TOML config file format, bestie. That's it, that's the vibe.

---

✨ GENERAL ✨

Okay so these are the general variables you can set up in your wallust.toml file. And listen — every single one of them is optional 💅 because wallust can absolutely work without a config file and just pick default implementations on its own. Lowkey self-sufficient.

Keep in mind that backend, palette and colorspace share possible values with the CLI, so go peek at wallust(1) for the full lore. iykyk.

• backend — lets you choose which method gets used to parse the image.
  • full — reads and returns the whole image pixels. More precision, slower. It's giving thorough but patient 🐌
  • resized — resizes the image before parsing while maintaining its aspect ratio.
  • wal — uses image magick convert to generate the colors, like pywal.
  • thumb — faster algo, hardcoded to x, no ratio respected.
  • fastresize — a much faster resize algo that uses SIMD. For some reason it fails on some images where resized doesn't, and for this reason it doesn't replace it — it's a whole new option instead.
  • kmeans — Kmeans is an algo that divides and picks pixels all around the image. Requires more tweaking and more in depth testing, but for the most part it just werks. 🔥
• color_space — what colorspace to use to gather the most prominent colors.
  • lab — uses Cie L a b color space. (mixed)
  • lch — CIE Lch. You can understand this color space like LAB but with chrome and hue added, which could help when sorting. (mixed, ansi)

There are two variants:

• mixed, which mixes colors when collecting them into a histogram.
• ansi — tries to get a full color pallete similar to a tty. This works best with ansidark.

• threshold — wallust automatically uses the best threshold (by my testings) if this variable isn't defined. 🙈

If you really want to define this variable, keep in mind the following: threshold is the difference between similar colors, used inside the colorspace. While each colorspace may have different results with different thresholds — meaning you should try which one works for you best — an "overall" and general table looks like this:

• 1 — not perceptible by human eyes.
• 1 - 2 — perceptible through close observation.
• 2 - 10 — perceptible at a glance.
• 11 - 49 — colors are more similar than opposite.
• 100 — colors are exact opposite.

• palette — uses the colors gathered from color_space in a way that makes sense, resulting in a scheme palette. 💖
  • dark — dark colors, dark background and light contrast. (16, comp, comp16)
  • harddark — same as dark with hard hue colors. (16, comp, comp16)
  • light — light bg, dark fg. (16, comp, comp16)
  • softdark — variant of softlight, uses the lightest colors and a dark background; could be interpreted as dark inversed. (16, comp, comp16)
  • softlight — light with soft pastel colors, counterpart of harddark. (16, comp, comp16)

There are some variants to the principal palettes schemes which you can use by appending the variant to the name, e.g. 'dark16', 'lightcomp', 'harddarkcomp16' and so on. Each palette indicates, in parenthesis, which variants are avaliable. A description of the overall variants:

• 16 — makes shades of colors, creating the ilusion of "16 different colors".
• comp — stands for Complementary and completly changes the palette to it's complementary counterpart.
• comp16 — complementary palette with 16 shades.

• check_constrast — ensures a "readable contrast". Should only be enabled when you notice an unreadable contrast frequently happening with your images. The reference color for the contrast is the background color. (default: disabled) ⚠️
• fallback_generator — this field chooses a method to use when the gathered colors aren't enough:
  • interpolation — (default) tries to pick two colors and built gradients over them complementary. Uses the complementary colors of two colors, or more (if needed), colors.
• saturation — color saturation. Usually something higher than 50 increases the saturation and below decreases it (on a scheme with strong and vivid colors). Possible values: 1 - 100 (default: disabled)
• alpha — alpha value for templating (default: 100)

---

🎀 TEMPLATES 🎀

Templates are optional and defined inside the [templates] header. Here it's recommended to use single quotes (') instead of double quotes (") since the first one, by the toml format, ignores backslashes (\) as escape codes — which allows you to define Widows like paths (e.g. 'C:\Users\Desktop\'). Bestie, that's such a slay detail 🦋

To learn more about the syntax, see wallust(1).

• template — a relative path that points to a file where wallust.toml is located, usually at '~/.config/wallust/'. This file can also be a directory, which will be templated recursively.
• target — absolute path in which to place a file with generated templated values. This field CAN expand the ~ as the $HOME enviromental variable. If template is a directory, this must correspond and be one.
• pywal (optional) — indicates to treat template as a pywal template, using {variable} syntax. (default: false)
• max_depth (optional) — this is variable is optional, by default disabled and thus, doesn't limit recursion. When enabled, it accepts a number that indicates the quantity of recursion level to accept, similar to du ... --max-depth 1 (and probably other utils).

---

💜 EXAMPLES 💜

Below is a simple example exahusting all possible cases. All the format is correct:

backend = "full"
color_space = "lab"
threshold = "20"
palette = "softdark"
check_contrast = true

[templates]
# dunst templates
dunst.template = "dunstrc.monitor"
dunst.target = "~/.config/dunst/dunstrc"

# one liner for zathura
zathura = { template = 'zath', target = '~/.config/zathura/zathurarc' }

# even a shorter way
glava = { src = 'glava.glsl', target = '~/.config/glava/rc.glsl' }

# or splited, like dunst
res.src = "xres"
res.dst = "~/.config/Xresources"

# old times, good times (here I put old pywal templates)
# Also, note that the name doesn't matters (as long as it isn't already defined)
# NOTE that both src and dst are directories
pywal = { src = "templates/", dst = '~/.cache/wal/', pywal = true }

---

🌈 SEE ALSO 🌈

wallust(1), wallust-run(1), wallust-cs(1), wallust-theme(1), wallust-themes[1]

---

⭐ NOTES ⭐

1. wallust-themes — suggestions for new colorschemes returned by the themes subcommand should be filled here. 👑 https://codeberg.org/explosion-mental/wallust-themes

---

💀 BUGS 💀

https://codeberg.org/explosion-mental/wallust

---

And that's the whole page, bestie — you just read the wallust(5) manpage from the File Formats Manual, version wallust-2.10. Go forth and make your terminal iconic. 🫶✨