Hyprpaper

Resources

Home

GitHub

Official documentation

hyprpaper is a blazing fast Wayland wallpaper utility with IPC controls.

Installation

USE flags

Currently this package has no use flags.

Emerge

It is available in the GURU repository. After enabling that repo, run

root #emerge --ask gui-apps/hyprpaper

Configuration

For a simple wallpaper that loads when Hyprland starts, place exec-once=hyprpaper into the Hyprland config file. Then create ~/.config/hypr/hyprpaper.conf with the following lines:

FILE ~/.config/hypr/hyprpaper.conf

wallpaper {
    monitor = eDP-1
    path = /home/username/Pictures/wallpaper.jpg
    fit_mode = cover
}

Replace eDP-1 to denote the monitor being used. This preloads wallpaper.jpg and sets it as the default wallpaper. Refer to the official documentation link above for more advanced configuration options. Use of ~ in the wallpaper file paths may cause issues, so it is safer to default to spelling out the full path.

Note
For paths that contain spaces, no quotes " or escaping \ needed, for example: preload = /path/to/my bg.jpg

Alternatives

See https://wiki.hypr.land/Useful-Utilities/Wallpapers/ for other Hyprland wallpaper utility options.

See also

• Hyprland — an open-source Wayland compositor written in C++.
• List of software for Wayland — various desktop related packages for Wayland