hpaper is a wallpaper management daemon for Wayland desktops that combines automatic wallpaper rotation with immediate command-line control. It is designed for users who want backgrounds to change periodically while retaining the ability to switch images manually.
The program works with several wallpaper backends rather than relying on one compositor. It supports swaybg, hyprpaper and KDE Plasma, using the appropriate mechanism to apply backgrounds in each environment.
hpaper operates as a background process that communicates with client commands through a Unix socket. This arrangement allows wallpaper changes and other operations without repeatedly starting a separate wallpaper manager.
Configuration is stored in a text file, with options for image directories, rotation intervals, display selection and backend-specific behaviour. The utility can also work with pywal to generate colour schemes that match the selected wallpaper.
This is free and open source software.
Key Features
- Supports swaybg, hyprpaper and KDE Plasma wallpaper backends.
- Automatically selects the KDE backend when the desktop environment is detected.
- Uses Plasma Shell D-Bus scripting to change KDE Plasma wallpapers.
- Runs a background daemon with Unix socket communication for client commands.
- Supports configurable automatic wallpaper rotation intervals.
- Change to the next or previous wallpaper without stopping the daemon.
- Query the currently selected wallpaper image.
- Reload wallpaper lists during operation.
- Supports randomising wallpaper order when the daemon starts.
- Select individual monitors or apply wallpapers to all outputs.
- Provides fill, fit, stretch, centre and tile image placement options through swaybg.
- Supports cover, contain, tile and fill modes through hyprpaper.
- Integrates with pywal to generate colour schemes from selected wallpapers.
- Allows custom pywal commands and arguments.
- Automatically creates a configuration file with default settings.
- Supports configuration overrides when starting the daemon.
- Can be controlled through desktop keybindings and shell scripts.
Website: github.com/Hcode00/hpaper
Support:
Developer: Hazem Ahmed
License: GNU General Public License v3.0
hpaper is written in Go. Learn Go with our recommended free books and free tutorials.
Related Software
| Wallpaper Setters | |
|---|---|
| Fantascene | Play video wallpapers on your background |
| Variety | Highly configurable utility that offers a great range of features |
| WallpaperDownloader | Download, change, manage wallpapers with this Java tool |
| Superpaper | Advanced multi monitor wallpaper manager |
| wpgtk | Colorscheme, wallpaper and template manager |
| Waywallen | Dynamic wallpaper manager for Wayland desktop environments |
| Picture Of The Day | Grabs a picture of the day from a variety of sources |
| HydraPaper | Gtk utility to set different backgrounds for each monitor on GNOME |
| Waypaper | Lightweight graphical wallpaper manager |
| pacwall | Live wallpaper showing dependency graph and installed packages |
| chwall | Tiny automatic wallpaper changer |
| swaybg | Wallpaper utility for Wayland compositors |
| mpvpaper | Video wallpaper software |
| Komorebi | Fully customisable image, video, and web page wallpapers |
| Azote | GTK+3 based picture browser and background setter |
| WSelector | Wallpaper selector manager |
| Wall Changer | Automatic wallpaper changer |
| Hyprpaper | Wallpaper utility designed for Hyprland |
| Fondo | Quickly find beautiful wallpapers from Unsplash |
| feh | Mode-based image viewer and cataloger aimed at console users |
| xwallpaper | Wallpaper setting utility |
| Damask | Automatically set wallpaper images |
| wpaperd | Lightweight wallpaper daemon with automatic image rotation |
| Walt | Wallpaper manager for Hyprland |
| awww | Wallpaper daemon for Wayland |
| flowy | Lean privacy-preserving dynamic wallpaper changer |
| hpaper | Advanced wallpaper management for Wayland |
| chwp | Changes the wallpaper from the command line |
| Wallrus | Generate colorful abstract wallpapers |
| awtwall | Fast TUI wallpaper picker for Wayland |
| Tinte | Wallpaper utility and theme generator |
| Nitrogen | Background browser and setter |
| gSlapper | Wallpaper utility for Wayland |
| wewa | Renders web content as desktop wallpaper |
| Walldo | Simple graphical wallpaper changer for Linux desktops |
| randwall | Randomly changes the desktop wallpaper |
| Matuwall | Fast graphical wallpaper picker for Wayland desktops |
| Icebg | Lightweight wallpaper setter for Wayland compositors |
| Clockwork Orange | Manage wallpapers and lock screen backgrounds |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.