@openvidstudio/mcp-server 0.1.0 → 1.4.0

package/templates/default/output/README.md

@@ -0,0 +1,9 @@
+# output/
+
+Everything `render_video`, `contact_sheet`, and `qc_extract_frames` produce lands
+here: the rendered `<videoName>.mp4`, `contact-sheet.jpg`, and the `qc/<videoName>/`
+frame stills used for visual QC.
+
+This folder is gitignored (see `.gitignore` here) since renders are build output,
+not source. Pick the finished video up from `output/<videoName>.mp4`, or point an
+upload step at that path.

package/templates/default/package.json

@@ -3,22 +3,27 @@
   "version": "0.1.0",
   "description": "An openvidstudio video project, scaffolded from templates/default.",
   "private": true,
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
     "@openvidstudio/core": "file:./openvidstudio-core",
-    "@remotion/cli": "4.0.490",
-    "@remotion/google-fonts": "^4.0.490",
-    "@remotion/shapes": "^4.0.490",
-    "@remotion/tailwind-v4": "4.0.490",
-    "@remotion/transitions": "^4.0.490",
-    "react": "19.2.3",
-    "react-dom": "19.2.3",
-    "remotion": "4.0.490",
-    "tailwindcss": "4.0.0"
+    "@openvidstudio/stem": "file:./openvidstudio-stem",
+    "@remotion/cli": "4.0.536",
+    "@remotion/google-fonts": "4.0.536",
+    "@remotion/motion-blur": "4.0.536",
+    "@remotion/shapes": "4.0.536",
+    "@remotion/tailwind-v4": "4.0.536",
+    "@remotion/transitions": "4.0.536",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "remotion": "4.0.536",
+    "tailwindcss": "4.3.3"
   },
   "devDependencies": {
-    "@types/react": "19.2.7",
-    "@types/web": "0.0.166",
-    "typescript": "5.9.3"
+    "@types/react": "19.3.0",
+    "@types/web": "0.0.359",
+    "typescript": "7.0.2"
   },
   "scripts": {
     "dev": "remotion studio",
@@ -26,6 +31,7 @@
     "upgrade": "remotion upgrade"
   },
   "sideEffects": [
-    "*.css"
+    "*.css",
+    "./src/brand.ts"
   ]
 }

package/templates/default/public/imported_audios/README.md

@@ -0,0 +1,14 @@
+# public/imported_audios/
+
+Drop any sound effect or music file here that you want a scene to use. Reference
+it from a scene with `staticFile("imported_audios/<filename>")`.
+
+This is separate from `public/sfx/`, which is the synthesized pack `@openvidstudio/core`
+ships (clicks, keystrokes, a bell, a whoosh, a music bed). Nothing in `sfx/` carries
+third-party rights; anything you put here does, so credit the source in the video
+description if its licence asks for it.
+
+`plan_sound_effects` also writes here: it saves anything it fetches automatically
+(via the `freesound` provider) into this folder, and for anything you have to
+download by hand it writes the exact filename to save into `DOWNLOAD-THESE.md`
+alongside this README.

package/templates/default/public/sfx/CREDITS.md

@@ -0,0 +1,49 @@
+# Credits for public/sfx/
+
+A rendered video carries no attribution duty from anything here and no content ID.
+Four different sources, so all four are recorded.
+
+## Synthesized in this repo
+
+`bell.wav`, `blip.wav`, `success.wav`, `whoosh.wav` and `music-bed.mp3`
+come from `scripts/gen-sfx.sh` (ffmpeg, sine and anoisesrc). No sampled or
+licensed material went into any of them.
+
+## Mixkit
+
+`click.wav` is "Fast double click on mouse" (Mixkit sound effect 275,
+https://mixkit.co/free-sound-effects/click/), supplied by the project owner on 2026-10-19 to
+replace a 30 ms synthesized tick. Trimmed to the two clicks (the first lands on the cue frame),
+mixed to mono, 48 kHz 16-bit PCM like the rest of the pack, and raised 1.5 dB so its peak is
+-1.5 dBFS. Licence: the Mixkit Sound Effects Free License, https://mixkit.co/license/#sfxFree.
+Using it in a rendered video needs no attribution. The licence text could not be read when
+this file was added, so confirm its terms on redistribution before republishing this pack as
+a sound library on its own (a fork that only ships the video tool is a different thing).
+Replace it with a synthesized or CC0 click and `click.wav` stops being the only licensed file here.
+
+## Copyright-free recording
+
+`typing-effect.mp3` is a recording of typing, committed as-is. It replaced the four
+synthesized key sounds, which sounded like a metronome one sample per character.
+
+## CC0, from Kenney
+
+| File | Original |
+|---|---|
+| `bong.wav` | Kenney Interface Sounds, `interface/bong_001.ogg` |
+| `click_soft.wav` | Kenney Interface Sounds, `interface/click_001.ogg` |
+| `drop.wav` | Kenney Interface Sounds, `interface/drop_001.ogg` |
+
+Source: https://kenney.nl. Kenney's asset packs are released under CC0 1.0 (public
+domain): https://creativecommons.org/publicdomain/zero/1.0/. Commercial use is allowed
+and attribution is not required; this file exists so the provenance is on record, not
+because the licence asks for it.
+
+Converted from Vorbis .ogg to 48 kHz mono 16-bit PCM .wav to match the rest of the pack.
+CC0 permits the format change.
+
+## Adding your own
+
+Anything you bring in from elsewhere goes in `public/imported_audios/`, not here, so it
+stays obvious which sounds carry terms. `plan_sound_effects` enforces that split and
+writes an `ATTRIBUTION.md` next to whatever it fetches.

