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.

These scripts form the core of the wallpaper and color pipeline. wallset opens the picker, wallset-backend runs the full theming sequence, and wallset-backend-startup fires automatically on login to apply a random wallpaper and palette before your desktop appears.
Opens a Rofi image picker showing all wallpapers in ~/.config/wallpapers/. After you select one, it calls wallset-backend with the full path.Trigger: Keybind (Super + W) or run manually in a terminal.
wallset
What it does internally:
wallset
#!/usr/bin/env bash
dir="$HOME/.config/rofi/launchers/type-3"
theme='style-3'
WALL_DIR="$HOME/.config/wallpapers"

IFS=$'\n'
cd "$WALL_DIR" || exit

chosen=$(for a in *.jpg *.png *.; do echo -en "$a\0icon\x1f$a\n" ; done \
  | rofi -dmenu -p "Select Wallpaper" -theme "${dir}/${theme}.rasi")

if [ -n "$chosen" ]; then
    wallset-backend "$WALL_DIR/$chosen"
fi
Place your wallpapers in ~/.config/wallpapers/ — only .jpg and .png files are listed in the picker.
The central theming script. Takes a wallpaper path as its only argument and runs the full pipeline: sets the wallpaper with swww, generates a Material You palette with matugen, generates a terminal palette with wallust, applies pywal colors, reloads SwayNC, and copies the wallpaper to the lock screen background.Called by: wallset (manual) and wallock-set.
wallset-backend /path/to/wallpaper.jpg
Key steps it runs:
wallset-backend (core sequence)
# 1. Set wallpaper with animated transition
swww img "$FILE" \
  --transition-type any \
  --transition-duration 1.4 \
  --transition-fps 60 \
  --transition-step 50

# 2. Generate pywal palette
wal --saturate 0.5 -a 0.8 -i "$FILE"

# 3. Generate wallust terminal palette
wallust run "$FILE"

# 4. Generate Matugen Material You palette
matugen image "$FILE"

# 5. Apply pywal colors to Cava
pywal_cava

# 6. Reload SwayNC notification center
swaync-client -rs &

# 7. Copy wallpaper as lock screen background
cp "$FILE" ~/.config/background
The script also attempts to copy the wallpaper to the SDDM theme directory, which requires sudo. This will prompt for your password at wallpaper change time.
Runs automatically via Hyprland’s exec-once on login. Picks a random wallpaper from ~/.config/wallpapers/, avoids repeating the last wallpaper (tracked in ~/.cache/last_wallpaper), and runs the full theming pipeline.Called by: Hyprland exec-once in hyprland.conf.
wallset-backend-startup
Random selection logic:
# Picks a random wallpaper, never the same as last time
while :; do
  FILE="${FILES[RANDOM % ${#FILES[@]}]}"
  [ "$FILE" != "$LAST" ] && break
done
echo "$FILE" > "$HOME/.cache/last_wallpaper"
The wallpaper list is cached in ~/.cache/wallpapers_list.txt and rebuilt automatically when the count changes.
You can also press Super + Shift + R to manually trigger a random wallpaper change at any time.
Applies the current pywal color palette to Cava (the audio visualizer). Called at the end of both wallset-backend and wallset-backend-startup.Called by: wallset-backend, wallset-backend-startup.
pywal_cava
Sets the wallpaper used by the Hyprland lock screen. Works alongside wallock-set-backend.
wallock-set

Build docs developers (and LLMs) love

Get started for freeTalk to us