StarPilot/roadscore/MAC_SHOWCASE.md

From the Mac, start the saved showcase on the comma and in a native Mac onroad window:

./onroad --roadscore route1 --demo

Add --fullscreen to fill the Mac display while preserving the native layout:

./onroad --roadscore route1 --demo --fullscreen

Press F or F11 to toggle fullscreen. Escape returns to the window without stopping playback. The native aspect ratio is preserved with letterboxing; this does not select a different driving UI.

The command prepares both local native replay engines, then releases their start barriers together. The Mac decodes its own cached video and follows the comma’s route playhead. Audio plays from the comma only, through its selected output. No ACE generation or model warm-up occurs. The previous single-device saved-replay setup took 17.13 seconds for loading, replay parameters and UI startup; measure the paired path separately.

Use Galaxy for engagement and turn-signal controls. The Mac follows the same applied presentation selections. No browser control page opens and no video is streamed from the comma. Small Galaxy status updates keep the local playheads approximately aligned; this is independent playback, not frame-exact mirroring. The buttons affect replay appearance and musical presentation only, never vehicle control. Ctrl+C stops both owned demo sessions and leaves the resident ACE worker intact.

Left, Right and Off replace the recorded turn signals until Recorded is selected again. This applies to the music, native arrows and ordinary lane-change prompts on both displays. Off releases the shaker smoothly without starting more pulses. Important native alerts retain priority. Engagement and signal selections are independent.

Route1 is currently registered and ready. Route2–4 remain unavailable until their own matching core recordings are prepared and verified. Never substitute another route's music archive to bypass this check.

The local configuration is ignored by Git: roadscore/assets/demo_catalog.json stores the explicit comma address, local controls port and registered routes. The comma has its own catalog pointing to persistent local assets. Each entry needs the route identity, a compatible completed archive and an optional matching curve plan. No discovery or automatic target switching occurs.

The dual-native mode completed a full301.7-second FiiO audible run with Galaxy controls reaching both screens and successful cleanup. Tracking skew was85ms median and171ms at the95th percentile. Network delays sometimes paused corrections while replay continued. There were no callback or clock exceptions, but28 audio status flags and21 forward clock corrections were recorded, so completion does not establish glitch-free output. Fullscreen also passed an8-second native Mac replay check with no output flags or clock exceptions. The public JLab speaker still needs its own physical output/timing check.

For a Mac-only interactive fallback, use:

./onroad --roadscore route1 --prepared-showcase --unpaired

This opens native onroad replay on the Mac and processes the same preserved core with the current presentation layer. It needs the route cached on the Mac and ignored roadscore/assets/prepared_showcase.json, containing route, archive and optional curve_plan. The Mac uses its selected system audio output. A comma Bluetooth correction does not automatically apply to a Mac output.

Compatible archives contain dry.wav, launch.json, audio_blocks.jsonl, replay_origin.json and rhythm_timeline.json. Original dry PCM is used at unity gain, with the recorded model/DAC clock. The final mix is not processed twice. --score-archive PATH explicitly selects another compatible archive for the independent mode.

Both saved launchers support --muted, --duration SECONDS and --no-browser. Paired --check contacts Galaxy to verify the target is offroad; independent --check validates local prerequisites only. The controls server binds to loopback and refuses an occupied port. The paired target must be an explicit private IPv4 address on Galaxy port 8082.

The independent mode can follow Galaxy controls with --paired-comma URL, but controls alone do not synchronize playback. The paired --demo launcher additionally holds both starts and enables playhead following. --demo --screen-mirror retains the earlier explicit browser mirror for diagnosis; it is not the normal demo.

Ordinary ./onroad --roadscore route1 remains the fresh-generation path. Gold music and historical recordings are preserved. The deliverable is interactive replay; an MP4 is not a substitute.