batchedits 1.7.0 → 1.8.0

package/README.md

@@ -23,11 +23,13 @@ Needs Node.js 18.17+ and a [BatchEdits](https://batchedits.com) account (7-day f
 | `hooks [words]` | Find intro clips for a video hook |
 | `style edit <name> [same flags] [--set …] [--remove <action>…] [--name <new>]` | Change a saved style's edits and settings |
 | `style copy <link\|file\|video id> [--name <name>]` | Create a style copying a reference video's captions, zooms and crop |
+| `captions <video id>` | Show a video's caption text word by word, to check names and spelling |
+| `captions fix <video id> --replace "wrong=right"… [--word "<id>=text"…]` | Fix caption words before editing (no credit) |
 | `upload <files, folders or links…>` | Upload up to 50 videos (YouTube or video-file links are downloaded by BatchEdits), print their ids |
 | `process <ids…> --style <name> [--yes]` | Edit videos (1 credit each, 1 per AI clip) |
 | `status [ids…] [--watch]` | Show status, or wait until done |
 | `download <ids…> [--out dir]` | Save finished videos (and their AI clips) |
-| `run <files, folders or links…> --style <name> [--out dir] [--hooks file] [--ctas file] [--yes]` | All of the above in one go |
+| `run <files, folders or links…> --style <name> [--out dir] [--hooks file] [--ctas file] [--fix "wrong=right"…] [--yes]` | All of the above in one go |
 
 Every command has `--help` with an example, and `--json` for machine-readable output.
 
@@ -35,6 +37,18 @@ Every command has `--help` with an example, and `--json` for machine-readable ou
 
 `--set action.setting=value` sets anything `batchedits actions` lists. Short action names: `captions`, `silence`, `crop`, `zoom`, `clips`, `repeats`, `hook`.
 
+### Fix caption words
+
+Captions are transcribed automatically; fix names or brand spellings before the edit (no extra credit):
+
+```bash
+batchedits captions 3f2a…                                   # check the words
+batchedits captions fix 3f2a… --replace "BatchEdit=BatchEdits"
+batchedits run ./raw --style "Shorts" --fix "BatchEdit=BatchEdits" --yes   # every video in one go
+```
+
+Fixes apply before processing only; a finished video keeps its captions.
+
 ### Hooks
 
 `--hook-clip` plays a short intro clip (a video hook) before every video. `--hook-clip ai` lets AI pick a different matching clip for each video. To use one clip for all of them, find it with `batchedits hooks <words>`, then pass its id, or just the words for the best match. With `--hook` too, the text hook is drawn on the clip:

package/dist/cli.js

@@ -523,6 +523,40 @@ async function downloadAll(api, videos, out) {
   }
   return { saved, notReady: res.notReady ?? [] };
 }
+function parsePairs(value, flag) {
+  const list2 = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
+  return list2.map((raw) => {
+    const at = String(raw).indexOf("=");
+    const find = at < 0 ? "" : String(raw).slice(0, at).trim();
+    const replace = at < 0 ? "" : String(raw).slice(at + 1).trim();
+    if (!find || !replace) throw new CliError(`${flag} "${raw}" needs the form "wrong=right".`, EXIT.USAGE, `Example: ${flag} "BatchEdit=BatchEdits"`);
+    return { find, replace };
+  });
+}
+function parseWords(value) {
+  return parsePairs(value, "--word").map((p) => ({ wordId: p.find, text: p.replace }));
+}
+async function waitForCaptions(api, videoId, timeoutSec = 900) {
+  const until = Date.now() + timeoutSec * 1e3;
+  let said = false;
+  for (; ; ) {
+    const r = await api.call("get_captions", { videoId });
+    if (r.status === "ready") return r;
+    if (r.status === "failed") throw new CliError(r.message, EXIT.ERROR);
+    if (Date.now() > until) throw new CliError(`Captions for ${videoId} weren't ready after ${Math.round(timeoutSec / 60)} minutes.`, EXIT.ERROR, `Try again later: batchedits captions ${videoId}`);
+    if (!said) info(r.message);
+    said = true;
+    await new Promise((resolve) => setTimeout(resolve, 5e3));
+  }
+}
+async function fixCaptions(api, videoId, replacements, words = []) {
+  await waitForCaptions(api, videoId);
+  return api.call("edit_captions", {
+    videoId,
+    ...replacements.length ? { replacements } : {},
+    ...words.length ? { words } : {}
+  });
+}
 var commands = {
   login: {
     summary: "Sign in through your browser",
@@ -756,6 +790,37 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
       return results.some((r) => r.error) ? EXIT.PARTIAL : EXIT.OK;
     }
   },
