# Broadcast channels ## What this builds A television you can flip through, with a guide and a channel number, playing local fixture videos on a schedule. It has the feel of evening channels, but it is not a front-end for a live commercial video site, and it does not use that site's name in the product id. Checks use fixture files and an injected clock. A hook fails if a known video-host is contacted. Read `spekkr.inputs.json` first. `title` is on the guide. `clock` is the injected now. `set` chooses the schedule. `guide` and `chrome` change the picture. ## Out of scope - A live commercial video site, or that site's name in the product id. - Network or a real programme guide in the checks. - A tuner or a broadcast licence. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Schedules and flipping - At the fixture time, each channel's current item is the one in `fixtures/evening-2026-01-15-20-15.json`. - A flip up or down moves to the next channel in the list and plays that channel's current fixture file from a documented offset (the time into the programme). - A channel with no item at that time shows an off-air slide. Accept when: the current items match, a flip from channel 3 to 4 plays the listed file at the listed offset, and an empty slot shows off-air. ### R2. No live host - Videos are local files listed in the set. A fetch hook fails if a known video-host or CDN is contacted. - Goldens: the guide, channel 3 playing, a mid-flip frame, and the off-air slide. - One command runs the schedule, the flip, the hook, and writes the frames. The clock is injected. No network. Accept when: the hook stays quiet, and the four frames match the goldens. ### R3. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification Channel schedules and flipping are tested with fixture video files and an injected clock. A fetch hook fails if a live video host is contacted. A golden TV-frame screenshot is checked. The product does not use a commercial video site's name in its id. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to flip channels, how to add a fixture, and how to run the checks.