Create show failover
create_show_failoverBuild a live-show failover watchdog that switches from a primary source to a fallback when cook stalls or errors occur, with configurable crossfade and auto-recover.
Instructions
Build a live-show watchdog: a Switch TOP (blend=1 cross-dissolve) between a primary source TOP (NDI/camera/Spout/Syphon path, or a synthetic noiseTOP when none is given) and an MP4 fallback (or a constantTOP when no file is given), driven by an Info CHOP + watchdog CHOP-Execute DAT that trips on cook stall (total_cooks delta stays flat for stall_ms) and, optionally, primary cook errors. A Filter CHOP smooths the integer Switch index into a fade_ms crossfade. Sticky-recover auto-returns to primary after recover_ms healthy; otherwise stays on fallback until Reset. Exposes Active / Stall_Ms / Fade_Ms / Sticky_Recover / Reset / Force_Fallback controls and a Null CHOP of status channels for bind_to_channel. Returns the container, output TOP, status CHOP, control names, and the operator paths.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| primary_path | No | Absolute TD path to the primary source TOP (NDI/camera/Spout/Syphon/any TOP). Empty → builds a synthetic noiseTOP so the network is offline-safe. | |
| fallback_file | No | Filesystem path to the fallback MP4 / still. Empty → a constantTOP (dark grey) is used as a safe fallback. | |
| stall_ms | No | Consecutive ms of zero cook progress before failover trips. | |
| fade_ms | No | Crossfade duration in ms (0 = hard cut). Drives the Filter CHOP that smooths the Switch TOP index. | |
| sticky_recover | No | When true, auto-switch back to primary after `recover_ms` of healthy cooking. When false, stays on fallback until Reset is pressed. | |
| recover_ms | No | Healthy duration before auto-recover (only used when sticky_recover=true). | |
| watch_errors | No | Also trip on primary cook errors (`errors > 0`), not just on stall. | |
| status_overlay | No | Composite a small LIVE/FALLBACK badge (textTOP + compTOP) into the output. | |
| parent_path | No | Where to create the show_failover system container. | /project1 |