97b0faa4a62db75ef39c3a1a9ab54de9e36bb30d
- Add sound_reference.md (937 lines): Real-world production reference covering Star Trek (TOS–ENT), Doctor Who/Whoniverse, Bioships (six ships across five franchises), and Space Stations (six stations across five sources). - Add agents.md: Project architecture guide (file ownership, load order, conventions). - Add telemetry_elements.md: Catalog of 10 telemetry elements with per-era selection weights and preset-by-preset routing. - Add visual_elements.md: Canvas/SVG split architecture, layer declarations, per-theme casts. - Fix duplicate soundboard mapping: Separate 'AIR HANDLER THUD' from 'DOCKING CLAMP LATCH'. Create ExpandedSciFiAudioSynth.synthesizeAirHandlerThud() (dull triangle-wave thump + sub-octave + slow airflow whoosh) distinct from synthesizeDockingClamp() (bright square-wave impact + pneumatic hiss). Update js/app.js to wire btn-air-handler to the new method. Key findings: * All 70 presets across 10 universes use Star Trek telemetry eras only — cross-universe borrowing is structural, not accidental. * Doctor Who TARDIS demat correctly implements Brian Hodgson's 1963 technique (piano strings + tape feedback). * Sevastopol Station's production sound design (Jeff van Dyck, Pinewood foley) is the best-documented non-Trek entry. * The Expanse's "jury-rigged" Belter signature (Nelson Ferreira) is the single most actionable production detail found. Co-Authored-By: Claude Haiku 4.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01NbMozG2xjcgLBia8vrzTrr
SciFi-XZBT Modular Architecture & Repackaging
Directory Overview
SciFi-XZBT/
├── index.html # Clean entry point (368 lines)
├── css/
│ └── style.css # LCARS styling, CRT effects, theme colors (2,317 lines)
├── js/
│ ├── audio.js # Web Audio synthesis, oscillators, sound engines (2,258 lines)
│ ├── config.js # Starship presets, Universe registry & palettes (1,039 lines)
│ ├── visualizer.js # Audio spectrum & Warp Core canvas rendering (643 lines)
│ ├── observation-bezels.js # Procedural SVG Viewport bezels (TOS, Voyager, TNG, etc.) (271 lines)
│ ├── observation-engine.js # Full observation mode canvas and simulation engine (2,784 lines)
│ └── app.js # DOM bindings, hotkeys, UI controllers & loop (3,962 lines)
├── dist/
│ └── SciFiAmbientDisplay_v4.html # Standalone, single-file offline build
└── tools/
├── package.ps1 # 1-click script to build the standalone single-file HTML
└── extract.ps1 # Original extraction script for reference
Development Workflow
-
Developing Modularly:
- Edit the specific CSS or JS files directly.
- For audio or synthesizer logic, focus exclusively on
js/audio.js. - For viewscreen bezels and framing, edit
js/observation-bezels.js. - For observation celestial mechanics and canvases, edit
js/observation-engine.js. - For presets and sound matrix tables, edit
js/config.js.
-
Repackaging to Single-File: Run the packaging script from PowerShell:
powershell -ExecutionPolicy Bypass -File .\tools\package.ps1This immediately produces
dist\SciFiAmbientDisplay_v4.html, combining all CSS and JS back into a self-contained, double-clickable offline file.
Languages
HTML
51.4%
JavaScript
44.5%
CSS
3.7%
PowerShell
0.4%