Hyprwal - wallpaper utility for wayland compositors

My personal modified version of hypr-wallpicker refer to Changes for additional details.

Dependencies

• swaybg — wallpaper daemon
• raylib — GUI rendering
• gcc, make

Build & Install

make
sudo make install

Features

• picker - Hexagonal grid GUI with hover animations, scroll, and hex-masked thumbnails
• list - List wallpapers from ~/Pictures/wallpapers/
• set <name|index> - Set wallpaper by filename or 1-based index
• random - Set a random wallpaper
• current - Show the saved wallpaper path
• restore - Restore last wallpaper (for compositor autostart)
• Persistence - Last wallpaper saved to ~/.config/hyprwal/w
• Caching - Thumbnails cached to ~/.cache/wallpicker/ for fast loads

Usage

hyprwal                    # open picker GUI
hyprwal picker             # same as above
hyprwal list               # list wallpapers
hyprwal set 3              # set wallpaper by index
hyprwal set wallpaper.jpg  # set wallpaper by name
hyprwal random             # set random wallpaper
hyprwal current            # show saved wallpaper
hyprwal restore            # restore last wallpaper

Persistence after reboot

Add to your Wayland compositor config startup:

exec-once=hyprwal restore

This kills any existing swaybg and launches it with the last selected wallpaper.

Hyprland fullscreen rule

hl.window_rule({
    name         = "hyprwal",
    match        = { class = "^(hyprwal)$" },
    fullscreen   = true,
    center       = true,
    stay_focused = true,
})