diff --git a/README.md b/README.md index 989113f..cc24022 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Sebin Dynamic Wallpaper -Dynamic wallpaper for the GNOME desktop environment, featuring Sebin working from home by [Tyr](#credits), as installable Arch Linux package. +Dynamic wallpaper for the GNOME and KDE Plasma desktop environment, featuring Sebin working from home by [Tyr](#credits), as installable Arch Linux package. Wallpaper changes at the following times of day: @@ -12,33 +12,80 @@ Wallpaper changes at the following times of day: * 20:00 - 23:00: Sebin talks to friends online * 23:00 - 07:00: Sebin sleeps on the couch +To determine the solar altitude/azimuth values [this Keisan Online Calculator](https://keisan.casio.com/exec/system/1224682277) is a good place to start. + ## Install ### Arch Linux (and derivatives) -To install the dynamic wallpaper simply clone this repository and run: +To build the dynamic wallpaper packages simply clone this repository and run: ~~~bash -makepkg -si +makepkg -s ~~~ -The wallpaper should show up in GNOME settings under "Wallpapers". Select it and enjoy a different wallpaper at different times throughout the day ✨ +Then install the package for your desktop. + +~~~bash +# GNOME +pacman -U sebin-dynamic-wallpaper-1.0.5-1-any.pkg.tar.zst + +# KDE Plasma (⚠️ NOTE: the KDE Plasma version has a dependency to an AUR package, consider using an AUR helper, e.g. yay) +pacman -U sebin-dynamic-wallpaper-kde-1.0.5-1-any.pkg.tar.zst +~~~ + +The wallpaper should show up in your desktop's wallpaper settings. Select it and enjoy a different wallpaper at different times throughout the day ✨ ### Manual (every other distro) -Clone this repository and copy files as follows: +#### GNOME + +Clone this repository and copy the files to either + +* `~/.local/share/backgrounds/` (single user) +* `/usr/share/backgrounds/sebin-dynamic-wallpaper/` (system-wide): ~~~bash +# single user +cp sebin-*.(png|xml) ~/.local/share/backgrounds/sebin-dynamic-wallpaper/ +cp sebin.xml ~/.local/share/gnome-background-properties/ + +# system-wide sudo cp sebin-*.(png|xml) /usr/share/backgrounds/sebin-dynamic-wallpaper/ sudo cp sebin.xml /usr/share/gnome-background-properties/ ~~~ +#### KDE Plasma + +Install the [Plasma Dynamic Wallpaper Engine](https://github.com/zzag/plasma5-wallpapers-dynamic), clone this repository and build the HEIC file + +~~~bash +kdynamicwallpaperbuilder "sebin-kdynamicwallpaperbuilder.json" --output "sebin-dyn_wallpaper.heic" +~~~ + +Then copy it to either + +* `~/.local/share/backgrounds/` (single user) +* `/usr/share/backgrounds/sebin-dynamic-wallpaper-kde/` (system-wide): + +~~~bash +# single user +cp sebin-dyn_wallpaper.heic ~/.local/share/backgrounds/sebin-dynamic-wallpaper-kde/ + +# system-wide +sudo cp sebin-dyn_wallpaper.heic /usr/share/backgrounds/sebin-dynamic-wallpaper-kde/ +~~~ + ### macOS On macOS use [wallpapper](https://github.com/mczachurski/wallpapper) to create an HEIC image that you can set as dynamic wallpaper in preferences: ~~~bash -wallpapper -i sebin-timed.json -o sebin-dyn_wallpaper.heic +# based on time of day +wallpapper -i sebin-timed.json -o sebin-dyn_wallpaper.heic + +# based on solar altitude/azimuth +wallpapper -i sebin-sun.json -o sebin-dyn_wallpaper.heic ~~~ ### Windows