package/templates/default/scripts/visual-regression.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Renders this project's video and diffs it against the last accepted render.
+ *
+ * Meant for CI, but it is an ordinary script: run it locally with `node
+ * scripts/visual-regression.mjs <videoName>` and it does the same thing.
+ *
+ * Draft mode by default. A full-quality render on every merge is minutes of CI time for a
+ * check whose job is to notice that a panel changed colour, and draft is half resolution,
+ * which the comparison downscales anyway. Incremental is on for the same reason: after the
+ * first run, only the beats that actually changed are re-rendered.
+ *
+ * The baseline lives in .openvidstudio/visual-baseline/<videoName>/ and is meant to be
+ * committed. That is the whole mechanism: the diff is against what the repository last
+ * agreed the product looked like, and accepting a change is a commit like any other.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { runRenderVideo, runVisualRegression } from "@openvidstudio/mcp-server";
+
+const videoName = process.argv[2];
+if (!videoName) {
+  console.error("usage: node scripts/visual-regression.mjs <videoName>");
+  process.exit(2);
+}
+
+const projectRoot = process.cwd();
+const accept = process.argv.includes("--accept");
+const outPath = path.join("output", `${videoName}-ci.mp4`);
+
+const render = await runRenderVideo({
+  projectRoot,
+  videoName,
+  outPath,
+  draft: true,
+  incremental: true,
+  // CI has no brand to extract from and no product running; the look is whatever the
+  // project already committed.
+  skipBrandLock: true,
+});
+
+if (!render.success) {
+  console.error(render.stderr || render.stdout);
+  process.exit(1);
+}
+console.log(
+  `rendered ${render.renderedBeats?.length ?? "?"} beat(s), reused ${render.reusedBeats?.length ?? 0}, ` +
+    `${render.framesRendered ?? "?"} of ${render.totalFrames ?? "?"} frames in ${render.elapsedSeconds}s`,
+);
+
+const result = await runVisualRegression({
+  projectRoot,
+  videoName,
+  videoPath: outPath,
+  baselineDir: path.join(".openvidstudio", "visual-baseline", videoName),
+  updateBaseline: accept,
+});
+
+console.log(result.markdown);
+
+// Written to a file as well as stdout: the workflow posts this verbatim as a PR comment,
+// and passing multi-line markdown through a step output is a quoting problem nobody needs.
+fs.mkdirSync("output", { recursive: true });
+fs.writeFileSync(path.join("output", "visual-regression.md"), result.markdown + "\n", "utf8");
+
+// A drifted beat is a finding, not a build break: most of the time the change is intended
+// and the right response is to look at the diff and accept it. The workflow reports, the
+// human decides.
+process.exit(0);

package/templates/default/src/PreflightBenchmark.tsx

@@ -0,0 +1,49 @@
+// A fixed, representative composition preflight's render benchmark times: real camera
+// motion (CinematicScene's grain/vignette/grade plus a push-in/drift keyframe pair) over a
+// real DOM-rendered panel (ChecklistPanel), the same shape as a normal scaffolded scene.
+// Registered once by init_project into src/videos/.registry.json under videoName
+// "__preflight__", which stitch_composition's registry filter (by real videoName) never
+// touches, so this survives every re-stitch of every real video in the project.
+//
+// Never hand-edit this file's registration out of Root.tsx: stitch_composition
+// regenerates Root.tsx from the registry on every call, so an edit there is lost on the
+// next stitch of any video. Change the registry entry (see initProject.ts) instead.
+
+import React from "react";
+import { CinematicScene, Layer, ChecklistPanel, E } from "@openvidstudio/core";
+
+export const PreflightBenchmark: React.FC = () => {
+  return (
+    <CinematicScene
+      camera={[
+        { frame: 0, x: 960, y: 540, scale: 1.04, rotZ: -0.4 },
+        { frame: 150, x: 960, y: 548, scale: 1.18, rotZ: 0.4, easing: E.drift },
+      ]}
+    >
+      <Layer depth={0}>
+        <div
+          style={{
+            position: "absolute",
+            inset: 0,
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            padding: "0 180px",
+          }}
+        >
+          <ChecklistPanel
+            title="Preflight benchmark"
+            width={860}
+            fontSize={27}
+            items={[
+              { label: "Camera motion", flipAt: 20 },
+              { label: "Grain and vignette", flipAt: 50 },
+              { label: "DOM text reveal", flipAt: 80 },
+              { label: "A real frame, timed", flipAt: 110 },
+            ]}
+          />
+        </div>
+      </Layer>
+    </CinematicScene>
+  );
+};