Animate GIF wallpapers in the shell

docs/packages.md

@@ -133,7 +133,6 @@ Omarchy's own package list, because they were installed by hand on this machine:
 | --- | --- |
 | `python-pywal16` | `blob-wallpaper-set`, palette extraction |
 | `python-terminaltexteffects` | `blob-screensaver`, the effects it draws |
-| `awww` | the wallpaper daemon `blob-wallpaper-set` and `blob-theme-menu` drive |
 | `playerctl` | the quick settings media row |
 
 `playerctl` is in official `extra`, so it sits in the repo list.

docs/shell.md

@@ -88,6 +88,16 @@ Keys in the clock popup:
 | Enter | back to today, or pick the highlighted month |
 | Esc | close the month picker, then the popup |
 
+## Animated wallpapers
+
+The background plugin draws a GIF wallpaper with `AnimatedImage`, so it moves
+however it was set: the wallpaper picker, `blob wallpaper set`, `blob bg set`,
+or a theme's own background. The transition into it shows the first frame, and
+the animation starts once the transition finishes. Per-monitor wallpapers from
+`blob bg monitor` animate the same way. `awww` is no longer needed;
+`blob-wallpaper-set` and `blob-theme-menu` still stop a leftover `awww-daemon`
+so it cannot paint over the shell.
+
 ## Differences from upstream
 
 This shell was forked from Omarchy 4.0.4 and is not tracked against it. The