`. Pure runtime state.
+bridges/cover.jpg
+
# Local backups created during edits — keep out of git noise.
landing/*.manual
loading/*.manual
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..97ddaaf
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,20 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+This repository is the live OBS Studio config for the `ophi118` rig. Core OBS state lives in `basic/scenes/` and `basic/profiles/`; treat those as OBS-owned files. Browser-source overlays are organized by scene in `landing/`, `loading/`, `game/`, `desktop/`, `music-box/`, `music/`, and `goodbye/`. Support automation lives in `scripts/`, Python services in `bridges/`, `twitch-bot/`, and `station/server/`, shared browser helpers in `vendor/`, and plugin settings in `plugin_config/`.
+
+## Build, Test, and Development Commands
+Run OBS with `flatpak run com.obsproject.Studio`. Before first use on a rig, run `bash scripts/deploy-rig.sh` or `bash scripts/deploy-rig.sh --check` for a dry run. Refresh browser-source connectivity with `bash scripts/setup.sh`. Update overlay data with `bash scripts/loading.sh` and `bash scripts/telemetry.sh --collect`.
+
+For Python smoke checks, use:
+```bash
+python -m py_compile bridges/mpd-state.py twitch-bot/*.py station/server/status_service.py
+```
+## Coding Style & Naming Conventions
+Shell scripts should keep `bash` shebangs, `set -euo pipefail`, and concise helper functions. Python follows 4-space indentation, `snake_case`, and small single-purpose modules. Keep overlay pages self-contained and scene-specific; prefer descriptive filenames such as `loading/playlist.json` or `music-box/widget.html`. Preserve existing JSON key names because OBS and browser overlays depend on them exactly.
+
+## Testing Guidelines
+There is no single automated test suite for the repo. Validate Python with `py_compile`, validate generated JSON with the existing scripts, and smoke-test overlay edits in OBS by refreshing the browser source. Close OBS before editing `basic/scenes/*.json`, `user.ini`, or `global.ini`, or your changes may be overwritten on exit.
+
+## Commit & Pull Request Guidelines
+Recent history uses scoped, imperative commit subjects such as `Landing: rig name decode/scramble in top HUD` and `Twitch bot: per-user !skip cooldown + !queue + !info`. Follow that format: `:
+
+
+
+
+
+
+
+
+
+ ▶connecting to daemon…[--:-- / --:--]
+
+ 
` so a hash bump cache-busts
+cleanly. coverHash null = no art available; overlays should show a
+placeholder. Reads MPD library root from MPD_MUSIC_DIR env var, default
+~/HDD/Music (matches mpd.conf).
+
Reads OBS WS credentials from ../vendor/obs-config.js (auto-generated by
scripts/setup.sh from plugin_config/obs-websocket/config.json — single source of truth).
@@ -41,7 +62,12 @@ HERE = Path(__file__).resolve().parent
OBS_CONFIG_JS = HERE.parent / "vendor" / "obs-config.js"
MPD_HOST = os.environ.get("MPD_HOST", "localhost")
MPD_PORT = int(os.environ.get("MPD_PORT", "6600"))
+MPD_MUSIC_DIR = Path(os.environ.get("MPD_MUSIC_DIR", "~/HDD/Music")).expanduser()
TICK_SECONDS = 1.0 # broadcast cadence; matches the old daemon's setInterval(broadcastState, 1000)
+STATS_REFRESH_SEC = 30.0 # how often to re-poll MPD `stats` for library counts
+COVER_OUT = HERE / "cover.jpg" # canonical cover bytes; overlays cache-bust via ?v=
- TRANSMISSION
- OPHI-118 // DESKTOP
-
-
- SIGNAL
- ▮▮▮▯▯
-
-
- UTC
- --:--:--
-
-
@@ -264,7 +229,11 @@
LIVE
·
- DESKTOP
+ OPHI-118 // DESKTOP
+
+ SIGNAL▮▮▮▯▯
+ ·
+ UTC--:--:--
◷
@@ -311,12 +280,18 @@
tickElapsed(); setInterval(tickElapsed, 1000);
// ── OBS WS: live frame sync for camera + screen capture ──
- // URL params let you rename the sources / scene without editing JS:
- // ?camera=Webcam&screen=Display&scene=Desktop
+ // URL params:
+ // ?camera=Webcam override the source name to track for camera
+ // ?screen=Display override the source name to track for screen
+ // ?scene=Desktop LOCK the HUD to a specific scene (optional)
+ // When ?scene= is omitted (the default) the HUD follows whichever scene is
+ // currently program — so the same browser source can be referenced in both
+ // Desktop and Desktop (No Cam): switching scenes rebinds to the items in
+ // the now-active scene, and the camera/screen frames toggle/move with it.
const params = new URLSearchParams(location.search);
const CAM_SOURCE = params.get('camera') || 'Camera';
const SCR_SOURCE = params.get('screen') || 'Screen Capture (PipeWire)';
- const SCENE = params.get('scene') || 'Desktop';
+ const SCENE_LOCK = params.get('scene') || null;
const camEl = document.getElementById('cam');
const scrEl = document.getElementById('scr');
@@ -336,10 +311,12 @@
};
}
- // Bind a frame element to a scene item: live-sync size/position into the
- // --{prefix}-x/y/w/h CSS vars and toggle .off on enable changes.
+ // Frame binding for one tracked source. Holds mutable {sceneName, itemId}
+ // so the event filter reads through to the *current* binding — that lets
+ // rebind() swap scenes without leaking listeners or stale itemIds.
// Assumes alignment 5 (top-left) — OBS's default for newly added items.
- async function syncSourceFrame(obs, { sceneName, sourceName, frameEl, varPrefix }) {
+ function makeFrame(obs, sourceName, frameEl, varPrefix) {
+ const state = { sceneName: null, itemId: null };
const setVisible = (v) => frameEl.classList.toggle('off', !v);
const setTransform = (t) => {
if (!t) return;
@@ -350,30 +327,39 @@
rootStyle.setProperty(`--${varPrefix}-w`, `${w}px`);
rootStyle.setProperty(`--${varPrefix}-h`, `${h}px`);
};
- let itemId = null;
- try {
- const r = await obs.call('GetSceneItemId', { sceneName, sourceName });
- itemId = r.sceneItemId;
- const e = await obs.call('GetSceneItemEnabled',
- { sceneName, sceneItemId: itemId });
- setVisible(e.sceneItemEnabled);
- const t = await obs.call('GetSceneItemTransform',
- { sceneName, sceneItemId: itemId });
- setTransform(t.sceneItemTransform);
- } catch (err) {
- console.warn(`[desktop] frame sync failed (${sceneName}/${sourceName}):`, err.message);
- return;
- }
- obs.addEventListener('event', (ev) => {
- const d = ev.detail || {};
- if (d.eventData?.sceneName !== sceneName
- || d.eventData?.sceneItemId !== itemId) return;
- if (d.eventType === 'SceneItemEnableStateChanged') {
- setVisible(d.eventData.sceneItemEnabled);
- } else if (d.eventType === 'SceneItemTransformChanged') {
- setTransform(d.eventData.sceneItemTransform);
- }
- });
+ return {
+ async rebind(sceneName) {
+ state.sceneName = sceneName;
+ state.itemId = null;
+ if (!sceneName) { setVisible(false); return; }
+ try {
+ const r = await obs.call('GetSceneItemId',
+ { sceneName, sourceName });
+ state.itemId = r.sceneItemId;
+ const e = await obs.call('GetSceneItemEnabled',
+ { sceneName, sceneItemId: state.itemId });
+ setVisible(e.sceneItemEnabled);
+ const t = await obs.call('GetSceneItemTransform',
+ { sceneName, sceneItemId: state.itemId });
+ setTransform(t.sceneItemTransform);
+ } catch {
+ // Source isn't in this scene (or scene doesn't exist) — hide
+ // the frame outright. This is what makes "Desktop (No Cam)"
+ // work cleanly even if Camera were fully removed (rather than
+ // just disabled).
+ setVisible(false);
+ }
+ },
+ handleEvent(d) {
+ if (d.eventData?.sceneName !== state.sceneName
+ || d.eventData?.sceneItemId !== state.itemId) return;
+ if (d.eventType === 'SceneItemEnableStateChanged') {
+ setVisible(d.eventData.sceneItemEnabled);
+ } else if (d.eventType === 'SceneItemTransformChanged') {
+ setTransform(d.eventData.sceneItemTransform);
+ }
+ },
+ };
}
async function connectOBS() {
@@ -381,14 +367,34 @@
try {
const obs = new OBSWSMini(window.__OBSWS.url, window.__OBSWS.password);
await obs.connect();
- obs.addEventListener('close', () => {
- setTimeout(connectOBS, 2500);
+ obs.addEventListener('close', () => setTimeout(connectOBS, 2500));
+
+ const camFrame = makeFrame(obs, CAM_SOURCE, camEl, 'cam');
+ const scrFrame = makeFrame(obs, SCR_SOURCE, scrEl, 'scr');
+
+ // Resolve the scene to track. With ?scene= explicit, lock to it;
+ // otherwise follow whatever's currently program. Modern obs-websocket
+ // returns currentProgramSceneName; older builds returned sceneName —
+ // accept both.
+ let scene = SCENE_LOCK;
+ if (!scene) {
+ try {
+ const r = await obs.call('GetCurrentProgramScene');
+ scene = r.currentProgramSceneName || r.sceneName || null;
+ } catch { /* leave null; rebind on first scene change */ }
+ }
+ await Promise.all([camFrame.rebind(scene), scrFrame.rebind(scene)]);
+
+ obs.addEventListener('event', async (ev) => {
+ const d = ev.detail || {};
+ if (!SCENE_LOCK && d.eventType === 'CurrentProgramSceneChanged') {
+ const next = d.eventData?.sceneName;
+ await Promise.all([camFrame.rebind(next), scrFrame.rebind(next)]);
+ return;
+ }
+ camFrame.handleEvent(d);
+ scrFrame.handleEvent(d);
});
- // Run both syncs in parallel — independent items, independent failures.
- await Promise.all([
- syncSourceFrame(obs, { sceneName: SCENE, sourceName: CAM_SOURCE, frameEl: camEl, varPrefix: 'cam' }),
- syncSourceFrame(obs, { sceneName: SCENE, sourceName: SCR_SOURCE, frameEl: scrEl, varPrefix: 'scr' }),
- ]);
} catch (e) {
// OBS WS optional — silently retry; defaults stand meanwhile.
setTimeout(connectOBS, 2500);
diff --git a/music-box/cover.html b/music-box/cover.html
new file mode 100644
index 0000000..621f6c2
--- /dev/null
+++ b/music-box/cover.html
@@ -0,0 +1,295 @@
+
+
+
+
+Music Box cover
+
+
+
+
+
+
+
+
+
+ OPHI-118 / NC-MUSIC-BOX
+
+
+
+
+
+
+
+
+
+
+
+ ┤ TERMINAL ├
+
+
+
+
+
+
+
+ CHAT
+
+ !skipnext track
+ !queuepeek next 3
+ !infofull metadata
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/plugin_manager/modules.json b/plugin_manager/modules.json
index 00d1058..c7999f0 100644
--- a/plugin_manager/modules.json
+++ b/plugin_manager/modules.json
@@ -9,5 +9,18 @@
"services": [],
"sources": [],
"version": ""
+ },
+ {
+ "display_name": "phandasm_waveform",
+ "enabled": true,
+ "encoders": [],
+ "id": "",
+ "module_name": "waveform",
+ "outputs": [],
+ "services": [],
+ "sources": [
+ "phandasm_waveform_source"
+ ],
+ "version": ""
}
]
diff --git a/user.ini b/user.ini
index 094beea..8ae5861 100644
--- a/user.ini
+++ b/user.ini
@@ -25,8 +25,8 @@ cx=720
cy=580
[BasicWindow]
-geometry=AdnQywADAAAAAAAAAAAAAAAACf8AAAVDAAAKAQAAABkAAA3AAAAEHAAAAAECAAAACgAAAAAAAAAAAAAACf8AAAVD
-DockState=AAAA/wAAAAD9AAAAAQAAAAMAAAoAAAABKPwBAAAABvsAAAAUAHMAYwBlAG4AZQBzAEQAbwBjAGsBAAAAAAAAAdgAAACYAP////sAAAAWAHMAbwB1AHIAYwBlAHMARABvAGMAawEAAAHcAAAB1QAAAJgA////+wAAABIAbQBpAHgAZQByAEQAbwBjAGsBAAADtQAAAroAAAECAP////sAAAAeAHQAcgBhAG4AcwBpAHQAaQBvAG4AcwBEAG8AYwBrAQAABnMAAAHSAAAArQD////7AAAAGABjAG8AbgB0AHIAbwBsAHMARABvAGMAawEAAAhJAAABtwAAAKIA////+wAAABIAcwB0AGEAdABzAEQAbwBjAGsCAAAExAAAAXAAAAK8AAAAyAAACgAAAAPcAAAABAAAAAQAAAAIAAAACPwAAAAA
+geometry=AdnQywADAAAAAAAAAAAAAAAACf8AAAVDAAAGPwAAABkAAAn+AAAEFgAAAAECAAAACgAAAAAAAAAAAAAACf8AAAVD
+DockState=AAAA/wAAAAD9AAAAAQAAAAMAAAoAAAABA/wBAAAABvsAAAAUAHMAYwBlAG4AZQBzAEQAbwBjAGsBAAAAAAAAAdgAAACYAP////sAAAAWAHMAbwB1AHIAYwBlAHMARABvAGMAawEAAAHcAAAB1QAAAJgA////+wAAABIAbQBpAHgAZQByAEQAbwBjAGsBAAADtQAAAroAAAECAP////sAAAAeAHQAcgBhAG4AcwBpAHQAaQBvAG4AcwBEAG8AYwBrAQAABnMAAAHSAAAArQD////7AAAAGABjAG8AbgB0AHIAbwBsAHMARABvAGMAawEAAAhJAAABtwAAAKIA////+wAAABIAcwB0AGEAdABzAEQAbwBjAGsCAAAExAAAAXAAAAK8AAAAyAAACgAAAAQBAAAABAAAAAQAAAAIAAAACPwAAAAA
PreviewEnabled=true
AlwaysOnTop=false
SceneDuplicationMode=true
+ ALBUM ART
+ CH 118.0 // MUSIC
+
+
+
+ ![]()
+
+
+
+
+ — NO ART —
+ awaiting cover…
+
+
+
+ ▶connecting…
+
+
+
+
+
+
+
diff --git a/music-box/nc-music-box.html b/music-box/nc-music-box.html
new file mode 100644
index 0000000..8b2b2ae
--- /dev/null
+++ b/music-box/nc-music-box.html
@@ -0,0 +1,804 @@
+
+
+
+
+
+ ON AIR
+ OPHI-118 // MUSIC
+
+
+ SIGNAL
+ ▮▮▮▮▯
+
+
+ UTC
+ --:--:--
+
+