feat: Enable and configure figment mode via new CLI flags, update documentation, and improve Cairo library detection on macOS.

engine/scroll.py

@@ -55,14 +55,16 @@ def stream(items, ntfy_poller, mic_monitor, display: Display | None = None):
     frame_number = 0
 
     # Figment overlay (optional — requires cairosvg)
-    try:
-        from effects_plugins.figment import FigmentEffect
-        from engine.effects.registry import get_registry
+    figment = None
+    if config.FIGMENT:
+        try:
+            from effects_plugins.figment import FigmentEffect
 
-        _fg_plugin = get_registry().get("figment")
-        figment = _fg_plugin if isinstance(_fg_plugin, FigmentEffect) else None
-    except ImportError:
-        figment = None
+            figment = FigmentEffect()
+            figment.config.enabled = True
+            figment.config.params["interval_secs"] = config.FIGMENT_INTERVAL
+        except (ImportError, OSError):
+            pass
 
     while True:
         if queued >= config.HEADLINE_LIMIT and not active: