[Documentation update]: Wallpaper setter doesn't work in Endevour OS
documentation_update
### Description
Problem Diagnosis
Root Cause
JaKooLit's dotfiles are designed to use swww as the wallpaper backend. However, on your EndeavourOS installation, awww was installed instead (the fork/successor of swww, version 0.12.0), which although functionally compatible, has a different binary name.
Failure Chain
swww was not installed → the daemon never started when Hyprland launched, leaving the desktop with no wallpaper.
awww-daemon didn't start on boot → even though awww was installed, JaKooLit's scripts kept calling the swww-daemon binary which didn't exist, so the wallpaper disappeared on every reboot.
Super + W didn't work → the wallpaper selector (WallpaperSelect.sh) and all auxiliary scripts had swww hardcoded, so they failed silently when trying to call a non-existent binary.
Why It Happened
EndeavourOS ships awww in its repositories instead of the original swww, likely because swww is no longer actively maintained and was superseded by awww. JaKooLit's dotfiles haven't yet updated their scripts to account for this name change.
### Proposed Solution
Fix Applied
Replaced all references to swww with awww across the 10 affected scripts and config files, and added awww-daemon to Hyprland's autostart.
`sudo pacman -S awww waypaper 2>/dev/null; mkdir -p ~/Pictures/wallpapers && awww-daemon & sleep 1 && sed -i 's/swww-daemon/awww-daemon/g; s/swww img/awww img/g; s/swww kill/awww kill/g; s/swww query/awww query/g' ~/.config/hypr/UserScripts/WallpaperRandom.sh ~/.config/hypr/UserScripts/WallpaperEffects.sh ~/.config/hypr/UserScripts/WallpaperAutoChange.sh ~/.config/hypr/UserScripts/WallpaperSelect.sh ~/.config/hypr/initial-boot.sh ~/.config/hypr/scripts/GameMode.sh ~/.config/hypr/scripts/WallustSwww.sh ~/.config/hypr/scripts/KeyHints.sh ~/.config/hypr/scripts/DarkLight.sh ~/.config/hypr/configs/Startup_Apps.conf && chmod +x ~/.config/hypr/UserScripts/Wallpaper*.sh`
### install links, images or videos
Full code line with explanations
# 1. Install awww and waypaper
sudo pacman -S awww waypaper 2>/dev/null && \
# 2. Create wallpapers directory if it doesn't exist
mkdir -p ~/Pictures/wallpapers && \
# 3. Start awww-daemon in the background
awww-daemon & sleep 1 && \
# 4. Replace all swww references with awww in JaKooLit's scripts and configs
sed -i 's/swww-daemon/awww-daemon/g; s/swww img/awww img/g; s/swww kill/awww kill/g; s/swww query/awww query/g' \
~/.config/hypr/UserScripts/WallpaperRandom.sh \
~/.config/hypr/UserScripts/WallpaperEffects.sh \
~/.config/hypr/UserScripts/WallpaperAutoChange.sh \
~/.config/hypr/UserScripts/WallpaperSelect.sh \
~/.config/hypr/initial-boot.sh \
~/.config/hypr/scripts/GameMode.sh \
~/.config/hypr/scripts/WallustSwww.sh \
~/.config/hypr/scripts/KeyHints.sh \
~/.config/hypr/scripts/DarkLight.sh \
~/.config/hypr/configs/Startup_Apps.conf && \
# 5. Make all wallpaper scripts executable
chmod +x ~/.config/hypr/UserScripts/Wallpaper*.sh
关闭于 2026-04-07 1 条评论