Waypaper-Engine
Waypaper-Engine copied to clipboard
0bCdian
A wallpaper setter with playlist functionality!
A wallpaper setter gui, developed with ricing in mind! 🍚
Why
How to install
Usage
TODO
Gallery
Special Thanks
Features
- Multi monitor support.
- Four different types of playlists (Time of day, daily,interval based or static).
- Easy configuration of all swww options.
- Tray controls.
- CLI Support.
- All of swww features such as wallpaper change animations and wallpaper persistance through reboots.
- Filter images by format, resolution,name,etc.
- Run scripts on image set.
Why
I started this project for two main reasons, one as a learning oportunity, and two because the available options for a tool like this didn't suit my needs fully. I really like swww but it lacks a lot of the features that I missed from wallpaper engine in windows, so this is my attempt to bridge that gap a little.
Install
Simply install from the aur like so:
yay -S waypaper-engine
Usage
Simply start the app and add wallpapers to the gallery, from there you can double click to set the wallpapers or right click for more options, to create playlists simply click on the checkboxes that appear when hover over the images, and configure it, and then save it to auto start it.
Examples
Autostart on hyprland just the daemon
Add to your hyprland.conf the following lines:
exec-once=waypaper-engine daemon
Add scripts to run on each image set
[!WARNING] Make sure the script in question has execution permissions
waypaper-engine r --script=/absolute/path/to/script
The scripts are always passsed as an argument the path of the image being set, so you can do stuff like this:
https://github.com/0bCdian/Waypaper-Engine/assets/101421807/4117b3b8-9a32-45bc-bba4-0c8baa30fe4d
TODO
- [ ] Add testing.
- [ ] Have a ci/cd pipeline.
- [ ] Implement a logger for errors.
- [x] Publish in the aur.
- [x] Find a good icon/logo for the app (Thank you Cristian Avendaño!).
- [ ] Add flatpak support.
- [x] Add --script flag.
If you encounter any problems or would like to make a suggestion, please feel free to open an issue.
Gallery
Special Thanks
LGFae - for the amazing little tool that swww is ! ❤️
Simon Ser - for wlr-randr, without it making this work across different wayland wm's would've been a nightmare 🥲
Cristian Avendaño - for creating the amazing logo! 💪
0bCdian