hyprWallpaper -- a GUI for hyprpaper written in C++ and GTK that is directly compatible with immutable setups

NOTE: This project is very similar to WayPaper, but differs in that it is less dependent on external depedencies (pun-intended) as these are difficult to maintain on an immutable distro (which I previously ran). The project also aims to be lighter and more efficient, as it makes use of C++ rather than Python. Thus, once I get the project to a more complete state, I will package it as a flatpak.

Feature Checklist:

• Automatic creation of a wallpaper directory ✅
• List all images in wallpaper directory without manual input ✅
• Connection to hyprpaper to allow wallpaper change ✅
• Multi-monitor support (not yet, currently just changes the wallpaper on all monitors)
• Multi-directory support ✅
• Directory refresh
• Proper settings page (with configs like changing the default wallpaper directory)
• Possibly implement a way to access, browse, and apply wallpapers from online sites.
• drag-drop import

Required Dependencies:

Nothing except hyprpaper, which is usually already bundled with defualt hyprland installs.

Installation:

Will upload a proper way to install, but for right now it can be compiled using CMake and the gtkmm4 development package. There is also a buggy pre-release that I've uploaded to this repository. Flatpak and/or appimage is a definite to-do. To use the pre-release, you must have the gtk4 package installed. Also, make sure the folder ~/Pictures exists, as this is where a subdirectory will get created. It also assumes that the UI and CSS files are present in your home directory...this will be fixed, but is currently how I am testing it.

First launch:

After launching, a directory called "Wallpapers" will be placed within $HOME/Photos (if there isn't already one). Place all wallpapers within this directory. Any sub-directories created within this folder will show up as wallpaper categories within the app (it treats sub-directories as differing wallpaper categories).