reelme 0.3.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # reelme
 
-Turn your repo into launch videos for social platforms — rendered locally with [Remotion](https://www.remotion.dev), zero cloud, zero API keys.
+Turn your repo into launch videos for social platforms — rendered on your machine with [Remotion](https://www.remotion.dev). No accounts, no API keys, nothing uploaded.
 
 `reelme` is the rendering engine behind the [reelme agent skill](https://github.com/RubenGlez/reelme). The skill does the thinking (it reads your repo, interviews you, and writes a `reelme.json` brief at your repo root); this CLI does the work: it scaffolds a Remotion project in a global cache and renders one video variant per publishing platform.
 
@@ -24,12 +24,13 @@ npx skills add RubenGlez/reelme
 |---|---|
 | `npx reelme render` | Renders every platform selected in `reelme.json` to `./reelme-out/` |
 | `npx reelme studio` | Opens Remotion Studio against the cached project, for previewing and tweaking |
-| `npx reelme clean` | Removes the reelme cache (`~/.reelme/cache`) |
+| `npx reelme validate` | Checks `reelme.json` (schema, platforms, scene types and fields) without rendering |
+| `npx reelme clean` | Removes this project's cache (add `--all` to wipe every project's cache in `~/.reelme/cache`) |
 
 ## How it works
 
 - Your repo keeps only two things: `reelme.json` (the brief — commit it, it's your video's source of truth across releases) and `reelme-out/` (rendered videos; add it to `.gitignore`).
-- The heavy Remotion project lives in `~/.reelme/cache/<project-hash>/`, scaffolded on first render and reused afterwards. Re-renders don't reinstall anything; upgrading the CLI rebuilds the scaffold automatically.
+- The heavy Remotion project lives in `~/.reelme/cache/<project-hash>/`, scaffolded on first render and reused afterwards. Re-renders don't reinstall anything; upgrading the CLI (or changing the template's dependencies) rebuilds the scaffold automatically.
 - Each platform you select (X, LinkedIn, YouTube, TikTok, Instagram Reel/Story/Feed, GitHub README) maps to a preset that resolves dimensions, duration ceilings, and safe areas internally — you never deal with aspect ratios. GitHub README outputs a GIF; everything else is MP4. Briefs with a `teaser` cut also get a short `<platform>-teaser.mp4` per social platform.
 
 ## Requirements
@@ -37,6 +38,12 @@ npx skills add RubenGlez/reelme
 - Node.js >= 18
 - [pnpm](https://pnpm.io) (used to install render dependencies inside the cache)
 
+The first render needs network access: it installs the Remotion project into the
+cache (npm registry), downloads a headless Chrome build (hundreds of MB, once),
+and fetches the on-screen fonts from Google Fonts. After the first successful
+render most of this is cached, but font loading still runs per render — nothing
+you author is ever uploaded.
+
 ## License
 
 MIT

package/assets/audio/PROVENANCE.md

@@ -1,16 +1,23 @@
 # ReelMe Bundled Audio Provenance
 
-The bundled tracks in this directory are instrumental loops generated by
-`generate-tracks.mjs` for ReelMe. They do not sample third-party recordings,
-loops, MIDI files, or stems.
+The bundled music beds in this directory are curated **CC0 (public domain)**
+loops from [Freesound](https://freesound.org). Each `manifest.json` entry lists
+the uploader (`artist`) and the sound's Freesound page (`source`); CC0 requires
+no attribution, but the credits are kept as a courtesy. The files were loudness-
+normalized (`loudnorm I=-16:TP=-1.5`) to sit under the mix and re-encoded as MP3;
+they are otherwise unedited.
 
-The generated tracks are dedicated to the public domain under CC0 1.0. The
-manifest source URLs point to the generator definition used to create each
-track. Regenerate the MP3 files with:
+| file | Freesound | uploader |
+|---|---|---|
+| `lofi-dusk.mp3` | https://freesound.org/s/852231/ | holizna |
+| `warm-memories.mp3` | https://freesound.org/s/826622/ | xkeril |
+| `neon-pulse.mp3` | https://freesound.org/s/415922/ | newagesoup |
+| `night-drive.mp3` | https://freesound.org/s/211555/ | waveplaySFX |
+| `sunny-bounce.mp3` | https://freesound.org/s/512340/ | mistermender |
+| `light-steps.mp3` | https://freesound.org/s/410520/ | Jamessi |
 
-```bash
-node cli/assets/audio/generate-tracks.mjs
-```
+**Beat sync.** Each bed is an exact whole-beat loop at the `bpm` recorded in
+`manifest.json`, so the CLI can quantize scene cuts to the beat and the loop
+stays locked when Remotion repeats it (`sunny-bounce` is within ~0.1 beat).
 
-Each track is 32 seconds long, encoded as MP3, and kept below 2 MB for package
-size.
+Each file is kept below 2 MB for package size.

package/assets/audio/generate-sfx.mjs

@@ -0,0 +1,128 @@
+// Procedural SFX generator — FALLBACK ONLY. The shipped cues in sfx/ are
+// curated ElevenLabs sound effects (see sfx/SOURCES.md); this script exists so
+// the cues can be regenerated from nothing if those files are ever removed.
+// It REFUSES to overwrite existing files unless run with --force.
+//
+//   whoosh.mp3 — air sweep for fast lateral cuts (whip/wipe/flip)
+//   pop.mp3    — soft low knock for settle cuts (zoom/punch/rise/fade)
+//   rise.mp3   — swell into the end card (CTA), peak at 0.6s
+//
+//   node cli/assets/audio/generate-sfx.mjs --force   (requires ffmpeg on PATH)
+import { writeFileSync, rmSync, existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const SAMPLE_RATE = 44100;
+const TWO_PI = Math.PI * 2;
+
+// Deterministic noise so regeneration is reproducible.
+function makeNoise() {
+  let seed = 0x9e3779b9;
+  return () => {
+    seed ^= seed << 13;
+    seed ^= seed >>> 17;
+    seed ^= seed << 5;
+    seed >>>= 0;
+    return (seed / 0xffffffff) * 2 - 1;
+  };
+}
+
+// One-pole band-ish filter state per render call.
+function renderWhoosh(t, dur, noise, state) {
+  // Noise through a swept low-pass: dark → bright → gone. Reads as air, not tape hiss.
+  const p = t / dur;
+  const cutoff = 400 + 5200 * Math.sin(Math.PI * p) ** 2;
+  const alpha = Math.min(1, cutoff / (SAMPLE_RATE / 2 / Math.PI));
+  state.lp += alpha * (noise() - state.lp);
+  const body = state.lp - state.lp2;
+  state.lp2 += 0.02 * (state.lp - state.lp2); // high-pass against rumble
+  const envelope = Math.sin(Math.PI * p) ** 1.6;
+  return body * envelope * 2.2;
+}
+
+function renderPop(t, dur) {
+  // A soft knock: quickly decaying low sine with a faint click transient.
+  const knock = Math.sin(TWO_PI * 130 * t * (1 - t * 1.6)) * Math.exp(-t * 42);
+  const click = Math.sin(TWO_PI * 1900 * t) * Math.exp(-t * 300) * 0.25;
+  return (knock + click) * 0.9;
+}
+
+function renderRise(t, dur, noise, state) {
+  // Swell: filtered noise + a fifth dyad crescendo that stops just before the
+  // peak — the visual landing supplies the actual accent.
+  const p = t / dur;
+  const cutoff = 250 + 2600 * p * p;
+  const alpha = Math.min(1, cutoff / (SAMPLE_RATE / 2 / Math.PI));
+  state.lp += alpha * (noise() - state.lp);
+  const air = state.lp * 0.7;
+  const dyad = (Math.sin(TWO_PI * 220 * t) + Math.sin(TWO_PI * 330 * t) * 0.6) * 0.18;
+  const envelope = p * p * (p < 0.92 ? 1 : (1 - p) / 0.08);
+  return (air + dyad) * envelope * 1.4;
+}
+
+const SFX = [
+  { file: "whoosh.mp3", dur: 0.42, render: renderWhoosh },
+  { file: "pop.mp3", dur: 0.18, render: renderPop },
+  { file: "rise.mp3", dur: 0.85, render: renderRise },
+];
+
+function writeWav(path, sfx) {
+  const frames = Math.round(SAMPLE_RATE * sfx.dur);
+  const dataSize = frames * 2;
+  const buffer = Buffer.alloc(44 + dataSize);
+  buffer.write("RIFF", 0);
+  buffer.writeUInt32LE(36 + dataSize, 4);
+  buffer.write("WAVE", 8);
+  buffer.write("fmt ", 12);
+  buffer.writeUInt32LE(16, 16);
+  buffer.writeUInt16LE(1, 20);
+  buffer.writeUInt16LE(1, 22);
+  buffer.writeUInt32LE(SAMPLE_RATE, 24);
+  buffer.writeUInt32LE(SAMPLE_RATE * 2, 28);
+  buffer.writeUInt16LE(2, 32);
+  buffer.writeUInt16LE(16, 34);
+  buffer.write("data", 36);
+  buffer.writeUInt32LE(dataSize, 40);
+
+  const noise = makeNoise();
+  const state = { lp: 0, lp2: 0 };
+  for (let i = 0; i < frames; i += 1) {
+    const t = i / SAMPLE_RATE;
+    const s = Math.max(-0.98, Math.min(0.98, sfx.render(t, sfx.dur, noise, state)));
+    buffer.writeInt16LE(Math.round(s * 32767), 44 + i * 2);
+  }
+  writeFileSync(path, buffer);
+}
+
+const outDir = join(dirname(fileURLToPath(import.meta.url)), "sfx");
+spawnSync("mkdir", ["-p", outDir]);
+
+const force = process.argv.includes("--force");
+const existing = SFX.filter((s) => existsSync(join(outDir, s.file)));
+if (existing.length > 0 && !force) {
+  console.error(
+    `refusing to overwrite curated SFX (${existing.map((s) => s.file).join(", ")}). ` +
+      `These are hand-picked ElevenLabs cues (sfx/SOURCES.md); rerun with --force to replace them with the procedural fallback.`
+  );
+  process.exit(1);
+}
+
+for (const sfx of SFX) {
+  const wavPath = join(outDir, sfx.file.replace(".mp3", ".wav"));
+  const mp3Path = join(outDir, sfx.file);
+  writeWav(wavPath, sfx);
+  const result = spawnSync(
+    "ffmpeg",
+    ["-y", "-hide_banner", "-loglevel", "error", "-i", wavPath, "-af", "loudnorm=I=-23:TP=-2", "-codec:a", "libmp3lame", "-b:a", "96k", mp3Path],
+    { stdio: "inherit" }
+  );
+  if (result.error || result.status !== 0) {
+    rmSync(wavPath, { force: true });
+    rmSync(mp3Path, { force: true });
+    process.exitCode = result.status || 1;
+    break;
+  }
+  rmSync(wavPath, { force: true });
+  console.log(`wrote ${mp3Path}`);
+}

package/assets/audio/manifest.json

@@ -1,83 +1,76 @@
 [
   {
-    "file": "calm-keys.mp3",
-    "title": "Calm Keys",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#calm-keys",
+    "file": "lofi-dusk.mp3",
+    "title": "Lofi Dusk",
+    "artist": "holizna",
+    "source": "https://freesound.org/s/852231/",
     "license": "CC0",
-    "tones": ["professional"],
-    "duration": 32
+    "tones": [
+      "professional"
+    ],
+    "duration": 35,
+    "bpm": 82
   },
   {
-    "file": "steady-launch.mp3",
-    "title": "Steady Launch",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#steady-launch",
+    "file": "warm-memories.mp3",
+    "title": "Warm Memories",
+    "artist": "xkeril",
+    "source": "https://freesound.org/s/826622/",
     "license": "CC0",
-    "tones": ["professional", "technical"],
-    "duration": 32
+    "tones": [
+      "professional"
+    ],
+    "duration": 20,
+    "bpm": 108
   },
   {
-    "file": "clean-horizon.mp3",
-    "title": "Clean Horizon",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#clean-horizon",
+    "file": "neon-pulse.mp3",
+    "title": "Neon Pulse",
+    "artist": "newagesoup",
+    "source": "https://freesound.org/s/415922/",
     "license": "CC0",
-    "tones": ["professional"],
-    "duration": 32
+    "tones": [
+      "technical",
+      "playful"
+    ],
+    "duration": 17,
+    "bpm": 112
   },
   {
-    "file": "bright-sparks.mp3",
-    "title": "Bright Sparks",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#bright-sparks",
+    "file": "night-drive.mp3",
+    "title": "Night Drive",
+    "artist": "waveplaySFX",
+    "source": "https://freesound.org/s/211555/",
     "license": "CC0",
-    "tones": ["playful"],
-    "duration": 32
+    "tones": [
+      "technical"
+    ],
+    "duration": 30,
+    "bpm": 128
   },
   {
-    "file": "pixel-bounce.mp3",
-    "title": "Pixel Bounce",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#pixel-bounce",
+    "file": "sunny-bounce.mp3",
+    "title": "Sunny Bounce",
+    "artist": "mistermender",
+    "source": "https://freesound.org/s/512340/",
     "license": "CC0",
-    "tones": ["playful", "technical"],
-    "duration": 32
+    "tones": [
+      "playful"
+    ],
+    "duration": 58,
+    "bpm": 126
   },
   {
-    "file": "sunny-loop.mp3",
-    "title": "Sunny Loop",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#sunny-loop",
+    "file": "light-steps.mp3",
+    "title": "Light Steps",
+    "artist": "Jamessi",
+    "source": "https://freesound.org/s/410520/",
     "license": "CC0",
-    "tones": ["playful"],
-    "duration": 32
-  },
-  {
-    "file": "circuit-pulse.mp3",
-    "title": "Circuit Pulse",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#circuit-pulse",
-    "license": "CC0",
-    "tones": ["technical"],
-    "duration": 32
-  },
-  {
-    "file": "vector-grid.mp3",
-    "title": "Vector Grid",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#vector-grid",
-    "license": "CC0",
-    "tones": ["technical"],
-    "duration": 32
-  },
-  {
-    "file": "midnight-protocol.mp3",
-    "title": "Midnight Protocol",
-    "artist": "ReelMe procedural audio generator",
-    "source": "https://github.com/RubenGlez/reelme/blob/main/cli/assets/audio/generate-tracks.mjs#midnight-protocol",
-    "license": "CC0",
-    "tones": ["technical", "professional"],
-    "duration": 32
+    "tones": [
+      "playful",
+      "professional"
+    ],
+    "duration": 35,
+    "bpm": 110
   }
 ]

package/assets/audio/sfx/SOURCES.md

@@ -0,0 +1,16 @@
+# SFX provenance
+
+The three cue files in this directory are curated **CC0 (public domain)** cues
+from [Freesound](https://freesound.org), loudness-normalized (`loudnorm
+I=-23:TP=-2`) to sit under the bundled music beds. CC0 requires no attribution;
+the uploader credits are kept as a courtesy.
+
+| file | Freesound | uploader | role |
+|---|---|---|---|
+| `whoosh.mp3` | https://freesound.org/s/60013/ | qubodup | fast lateral cut (soft air whoosh) |
+| `pop.mp3` | https://freesound.org/s/245645/ | unfa | settle cut (clean pop) |
+| `rise.mp3` | https://freesound.org/s/523057/ | magnuswaker | CTA swell (played from 18 frames before the cut) |
+
+The peaks land where `template/src/Root.tsx` schedules each cue. If these ever
+need regenerating without Freesound, `node cli/assets/audio/generate-sfx.mjs
+--force` produces synthetic CC0 stand-ins.

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "reelme",
-  "version": "0.3.0",
-  "description": "Turn your repo into launch videos for social platforms. Local Remotion rendering, zero cloud.",
+  "version": "0.5.0",
+  "description": "Turn your repo into launch videos for social platforms. Rendered on your machine with Remotion — no accounts, no uploads.",
   "type": "module",
   "bin": {
     "reelme": "src/cli.mjs"
   },
+  "scripts": {
+    "test": "node test/smoke.mjs"
+  },
   "files": [
     "src",
     "assets",
@@ -19,6 +22,9 @@
   "engines": {
     "node": ">=18"
   },
+  "optionalDependencies": {
+    "gifsicle": "^7.0.1"
+  },
   "keywords": [
     "launch-video",
     "remotion",