F34.us Content Aggregator Prototype

The Signal Layer Between Music and Light

An overview of MixMan Coordinator's normalized playback state, tailored downstream payloads, and operational visibility.

MixMan Coordinator is a small integration service with an outsized responsibility: it moves the current musical state into the systems that turn it into images and light. Instead of asking every visual engine to understand MixMan directly, the coordinator establishes one place where playback data is received, normalized, observed, and transformed.

Its primary source can be MixMan's public current-playback projection, polled at a configurable interval. It can also accept external now-playing updates through the same normalized pipeline, allowing a side-stream source to keep visual systems active when MixMan is unavailable or intentionally not configured. Both paths produce a consistent internal representation of track identity, playback state, timing, color, intensity, and available metadata.

Each downstream receives a purpose-built payload. Visualizer Stream gets the track and recommendation context it needs to construct a video presentation, while DungeonOPC receives the compact now-playing state used to guide a physical lighting environment. Raw upstream responses are not forwarded wholesale, reducing coupling and preventing one consumer from becoming dependent on unrelated source details.

The coordinator is designed to remain useful during partial outages. Its process health does not fail merely because a dependency is unreachable, and disabled services are represented explicitly. Status, current state, diagnostics, traffic summaries, and delivery counters give an operator enough information to distinguish a healthy coordinator from a healthy source or a successful downstream delivery.

F34.us Background Image