@openvidstudio/mcp-server 0.1.0

package/templates/default/openvidstudio-core/src/motion.ts

@@ -0,0 +1,50 @@
+// Easing + spring presets. Linear easing is banned (STYLE.md). Always pick from here.
+
+import { Easing, interpolate, spring } from "remotion";
+
+export const E = {
+  // default cinematic move: slow-out, soft landing
+  cinematic: Easing.bezier(0.33, 0.0, 0.13, 1.0),
+  // aggressive whip (cuts, fast pans)
+  whip: Easing.bezier(0.8, 0.0, 0.1, 1.0),
+  // gentle drift (ambient motion inside a shot)
+  drift: Easing.bezier(0.4, 0.0, 0.6, 1.0),
+  // snappy UI reaction (button press, blip reveal)
+  snap: Easing.bezier(0.2, 0.9, 0.25, 1.0),
+} as const;
+
+export const SPRING = {
+  soft: { damping: 26, stiffness: 90, mass: 1 },
+  pop: { damping: 14, stiffness: 160, mass: 0.8 },
+  heavy: { damping: 30, stiffness: 60, mass: 1.4 },
+} as const;
+
+/** interpolate with a mandatory named easing and clamped edges. */
+export const tween = (
+  frame: number,
+  range: [number, number],
+  out: [number, number],
+  easing: (t: number) => number = E.cinematic,
+) =>
+  interpolate(frame, range, out, {
+    easing,
+    extrapolateLeft: "clamp",
+    extrapolateRight: "clamp",
+  });
+
+/** spring entrance helper */
+export const pop = (
+  frame: number,
+  fps: number,
+  delay = 0,
+  config: { damping: number; stiffness: number; mass: number } = SPRING.pop,
+) => spring({ frame: frame - delay, fps, config });
+
+/** deterministic per-frame pseudo-random (for grain jitter etc.) */
+export const jitter = (frame: number, seed = 1) => {
+  const x = Math.sin(frame * 127.1 + seed * 311.7) * 43758.5453;
+  return x - Math.floor(x); // 0..1
+};
+
+/** stagger helper: frame offset for item i */
+export const staggerDelay = (i: number, step = 3) => i * step;

package/templates/default/openvidstudio-core/src/sfx.tsx

@@ -0,0 +1,106 @@
+// SFX sequencer. All sounds live in public/sfx/ (generated by scripts/gen-sfx.sh).
+// Components emit sounds by rendering these helpers at computed frames, audio stays
+// perfectly in sync with visuals because both derive from the same frame math.
+
+import React from "react";
+import { Audio, Sequence, staticFile } from "remotion";
+import { jitter } from "./motion";
+
+const KEYS = ["key_a.wav", "key_b.wav", "key_c.wav"];
+
+export const KeySound: React.FC<{ at: number; seed?: number; volume?: number }> = ({
+  at,
+  seed = 0,
+  volume = 0.16,
+}) => (
+  <Sequence from={at} durationInFrames={6}>
+    <Audio
+      src={staticFile(`sfx/${KEYS[Math.floor(jitter(at, seed) * KEYS.length)]}`)}
+      volume={volume}
+    />
+  </Sequence>
+);
+
+/** One KeySound per typed character. charFrames = absolute frame each char appears. */
+export const TypingSfx: React.FC<{ charFrames: number[]; volume?: number }> = ({
+  charFrames,
+  volume = 0.16,
+}) => (
+  <>
+    {charFrames.map((f, i) => (
+      <KeySound key={i} at={f} seed={i} volume={volume} />
+    ))}
+  </>
+);
+
+export const Click: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.4,
+}) => (
+  <Sequence from={at} durationInFrames={8}>
+    <Audio src={staticFile("sfx/click.wav")} volume={volume} />
+  </Sequence>
+);
+
+export const Whoosh: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.35,
+}) => (
+  <Sequence from={at} durationInFrames={20}>
+    <Audio src={staticFile("sfx/whoosh.wav")} volume={volume} />
+  </Sequence>
+);
+
+export const Blip: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.3,
+}) => (
+  <Sequence from={at} durationInFrames={8}>
+    <Audio src={staticFile("sfx/blip.wav")} volume={volume} />
+  </Sequence>
+);
+
+export const SuccessChime: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.35,
+}) => (
+  <Sequence from={at} durationInFrames={20}>
+    <Audio src={staticFile("sfx/success.wav")} volume={volume} />
+  </Sequence>
+);
+
+/** Struck bell, for a completion moment that wants more weight than a chime. */
+export const Bell: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.3,
+}) => (
+  <Sequence from={at} durationInFrames={48}>
+    <Audio src={staticFile("sfx/bell.wav")} volume={volume} />
+  </Sequence>
+);
+
+/** Enter key. Deeper and heavier than a letter key, for the end of a typed command. */
+export const EnterKey: React.FC<{ at: number; volume?: number }> = ({
+  at,
+  volume = 0.2,
+}) => (
+  <Sequence from={at} durationInFrames={8}>
+    <Audio src={staticFile("sfx/key_enter.wav")} volume={volume} />
+  </Sequence>
+);
+
+/**
+ * Ambient bed under the whole composition.
+ *
+ * Synthesized by scripts/gen-sfx.sh rather than licensed, so a rendered video
+ * carries no third-party audio rights. The source is 60s; `durationInFrames` loops
+ * it to cover the composition.
+ */
+export const MusicBed: React.FC<{ durationInFrames: number; volume?: number }> = ({
+  durationInFrames,
+  volume = 0.16,
+}) => (
+  <Sequence from={0} durationInFrames={durationInFrames}>
+    <Audio src={staticFile("sfx/music-bed.mp3")} volume={volume} loop />
+  </Sequence>
+);

