Feature/vegas scroll mode

[ChuckBuilds]

Summary by CodeRabbit

Release Notes

• New Features

  • Introduced Vegas Scroll Mode: enables continuous scrolling display with configurable speed, FPS, and buffer management.
  • Added 14+ new web UI widgets: color picker, date picker, day selector, email/password/text/number/URL inputs, radio group, slider, toggle switch, textarea, schedule picker, and time range controls for improved user interactions.

• Refactor

  • Redesigned schedule and plugin configuration UI to use widget-based rendering for consistency.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

Introduces a comprehensive Vegas mode feature (continuous scrolling display) with new configuration, coordination, content adaptation, and rendering systems. Integrates Vegas mode into the display controller loop, adds plugin hooks for Vegas content, updates the configuration schema, implements web API support for Vegas settings, and introduces a new frontend widget system with 13+ specialized input components and template updates for Vegas UI configuration.

Changes

Cohort / File(s)	Summary
Core Vegas Mode Implementation src/vegas_mode/config.py, src/vegas_mode/coordinator.py, src/vegas_mode/plugin_adapter.py, src/vegas_mode/render_pipeline.py, src/vegas_mode/stream_manager.py, src/vegas_mode/__init__.py	Introduces a complete Vegas scroll mode package with configuration model, coordinator orchestration, plugin content adaptation, high-performance render pipeline with double-buffering and cycle management, dual-buffer stream manager with look-ahead prefetching, and package exports. Dense logic with state management, buffering, error handling, and timing controls (~2K lines).
Display Controller Integration src/display_controller.py	Adds lazy-loading Vegas mode initialization, Vegas mode activation checks, and Vegas iteration branch in the main display loop with fallback to normal rotation on failure. Includes schedule check behavior tweak treating empty schedules as always active.
Plugin System Extensions src/plugin_system/base_plugin.py	Adds two new public methods: get_vegas_content() for plugins to return PIL Images for Vegas mode, and get_vegas_content_type() to indicate content type ('static', 'multi', 'none').
Configuration Schema config/config.template.json	Adds new display.vegas_scroll block with enabled, scroll_speed, separator_width, plugin_order, excluded_plugins, target_fps, and buffer_ahead fields.
Web API Support web_interface/blueprints/api_v3.py	Extends save_main_config() to parse and serialize Vegas scroll settings from request data, including integer conversion for numeric fields and JSON handling for plugin arrays.
Frontend Widget System web_interface/static/v3/js/widgets/color-picker.js, ...date-picker.js, ...day-selector.js, ...email-input.js, ...number-input.js, ...password-input.js, ...radio-group.js, ...select-dropdown.js, ...slider.js, ...text-input.js, ...textarea.js, ...time-range.js, ...toggle-switch.js, ...url-input.js	Introduces 14 new reusable form input widgets for LEDMatrixWidgets framework, each with render, getValue/setValue, validation, and change handlers. Supports various input types (text, number, color, date, time, select, etc.) with optional icons, validation feedback, and UI state management.
Template Updates web_interface/templates/v3/base.html, web_interface/templates/v3/partials/display.html, web_interface/templates/v3/partials/plugin_config.html, web_interface/templates/v3/partials/schedule.html	Adds Vegas Scroll Mode UI section with scrolling speed, separator width, target FPS, buffer controls, and drag-and-drop plugin ordering. Integrates new widget system into plugin config and schedule templates; adds duplicate widget script imports and replaces inline schedule UI with widget-based rendering.

Sequence Diagram(s)

sequenceDiagram
participant DisplayCtrl as Display Controller
participant VegasCoord as Vegas Coordinator
participant StreamMgr as Stream Manager
participant PluginAdpt as Plugin Adapter
participant RenderPipe as Render Pipeline
participant Display as Display Device
DisplayCtrl->>VegasCoord: initialize(config, display_manager, plugin_manager)
VegasCoord->>StreamMgr: __init__(config, plugin_manager, plugin_adapter)
StreamMgr->>PluginAdpt: fetch initial plugin content
PluginAdpt-->>StreamMgr: buffered images
StreamMgr-->>VegasCoord: ready
VegasCoord->>RenderPipe: __init__(config, display_manager, stream_manager)
RenderPipe-->>VegasCoord: ready
loop Vegas Mode Active Loop
DisplayCtrl->>VegasCoord: run_iteration()
VegasCoord->>RenderPipe: should_recompose()
alt Need Content Update
RenderPipe->>StreamMgr: get_all_content_for_composition()
StreamMgr-->>RenderPipe: buffered segments
RenderPipe->>RenderPipe: compose_scroll_content()
end
loop Per-Frame Rendering (target FPS)
RenderPipe->>RenderPipe: render_frame()
RenderPipe->>RenderPipe: update scroll position
RenderPipe->>Display: render visible frame
end
alt Cycle Complete
RenderPipe->>StreamMgr: prefetch next content
PluginAdpt->>PluginAdpt: get_vegas_content() per plugin
StreamMgr-->>RenderPipe: next cycle content ready
RenderPipe->>RenderPipe: start_new_cycle()
end
end

Loading

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~110 minutes

---

Possibly related PRs

• Feature/on demand plugin filtering #166: Modifies src/display_controller.py to add alternative display-mode branches and state management, directly related to Vegas mode integration into the display loop.
• feat(widgets): add modular widget system for schedule and common inputs #213: Adds the same set of frontend widget modules and corresponding template changes (web_interface/static/v3/js/widgets/*, base.html, plugin_config.html), with direct code-level overlap.
• fix(config): Add defaults to schemas and fix config validation issues #153: Refactors and extends save_main_config() form-parsing logic in web_interface/blueprints/api_v3.py, directly related to Vegas settings serialization handling.

Poem

🐰 Hop, scroll, and spin with Vegas flair,
Content streams through buffers with care,
Widgets dance across the web UI bright,
Cycling colors, from morning to night,
A scrolling spectacle, pure delight! ✨

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}