+  captions: {
+    summary: "Show a video's caption text, to check spelling",
+    usage: "batchedits captions <video id>",
+    help: `Prints the video's captions word by word as text(id), with times. Transcription starts if it hasn't run, and this waits for it (about a minute).
+Fix words with: batchedits captions fix <video id> --replace "wrong=right"
+Example: batchedits captions 3f2a\u2026`,
+    async run({ api, positionals }) {
+      const videoId = positionals[0];
+      if (!videoId) throw new CliError("Give the video id.", EXIT.USAGE, "Find it with: batchedits status");
+      const r = await waitForCaptions(api, videoId);
+      if (isJson()) printJson({ videoId, words: r.words ?? [] });
+      else say(r.message);
+      return EXIT.OK;
+    }
+  },
+  "captions fix": {
+    summary: "Fix caption words before editing (no credit)",
+    usage: 'batchedits captions fix <video id> --replace "wrong=right"\u2026 [--word "<id>=text"\u2026]',
+    help: 'Corrects caption text before the video is edited, like Edit captions in the editor. Uses no credit: the fixes go into the next edit.\n  --replace "wrong=right"  Replace everywhere (ignores case, keeps punctuation). Repeatable. A phrase needs the same number of words as its replacement.\n  --word "<id>=text"      Change one word, by the id `batchedits captions` shows. Repeatable.\nOnly before processing: a finished video can\'t have its captions fixed.\nExample: batchedits captions fix 3f2a\u2026 --replace "BatchEdit=BatchEdits" --replace "mike=Mike"',
+    async run({ api, positionals, flags }) {
+      const videoId = positionals[0];
+      if (!videoId) throw new CliError("Give the video id.", EXIT.USAGE, "Find it with: batchedits status");
+      const replacements = parsePairs(flags.replace, "--replace");
+      const words = parseWords(flags.word);
+      if (!replacements.length && !words.length) throw new CliError("Give --replace or --word.", EXIT.USAGE, 'Example: batchedits captions fix 3f2a\u2026 --replace "BatchEdit=BatchEdits"');
+      const r = await fixCaptions(api, videoId, replacements, words);
+      if (isJson()) printJson({ videoId, changed: r.changed, message: r.message });
+      else say(r.message);
+      return EXIT.OK;
+    }
+  },
   status: {
     summary: "Show video status (or --watch until done)",
     usage: "batchedits status [video ids\u2026] [--watch] [--interval 10]",
@@ -790,18 +855,28 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
   },
   run: {
     summary: "Upload, edit, wait and download in one go",
-    usage: "batchedits run <files, folders or links\u2026> --style <name|id> [--out ./edited] [--hooks <file>] [--ctas <file>] [--yes]",
-    help: 'Uploads up to 50 videos (files, folders, or YouTube and video-file links), edits them with the style, waits, and downloads the results.\n  --hooks <file>  One hook per line, in upload order (a folder uploads its files A-Z), for styles with a hook\n  --ctas <file>   One call to action per line, same order, for styles with a cta\nExample: batchedits run ./raw --style "Shorts" --out ./edited --yes',
+    usage: 'batchedits run <files, folders or links\u2026> --style <name|id> [--out ./edited] [--hooks <file>] [--ctas <file>] [--fix "wrong=right"\u2026] [--yes]',
+    help: 'Uploads up to 50 videos (files, folders, or YouTube and video-file links), edits them with the style, waits, and downloads the results.\n  --hooks <file>         One hook per line, in upload order (a folder uploads its files A-Z), for styles with a hook\n  --ctas <file>          One call to action per line, same order, for styles with a cta\n  --fix "wrong=right"    Fix a caption word in every video before editing (waits for transcription first). Repeatable, no extra credit.\nExample: batchedits run ./raw --style "Shorts" --out ./edited --fix "BatchEdit=BatchEdits" --yes',
     async run(ctx) {
       const { api, positionals, flags } = ctx;
       const inputs = expandInputs(positionals);
       const style = await resolveStyle(api, flags.style);
       const hooks = readLinesFile(flags.hooks, style, inputs.length, "hook");
       const ctas = readLinesFile(flags.ctas, style, inputs.length, "cta");
+      const fixes = parsePairs(flags.fix, "--fix");
       const clips = (style.actions ?? []).some((a) => a.name === "ai_clips");
       await confirm(flags, `Edit ${inputs.length} video${inputs.length === 1 ? "" : "s"} with "${style.name}"? This uses ${inputs.length} credit${inputs.length === 1 ? "" : "s"}${clips ? ", plus 1 per AI clip" : ""}.`);
       const ids = [];
       for (let i = 0; i < inputs.length; i++) ids.push((await uploadInput(api, inputs[i], i, inputs.length)).id);
+      if (fixes.length) {
+        for (const videoId of ids) {
+          try {
+            info((await fixCaptions(api, videoId, fixes)).message);
+          } catch (err) {
+            info(`Captions of ${videoId} unchanged: ${err?.message ?? err}`);
+          }
+        }
+      }
       for (const [i, videoId] of ids.entries()) await api.call("process_video", { videoId, styleId: style.id, ...perVideoText(hooks, ctas, i) });
       info(`Editing ${ids.length} video${ids.length === 1 ? "" : "s"} with "${style.name}"\u2026`);
       const group = await watch(api, ids, Number(flags.interval) || 10);
@@ -818,7 +893,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.7.0" : "dev";
+var VERSION = true ? "1.8.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -846,7 +921,10 @@ var FLAG_OPTIONS = {
   ctas: { type: "string" },
   set: { type: "string", multiple: true },
   remove: { type: "string", multiple: true },
-  name: { type: "string" }
+  name: { type: "string" },
+  replace: { type: "string", multiple: true },
+  word: { type: "string", multiple: true },
+  fix: { type: "string", multiple: true }
 };
 function mainHelp() {
   const names = Object.keys(commands);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batchedits",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "BatchEdits CLI, SDK and React widgets: edit up to 50 videos at once from your terminal or AI agent (Claude Code, OpenClaw, Hermes)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",