MIDNIGHT SIGNAL 1.1 — QUICK START

1. Extract the ZIP into a folder. Do not open files inside the ZIP.
2. Open START-HERE.html in a current desktop Chrome or Edge browser.
3. Pick a scene. Set your channel name, message, accent and timer.
4. Click Download scene. Each exported HTML includes its artwork and code.
5. In OBS Studio: Sources > + > Browser. Enable Local file and choose the exported HTML.
6. Set width/height: full scenes 1920x1080; camera 960x540; timer 960x220. Use 30 FPS.
7. Place camera frame ABOVE your camera source. Transparent center is intentional.
8. Starting/break/timer begins on page load. Enable Refresh browser when scene becomes active if you want a fresh countdown every time. Turn it off to let it continue across scenes; also disable Shutdown source when not visible. Reload resets the countdown.
9. To pause/resume: right-click source > Interact, click inside, press Space. R restarts. No buttons are drawn on the scene.
10. At zero the scene shows READY (editable). It does NOT switch OBS scenes. No sound is included.

READY-MADE FILES
start.html / break.html / end.html: full-screen scenes.
focus.html: work/break cycles (25/5 minutes, four rounds by default), three goals. The final work round completes the session without a trailing break. N skips phase; 1/2/3 toggle goals; ArrowUp adds a minute. Configure rounds, durations and language in the editor. Reload resets progress.
camera.html: transparent frame. timer.html: transparent five-minute countdown.
These work without the editor; change them by exporting replacements from START-HERE.

PRIVACY AND REQUIREMENTS
No login, internet, API key or paid subscription needed to render/export the kit.
No analytics, uploads, external fonts or network requests in the downloaded files.
Desktop workflow. Downloading/OBS installation is not intended for phones.
English/UA text is supported by system fonts. Long names are capped; inspect your export before broadcasting.
Motion can be disabled. OS reduced-motion preference is respected.
No Twitch/YouTube/StreamElements account integration, chat, donation alerts or Live2D model.

TROUBLESHOOTING
Blank source: confirm extracted .html file, Browser (not Media/Image), correct size. Refresh source cache.
Text too large: shorten headline; use the message field for a longer sentence.
Timer restarts: disable refresh-on-active and shutdown-on-hidden. Computer sleep suspends the session; refresh after waking before a show.
Black around camera: remove any background color you added in OBS Custom CSS; transparency is intentional.
To uninstall, remove the OBS source and delete the files.

VALIDATION STATUS, 16 OCTOBER 2026
JavaScript syntax, automated behavior and export checks passed. Browser visuals and keyboard controls checked. Actual OBS/CEF compatibility remains untested; this is a release candidate, not an OBS-certified product.
Official setup reference: https://obsproject.com/kb/browser-source
Artwork: original AI-generated city illustration. Interface, motion and timer implemented in code.


FREE RELEASE / БЕЗКОШТОВНИЙ НАБІР — 17.10.2026
All six elements and the editor are free. Усі шість елементів і редактор безкоштовні.
Optional credit / Необов’язкова згадка: Midnight Signal — https://vibe-coding.com.ua/midnight-signal-uk
Share the official page with other creators. / Поділіться сторінкою з іншими авторами.
