WallpyGUI

Modern GTK4 wallpaper manager for Wayland desktops, built for fast browsing, search, image wallpapers, and video wallpapers on Niri and Hyprland.

Features

• Gallery view with async thumbnail loading
• Search wallpapers by filename
• Set image wallpapers via awww
• Set video wallpapers via mpvpaper
• Works well on Niri and Hyprland
• Themeable UI (Catppuccin and others)

Dependencies

Required: gtk4, python, python-gobject, awww, mpvpaper, ffmpeg

Optional: hyprland or niri for monitor detection.

Run from source

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

AUR

The package name is wallpygui. It installs the launcher as:

wallpygui

Config

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

• config.json

Packaging

See PKGBUILD for Arch packaging.

License

MIT - see LICENSE.