rndrsbc 0.1.0__tar.gz

rndrsbc-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+# Runtime state (self-contained mode) — gitignored, survives only locally
+/data/
+/config.json
+/.claim_token
+/live_*.png
+/test_*.png
+/build/
+/*.egg-info/
+/dist/
+__pycache__/
+*.pyc
+
+# Secrets — must NEVER be committed (OAuth token store, mode 600)
+/secrets/
+
+# Python test runner cache
+/.pytest_cache/
+
+# Benchmark output artifacts (CI perf reports)
+/bench/reports/
+
+# Vendored wheels are reproducible outputs of build_vendor_deps.py from the
+# pinned requirements.txt — keep the manifest, not the 32MB binaries.
+/vendor/deps/_extracted/
+/vendor/deps/*.whl
+/vendor/deps/*.tar.gz
+/vendor/deps/*.zip

rndrsbc-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: rndrsbc
+Version: 0.1.0
+Summary: Native E-Paper Operating Platform for Raspberry Pi color e-paper panels.
+Project-URL: Homepage, https://github.com/rndrsbc/rndrsbc
+Author: rndrSBC
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: qrcode[pil]>=7.4.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: werkzeug>=3.0.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: pi
+Requires-Dist: rpi-gpio; extra == 'pi'
+Requires-Dist: spidev; extra == 'pi'
+Description-Content-Type: text/markdown
+
+# rndrSBC
+
+> **Ultra-lightweight, high-performance native E-Paper operating platform designed for Single-Board Computers.**
+
+---
+
+### Why rndrSBC?
+
+* **Chromium-Free**: 0MB browser bloat. No headless Chrome, no WebKit, no X11.
+* **Insanely Fast**: Renders vector dashboards in **35ms–60ms** (vs. 10–15 seconds on Chrome).
+* **Zero Swap & Memory Thrashing**: Runs in **< 15MB RAM** (ideal for Pi Zero W / Pi Zero 2W / Pi 3).
+* **Responsive Canvas Engine**: Resolution-independent vector layout with fractional split boxes and auto-scaling typography.
+* **100% Clean-Room Architecture**: Fully standalone with modular display drivers and widget system.
+
+---
+
+### Quick Start (Development / PC / Mac)
+
+```bash
+# 1. (Optional) Vendor the runtime deps for a fully-offline copy
+python3 build_vendor_deps.py
+
+# 2. Run single-pass render test
+python3 main.py --once
+```
+
+Output is rendered directly to `live_screen.png`.
+
+### Run the web dashboard (any platform)
+
+```bash
+python3 main.py 8080          # foreground
+python3 main.py --daemon 8080 # background, self-detaches (no sudo)
+```
+
+---
+
+### Raspberry Pi — no `install.sh` required
+
+rndrSBC is **relocatable**: it anchors every path (config, previews, photo
+library) to its own folder, and it can load its Python deps straight from a
+vendored wheel bundle. So deployment is simply:
+
+```bash
+# Copy the project folder onto the Pi, then:
+python3 main.py 8080
+```
+
+Optional, per-target dependency bundle (needs internet once, on the Pi):
+
+```bash
+python3 build_vendor_deps.py            # detects this machine's arch
+# or for a Raspberry Pi explicitly:
+python3 build_vendor_deps.py --platform aarch64   # 64-bit OS / Pi 4+ / Pi 5
+python3 build_vendor_deps.py --platform armv7l    # 32-bit OS
+```
+
+The resulting `vendor/deps/*.whl` files let the platform run **fully offline
+with zero pip installs**. Skip this and rndrSBC will fall back to your
+system's packages (or create a private `.venv` on first run).
+
+If you want rndrSBC to start at boot (optional), use the relocatable unit:
+
+```bash
+# edit the two placeholders in rndrSBC.service, then:
+sudo cp rndrSBC.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now rndrSBC
+```
+
+> A legacy `install.sh` is still included for compatibility, but it is no
+> longer required.
+
+### Recent Additions (this build)
+
+**Physical Buttons (GPIO)** — `core/buttons.py`
+- Wire three buttons to GPIO 17 / 27 / 22 (to GND), enabled in the dashboard.
+- NEXT cycles widgets, PREV goes back, TOGGLE-QUIET pauses/restarts refreshes.
+- Falls back gracefully when RPi.GPIO is absent (simulator / laptop / CI) — buttons are auto-disabled.
+
+**CalDAV + iCal Calendar** — `widgets/calendar/widget.py`
+- Calendar widget now accepts a `caldav` config (URL + basic-auth user/password) in addition to public `iCal` feed URLs.
+- Fetches via HTTPS `REPORT` query, parses with the native ICS parser (no extra deps); per-date event-dot markers on the month grid.
+
+**Localization (i18n)** — `core/i18n.py`
+- New `language` global setting (English, Español, Français, Deutsch, Italiano, Português, Nederlands, Türkçe).
+- Localizes the calendar weekday headers + agenda labels and the weather "Updated / Feels Like / Wind / Humidity" labels.
+- Add languages in `core/i18n.py` with three dicts (`MONTHS`, `WEEKDAYS`, `LABELS`).
+
+**Reflect-mode refresh** — `core/transitions.py` + scheduler
+- `refresh_mode: "auto"` (default) uses dirty-rect partial refresh when the panel supports it, with a full-refresh recharge every 20 partials.
+- `refresh_mode: "full"` opt-out forces full-frame always (dashboard Display Transitions card).
+

rndrsbc-0.1.0/README.md

@@ -0,0 +1,93 @@
+# rndrSBC
+
+> **Ultra-lightweight, high-performance native E-Paper operating platform designed for Single-Board Computers.**
+
+---
+
+### Why rndrSBC?
+
+* **Chromium-Free**: 0MB browser bloat. No headless Chrome, no WebKit, no X11.
+* **Insanely Fast**: Renders vector dashboards in **35ms–60ms** (vs. 10–15 seconds on Chrome).
+* **Zero Swap & Memory Thrashing**: Runs in **< 15MB RAM** (ideal for Pi Zero W / Pi Zero 2W / Pi 3).
+* **Responsive Canvas Engine**: Resolution-independent vector layout with fractional split boxes and auto-scaling typography.
+* **100% Clean-Room Architecture**: Fully standalone with modular display drivers and widget system.
+
+---
+
+### Quick Start (Development / PC / Mac)
+
+```bash
+# 1. (Optional) Vendor the runtime deps for a fully-offline copy
+python3 build_vendor_deps.py
+
+# 2. Run single-pass render test
+python3 main.py --once
+```
+
+Output is rendered directly to `live_screen.png`.
+
+### Run the web dashboard (any platform)
+
+```bash
+python3 main.py 8080          # foreground
+python3 main.py --daemon 8080 # background, self-detaches (no sudo)
+```
+
+---
+
+### Raspberry Pi — no `install.sh` required
+
+rndrSBC is **relocatable**: it anchors every path (config, previews, photo
+library) to its own folder, and it can load its Python deps straight from a
+vendored wheel bundle. So deployment is simply:
+
+```bash
+# Copy the project folder onto the Pi, then:
+python3 main.py 8080
+```
+
+Optional, per-target dependency bundle (needs internet once, on the Pi):
+
+```bash
+python3 build_vendor_deps.py            # detects this machine's arch
+# or for a Raspberry Pi explicitly:
+python3 build_vendor_deps.py --platform aarch64   # 64-bit OS / Pi 4+ / Pi 5
+python3 build_vendor_deps.py --platform armv7l    # 32-bit OS
+```
+
+The resulting `vendor/deps/*.whl` files let the platform run **fully offline
+with zero pip installs**. Skip this and rndrSBC will fall back to your
+system's packages (or create a private `.venv` on first run).
+
+If you want rndrSBC to start at boot (optional), use the relocatable unit:
+
+```bash
+# edit the two placeholders in rndrSBC.service, then:
+sudo cp rndrSBC.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now rndrSBC
+```
+
+> A legacy `install.sh` is still included for compatibility, but it is no
+> longer required.
+
+### Recent Additions (this build)
+
+**Physical Buttons (GPIO)** — `core/buttons.py`
+- Wire three buttons to GPIO 17 / 27 / 22 (to GND), enabled in the dashboard.
+- NEXT cycles widgets, PREV goes back, TOGGLE-QUIET pauses/restarts refreshes.
+- Falls back gracefully when RPi.GPIO is absent (simulator / laptop / CI) — buttons are auto-disabled.
+
+**CalDAV + iCal Calendar** — `widgets/calendar/widget.py`
+- Calendar widget now accepts a `caldav` config (URL + basic-auth user/password) in addition to public `iCal` feed URLs.
+- Fetches via HTTPS `REPORT` query, parses with the native ICS parser (no extra deps); per-date event-dot markers on the month grid.
+
+**Localization (i18n)** — `core/i18n.py`
+- New `language` global setting (English, Español, Français, Deutsch, Italiano, Português, Nederlands, Türkçe).
+- Localizes the calendar weekday headers + agenda labels and the weather "Updated / Feels Like / Wind / Humidity" labels.
+- Add languages in `core/i18n.py` with three dicts (`MONTHS`, `WEEKDAYS`, `LABELS`).
+
+**Reflect-mode refresh** — `core/transitions.py` + scheduler
+- `refresh_mode: "auto"` (default) uses dirty-rect partial refresh when the panel supports it, with a full-refresh recharge every 20 partials.
+- `refresh_mode: "full"` opt-out forces full-frame always (dashboard Display Transitions card).
+

rndrsbc-0.1.0/config.template.json

@@ -0,0 +1,17 @@
+{
+  "_comment": "rndrSBC default configuration. Copy to config.json (or let the deployment scaffold create it) then adjust.",
+  "display": {
+    "driver": "virtual",
+    "model": "epd7in3f",
+    "orientation": 0
+  },
+  "device": {
+    "name": "rndrSBC Frame",
+    "language": "en",
+    "timezone": "UTC"
+  },
+  "active_playlist": "default",
+  "playlists": {
+    "default": ["weather", "network", "calendar", "photo_frame", "system_stats"]
+  }
+}

rndrsbc-0.1.0/core/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

rndrsbc-0.1.0/core/buttons.py

@@ -0,0 +1,126 @@
+"""
+rndrSBC - Physical Button Controller
+Wires up to 3 GPIO push-buttons to cycles through playlist actions.
+
+Buttons (BCM pin numbering by default, configurable in config):
+  BUTTON_NEXT  -> advance to next widget in active playlist
+  BUTTON_PREV  -> go back to previous widget
+  BUTTON_TOGGLE-> toggle between quiet-hours suspend and active refresh
+
+The controller degrades gracefully: on platforms without RPi.GPIO
+(a laptop, CI, the VirtualDisplay), it logs and no-ops so the rest
+of the system runs normally.
+"""
+
+import logging
+import threading
+import time
+
+logger = logging.getLogger("rndrSBC.buttons")
+
+try:
+    import RPi.GPIO as GPIO
+    _HAS_GPIO = True
+except Exception:
+    GPIO = None
+    _HAS_GPIO = False
+
+
+class ButtonController:
+    """Debounced physical button listener mapped to scheduler actions."""
+
+    DEFAULT_PINS = {
+        "next": 17,
+        "prev": 27,
+        "toggle": 22,
+    }
+
+    def __init__(self, scheduler, config: dict, pins: dict = None):
+        self.scheduler = scheduler
+        self.config = config
+        self.pins = dict(self.DEFAULT_PINS)
+        if pins:
+            self.pins.update({k: v for k, v in pins.items() if v is not None})
+        self._thread = None
+        self._running = False
+        self._last_state = {}
+        self._last_trigger = {}
+        self._debounce_ms = int(config.get("buttons", {}).get("debounce_ms", 200))
+        self._enabled = bool(config.get("buttons", {}).get("enabled", True))
+
+    def _on_next(self):
+        items = self.scheduler.active_playlist_items
+        if items:
+            nxt = (self.scheduler.current_index + 1) % len(items)
+            self.scheduler.trigger_render_now(nxt, force_hardware=True)
+            logger.info("[BUTTON] Next widget -> index %d", nxt)
+
+    def _on_prev(self):
+        items = self.scheduler.active_playlist_items
+        if items:
+            prv = (self.scheduler.current_index - 1) % len(items)
+            self.scheduler.trigger_render_now(prv, force_hardware=True)
+            logger.info("[BUTTON] Previous widget -> index %d", prv)
+
+    def _on_toggle(self):
+        current = bool(self.config.get("quiet_hours", {}).get("enabled", False))
+        self.config.setdefault("quiet_hours", {})["enabled"] = not current
+        state = "enabled" if not current else "disabled"
+        logger.info("[BUTTON] Quiet-hours %s", state)
+        if not current:
+            self.scheduler.trigger_render_now(self.scheduler.current_index, force_hardware=True)
+
+    def _dispatch(self, action):
+        try:
+            getattr(self, f"_on_{action}")()
+        except Exception as e:
+            logger.error(f"Button action '{action}' failed: {e}")
+
+    def _poll(self):
+        """Non-blocking polling loop with software debounce (works on any GPIO lib)."""
+        while self._running:
+            for action, pin in self.pins.items():
+                try:
+                    state = GPIO.input(pin)
+                except Exception:
+                    continue
+                now = time.time()
+                prev = self._last_state.get(action)
+                if prev == 1 and state == 0:  # falling edge (pressed to GND)
+                    if now - self._last_trigger.get(action, 0) >= self._debounce_ms / 1000.0:
+                        self._last_trigger[action] = now
+                        self._dispatch(action)
+                self._last_state[action] = state
+            time.sleep(0.02)
+
+    def start(self):
+        if not self._enabled:
+            logger.info("Buttons disabled in config.")
+            return
+        if not _HAS_GPIO:
+            logger.info("RPi.GPIO not available - physical buttons skipped (virtual/simulator mode).")
+            return
+        try:
+            GPIO.setmode(GPIO.BCM)
+            for action, pin in self.pins.items():
+                logger.info("Configuring %s button on GPIO %d", action, pin)
+                GPIO.setup(pin, GPIO.IN, pull_up_down=GPIO.PUD_UP)
+                self._last_state[action] = GPIO.input(pin)
+        except Exception as e:
+            logger.error(f"Failed to configure GPIO buttons: {e}")
+            return
+        self._running = True
+        self._thread = threading.Thread(target=self._poll, daemon=True, name="rndrSBC-Buttons")
+        self._thread.start()
+        logger.info("Physical button controller started.")
+
+    def stop(self):
+        self._running = False
+        if self._thread:
+            self._thread.join(timeout=3)
+        if _HAS_GPIO and self._enabled:
+            try:
+                GPIO.cleanup()
+            except Exception:
+                pass
+        logger.info("Button controller stopped.")