How nrodd/rgboo works
RGBoo is a community-controlled lighting system. The primary workflow is color submission through the web UI or stream chat, cloud validation and paced queueing, bridge processing over USB serial, and firmware-driven LED updates. The repository also includes administrative and statistics views, an OBS overlay, live now-playing updates, and a Go terminal player. Several subsystem links are supported by README descriptions rather than sampled implementation; those documented links cite the README.
Main entry points: processor.py Request processor · ColorForm.tsx Color web UI · routes.py HTTP API · index.js Cloudflare gateway
Components 22
Web experience
- Color web UI
web/src/components/ColorForm/ColorForm.tsx - Web app routes
web/src/App.tsx - Animated scene
web/src/scene/createScene.ts - Admin console
web/src/Admin/Admin.tsx - Stats views
web/src/Stats/Stats.tsx
Cloud services
- Cloudflare gateway
web/worker/index.js - HTTP API
cloud_api/routes.py - Request queue
cloud_api/store.py - Stats aggregation
cloud_api/stats.py - Firestore
- Live updates
web/worker/now-playing.js
Home bridge
- Request processor
bridge/processor.py - Queue watcher
bridge/listener.py - Serial controller
bridge/serial_controller.py - OBS overlay
bridge/obs_server.py - Now-playing publisher
bridge/now_playing.py
LED hardware
- Serial handler and LED control
firmware/src/SerialHandler.cpp - RGB LED strips
Stream and player
- Stream chat sources
- Chat command worker
stream_aggregator/forwarder.py - Go terminal player
cmd/rgboo/main.go
Other components
- Community user
Connections 24
- Community user → Color web UI: submits color
README.md - Color web UI → Cloudflare gateway: sends request
README.md - Cloudflare gateway → HTTP API: proxies API
web/worker/index.js - HTTP API → Request queue: queues request
cloud_api/routes.py - Request queue → Firestore: persists queue
README.md - Queue watcher → Firestore: watches requests
README.md - Queue watcher → Request processor: dispatches requests
- Request processor → Serial controller: sends color
README.md - Serial controller → Serial handler and LED control: writes serial
README.md - Serial handler and LED control → RGB LED strips: drives strips
- Stream chat sources → Chat command worker: provides chat
README.md - Chat command worker → HTTP API: forwards commands
README.md - Web app routes → Color web UI: routes to
web/src/App.tsx - Web app routes → Admin console: routes to
web/src/App.tsx - Web app routes → Stats views: routes to
web/src/App.tsx - Color web UI → Animated scene: previews color
- Admin console → Cloudflare gateway: requests admin data
web/worker/index.js - Stats views → Cloudflare gateway: requests statistics
- HTTP API → Stats aggregation: reads statistics
cloud_api/app.py - Stats aggregation → Firestore: reads aggregates
- Request processor → OBS overlay: updates overlay
- Request processor → Now-playing publisher: publishes track
- Now-playing publisher → Live updates: pushes updates
- Live updates → Go terminal player: streams updates