Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Noro18/linux-ricing-dotfiles/llms.txt

Use this file to discover all available pages before exploring further.

Waybar is the status bar that sits at the top of the desktop, showing workspaces, a clock, system stats, and custom modules. In this setup, its visual style is fully driven by the wallpaper theming pipeline — you never edit style.css directly. Module layout and behavior, however, are always yours to edit freely in config.jsonc.

​
File structure

~/.config/waybar/
├── config.jsonc            # Module layout and config — the only file you edit for modules
├── style.css               # ⚠ Generated by waybar-set — do not edit manually
├── colors.css              # ⚠ Generated by matugen on wallpaper change — do not edit
├── colors-waybar.css       # ⚠ Generated by wallust on wallpaper change — do not edit
├── custom styles/          # Style presets — one is active at a time via waybar-set
├── scripts/                # Scripts used by Waybar modules
└── generated/              # Other generated output files

​
How the files relate

config.jsonc defines what modules appear and how they behave. style.css defines how everything looks. The two are independent: waybar-set rewrites style.css when you switch styles, but never touches config.jsonc. style.css is a thin file whose only job is to import three sources: 
config.jsonc          ← edit this for module changes (single layout, never swapped)
style.css             ← generated by waybar-set, do not edit
  ├── @import colors.css           ← matugen colors (wallpaper-driven)
  ├── @import colors-waybar.css    ← wallust colors (wallpaper-driven)
  └── @import custom styles/X.css  ← whichever style is currently active
When you run waybar-set and pick a new preset, it rewrites style.css so the third import points at the chosen preset, then reloads Waybar.

​
Changing the active style

Run waybar-set (via a keybind or waybar-menu) to open a selector listing every .css file in custom styles/. Choosing one rewrites style.css to import that preset and reloads Waybar immediately. The custom styles/ directory currently contains 19 presets including capsule.css, island.css, glass-modern.css, zen.css, neon-glow-islands.css, and others. To add your own style, drop a .css file into custom styles/ — it will appear in the waybar-set selector the next time you open it.

​
Changing modules / layout

Edit config.jsonc directly. This file is never touched by waybar-set or the theming pipeline, so your changes persist across wallpaper changes and style switches.

​
How colors work

Two separate color files are generated every time the wallpaper changes:
FileGenerated byWhen
colors.cssmatugenOn every wallpaper change
colors-waybar.csswallustOn every wallpaper change
colors.css provides Material You tokens (from Matugen), while colors-waybar.css provides the 16-color terminal palette (from Wallust). Style presets in custom styles/ can reference variables from either file. To change how colors map to Waybar elements, edit the generator templates — not the output files:
  • ~/.config/matugen/templates/ for Material You colors
  • ~/.config/wallust/templates/ for terminal palette colors
Never edit style.css, colors.css, or colors-waybar.css by hand. All three are automatically overwritten — style.css by waybar-set on every style switch, and the two color files by Matugen/Wallust on every wallpaper change.

Build docs developers (and LLMs) love

Get started for freeTalk to us