package/templates/default/openvidstudio-core/src/tokens.ts

@@ -0,0 +1,41 @@
+// Design tokens: single source for every scene. Per-video themes may override via themes/.
+
+export const color = {
+  // dark stage
+  bg0: "#0B0E14",
+  bg1: "#11151F",
+  panel: "#151A24",
+  panelBorder: "#232B3A",
+  textPrimary: "#E6EAF2",
+  textSecondary: "#8A94A6",
+  // accents
+  accent: "#4E9EFF",
+  accentAlt: "#9D6BFF",
+  success: "#3ECF8E",
+  warn: "#F5A623",
+  danger: "#F26D6D",
+  // light scenes
+  lightBg: "#F4F6F9",
+  lightCard: "#FFFFFF",
+  lightShadow: "rgba(15,23,42,0.12)",
+} as const;
+
+export const font = {
+  ui: "Inter",
+  mono: "JetBrains Mono",
+} as const;
+
+export const glow = (c: string, strength = 1) => ({
+  textShadow: `0 0 ${8 * strength}px ${c}88, 0 0 ${24 * strength}px ${c}44`,
+});
+
+export const panelShadow = (dark = true) =>
+  dark
+    ? "0 24px 80px rgba(0,0,0,0.55), 0 4px 16px rgba(0,0,0,0.4)"
+    : `0 24px 80px ${color.lightShadow}, 0 4px 16px rgba(15,23,42,0.08)`;
+
+export const radius = {
+  window: 12,
+  card: 10,
+  pill: 999,
+} as const;

package/templates/default/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "openvidstudio-project",
+  "version": "0.1.0",
+  "description": "An openvidstudio video project, scaffolded from templates/default.",
+  "private": true,
+  "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"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.7",
+    "@types/web": "0.0.166",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "dev": "remotion studio",
+    "build": "remotion bundle",
+    "upgrade": "remotion upgrade"
+  },
+  "sideEffects": [
+    "*.css"
+  ]
+}

package/templates/default/remotion.config.ts

@@ -0,0 +1,13 @@
+/**
+ * Note: When using the Node.JS APIs, the config file
+ * doesn't apply. Instead, pass options directly to the APIs.
+ *
+ * All configuration options: https://remotion.dev/docs/config
+ */
+
+import { Config } from "@remotion/cli/config";
+import { enableTailwind } from "@remotion/tailwind-v4";
+
+Config.setVideoImageFormat("jpeg");
+Config.setOverwriteOutput(true);
+Config.overrideWebpackConfig(enableTailwind);

package/templates/default/src/Root.tsx

@@ -0,0 +1,9 @@
+// Bare Remotion root. No compositions registered yet. stitch_composition
+// (not init_project) populates this file, via src/videos/.registry.json,
+// once at least one video has been scaffolded and stitched.
+
+import React from "react";
+
+export const RemotionRoot: React.FC = () => {
+  return null;
+};

package/templates/default/src/index.ts

@@ -0,0 +1,4 @@
+import { registerRoot } from "remotion";
+import { RemotionRoot } from "./Root";
+
+registerRoot(RemotionRoot);

package/templates/default/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "lib": ["ES2020", "DOM"],
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noUnusedLocals": true
+  },
+  "exclude": ["remotion.config.ts"]
+}