Merge remote-tracking branch 'upstream/main'

1 files changed, 31 insertions, 0 deletions

diff --git a/config/hypr/scripts/WallpaperCmd.sh b/config/hypr/scripts/WallpaperCmd.sh
new file mode 100755
index 00000000..0191ee14
--- /dev/null
+++ b/config/hypr/scripts/WallpaperCmd.sh
@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# ==================================================
+#  KoolDots (2026)
+#  Project URL: https://github.com/LinuxBeginnings
+#  License: GNU GPLv3
+#  SPDX-License-Identifier: GPL-3.0-or-later
+# ==================================================
+# Wallpaper command selector (awww preferred, swww fallback)
+
+if command -v awww >/dev/null 2>&1; then
+  WWW_CMD="awww"
+  WWW_DAEMON="awww-daemon"
+  WWW_CACHE_DIR="$HOME/.cache/awww"
+  WWW_DAEMON_ARGS=()
+  WWW_MIGRATION_MARKER="$WWW_CACHE_DIR/.cache_cleared"
+else
+  WWW_CMD="swww"
+  WWW_DAEMON="swww-daemon"
+  WWW_CACHE_DIR="$HOME/.cache/swww"
+  WWW_DAEMON_ARGS=(--format xrgb)
+fi
+# One-time cache clear when migrating from swww to awww
+if [ "$WWW_CMD" = "awww" ]; then
+  mkdir -p "$WWW_CACHE_DIR"
+  if [ ! -f "$WWW_MIGRATION_MARKER" ]; then
+    awww clear-cache >/dev/null 2>&1 || true
+    touch "$WWW_MIGRATION_MARKER"
+  fi
+fi
+
+export WWW_CMD WWW_DAEMON WWW_CACHE_DIR WWW_DAEMON_ARGS WWW_MIGRATION_MARKER