Implement BenthicBloom GNOME 50 wallpaper extension

Adds a complete GNOME Shell 50 extension with folder-based wallpaper auto-rotation (shuffle/sequential, crossfade transitions, lock screen sync), GStreamer-backed live/video wallpapers rendered onto the shell's own Clutter stage, and OLED burn-in protection (pixel shifting, idle dimming, forced periodic rotation). Includes a top-bar quick-access indicator, a libadwaita preferences window, GSettings schema, and a Makefile for install/packaging. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RDqbdjsiisSU7CbQke4g8
2026-08-04 00:05:58 +00:00
parent 068c00c0ac
commit c0ec4a59d5
16 changed files with 1834 additions and 1 deletions
@@ -0,0 +1,49 @@
+/**
+ * Random-order iterator that guarantees every item is seen once before any
+ * item repeats, and never immediately repeats the previous pick across bag
+ * refills. Used for "shuffle" rotation mode instead of naive Math.random()
+ * indexing, which tends to repeat images and skip others over time.
+ */
+export class ShuffleBag {
+    constructor(items = []) {
+        this.setItems(items);
+    }
+
+    setItems(items) {
+        this._items = [...items];
+        this._bag = [];
+        this._lastItem = null;
+    }
+
+    get size() {
+        return this._items.length;
+    }
+
+    next() {
+        if (this._items.length === 0)
+            return null;
+        if (this._items.length === 1)
+            return this._items[0];
+
+        if (this._bag.length === 0)
+            this._refill();
+
+        const item = this._bag.pop();
+        this._lastItem = item;
+        return item;
+    }
+
+    _refill() {
+        this._bag = [...this._items];
+        for (let i = this._bag.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [this._bag[i], this._bag[j]] = [this._bag[j], this._bag[i]];
+        }
+
+        if (this._bag[this._bag.length - 1] === this._lastItem && this._bag.length > 1) {
+            const swapIndex = Math.floor(Math.random() * (this._bag.length - 1));
+            const lastIndex = this._bag.length - 1;
+            [this._bag[lastIndex], this._bag[swapIndex]] = [this._bag[swapIndex], this._bag[lastIndex]];
+        }
+    }
+}