Modern GTK4 wallpaper manager with fast directory browsing, search, and support for image and video wallpapers.

• Gallery view with async thumbnail loading
• Set image wallpapers via swww (Wayland)
• Set video wallpapers via mpvpaper (Hyprland/Niri)
• Themeable UI (Catppuccin and others)

Required: gtk4, python, python-gobject, swww, mpvpaper, ffmpeg Optional: hyprland or niri (for monitor detection), wallust (for colorscheme, not invoked by default)

git clone https://github.com/jR4dh3y/wallpygui.git
cd wallpygui
python3 wallgui.py

Files are stored in ~/.cache/wallgui/:

• config.json

See PKGBUILD for Arch packaging. A prebuilt spec is available via wallgui.spec.

MIT – see LICENSE.