batchedits 1.5.0 → 1.7.0

package/README.md

@@ -19,14 +19,15 @@ Needs Node.js 18.17+ and a [BatchEdits](https://batchedits.com) account (7-day f
 | `login` / `logout` / `whoami` | Sign in through your browser; check the connection |
 | `styles` | List your styles |
 | `actions` | List editing actions and their settings |
-| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--crop 9:16] [--zoom] [--clips [n]] [--hook] [--hook-clip <id or words>] [--broll] [--cta [text]] [--set action.setting=value…]` | Create a style from flags |
+| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--fillers] [--crop 9:16] [--zoom] [--clips [n]] [--hook] [--hook-clip <id or words>] [--broll] [--cta [text]] [--sfx] [--set action.setting=value…]` | Create a style from flags |
 | `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 |
-| `upload <files or folders…>` | Upload up to 50 videos, print their ids |
+| `style copy <link\|file\|video id> [--name <name>]` | Create a style copying a reference video's captions, zooms and crop |
+| `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 or folders…> --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] [--yes]` | All of the above in one go |
 
 Every command has `--help` with an example, and `--json` for machine-readable output.
 
@@ -57,6 +58,12 @@ batchedits run ./raw --style "Hooks" --hooks hooks.txt --out ./edited --yes
 batchedits style create "Talking head" --silence --broll --captions
 ```
 
+`--sfx` adds sound effects to the other edits' moments: a whoosh as B-roll cuts in and on each zoom, a pop for each caption emoji, a riser into the text hook and a ding on the call to action. They sit under your voice; change it with `--set sfx.volume=low|medium|high`, or `--set sfx.zoom=impact` for a hit instead of a whoosh on zooms.
+
+```bash
+batchedits style create "Punchy" --silence --broll --captions --emojis --zoom --sfx
+```
+
 `--cta` adds a call to action over the last 3 seconds of every video ("Follow for more" unless you give your own line). For a different line per video, pass a file with `--ctas`, one per line in upload order. An outro clip played after each video is uploaded once in the dashboard's Call to action settings:
 
 ```bash
@@ -106,3 +113,14 @@ openModal({ videoUrl: "https://example.com/video.mp4", mode: "popup", onComplete
 ```
 
 MIT licensed.
+
+## Copy a style, or edit videos from links
+
+`style copy` reads a reference video (a TikTok, Reel, Short or YouTube link, a direct video link, a local file or one of your video ids) and saves its look as a style: caption font, colours, word-by-word or letter-by-letter highlight, position, zooms and crop. Only the first 90 seconds are read; colours and font are a close match.
+
+```bash
+batchedits style copy https://www.tiktok.com/@creator/video/123 --name "Like this"
+batchedits run https://youtu.be/dQw4w9WgXcQ ./raw --style "Like this" --out ./edited --yes
+```
+
+`upload` and `run` take links next to files and folders: YouTube links, or public links to a video file (direct .mp4, Dropbox, Google Drive). BatchEdits downloads them, which can take a minute for long YouTube videos.

package/dist/cli.js

@@ -298,6 +298,17 @@ var BatchEdits = class {
     }
     return body.videos[0];
   }
+  /** Uploads a video from a link (YouTube, or a public link to a video file); BatchEdits downloads it. */
+  async uploadLink(url) {
+    const res = await this.call("upload_videos", { video_url: url });
+    const video = res.videos?.[0];
+    if (!video) throw new CliError("The server didn't upload the link.", EXIT.ERROR, "It may not support links yet. Download the video and upload the file instead.");
+    return video;
+  }
+  /** Saves a new style copying a reference video's look; returns its id, name and what was copied. */
+  async copyStyle(ref, name) {
+    return this.call("copy_style", { ...ref, ...name ? { name } : {} });
+  }
   /** Streams a download link to `dir`, never overwriting an existing file. */
   async download(url, name, dir) {
     import_node_fs2.default.mkdirSync(dir, { recursive: true });
@@ -340,6 +351,22 @@ function expandFiles(inputs) {
   if (files.length > MAX_BATCH) throw new CliError(`${files.length} files: upload up to ${MAX_BATCH} at a time.`, EXIT.USAGE, "Split the folder and run once per part.");
   return files;
 }
+var isLink = (input) => /^https?:\/\//i.test(input);
+function expandInputs(inputs) {
+  const result = [];
+  for (const input of inputs) {
+    if (isLink(input)) result.push({ kind: "link", url: input });
+    else result.push(...expandFiles([input]).map((p) => ({ kind: "file", path: p })));
+  }
+  if (result.length === 0) throw new CliError("Give files, folders or video links.", EXIT.USAGE, "Example: batchedits upload ./raw https://youtu.be/\u2026");
+  if (result.length > MAX_BATCH) throw new CliError(`${result.length} videos: upload up to ${MAX_BATCH} at a time.`, EXIT.USAGE, "Split them and run once per part.");
+  return result;
+}
+var inputLabel = (input) => input.kind === "link" ? input.url : import_node_path3.default.basename(input.path);
+async function uploadInput(api, input, i, total) {
+  info(`${input.kind === "link" ? "Importing" : "Uploading"} ${i + 1}/${total}: ${inputLabel(input)}${input.kind === "link" ? " (links can take a minute)" : ""}`);
+  return input.kind === "link" ? api.uploadLink(input.url) : api.upload(input.path);
+}
 async function resolveStyle(api, ref) {
   if (typeof ref !== "string" || !ref) throw new CliError("--style is required.", EXIT.USAGE, "List them with: batchedits styles");
   const styles = await api.styles();
@@ -355,7 +382,7 @@ async function confirm(flags, question) {
   rl.close();
   if (answer !== "y" && answer !== "yes") throw new CliError("Cancelled. Nothing was processed.", EXIT.ERROR);
 }
-var ACTION_ORDER = ["crop_video", "remove_silence", "remove_repeated_sentences", "broll", "add_captions", "punch_zoom", "ai_clips", "hook", "cta"];
+var ACTION_ORDER = ["crop_video", "remove_silence", "remove_repeated_sentences", "broll", "add_captions", "punch_zoom", "ai_clips", "hook", "cta", "sound_effects"];
 var ACTION_ALIASES = {
   crop: "crop_video",
   silence: "remove_silence",
@@ -365,15 +392,17 @@ var ACTION_ALIASES = {
   clips: "ai_clips",
   hook: "hook",
   cta: "cta",
-  broll: "broll"
+  broll: "broll",
+  sfx: "sound_effects"
 };
 var SET_HELP = [
   "  --set <action.setting=value>  Any setting from `batchedits actions` (repeatable). Adds the edit if missing.",
   "                  captions.position=top|center|bottom  captions.fontColor=#FFFFFF  captions.highlightColor=#FF6B00",
-  "                  captions.fontSize=64  silence.silentThreshold=0.06  zoom.zoomPercent=125  clips.maxSeconds=60",
+  "                  captions.fontSize=64  silence.silentThreshold=0.06  silence.fillerWords=true  zoom.zoomPercent=125  clips.maxSeconds=60",
   "                  hook.position=top|center|bottom  hook.y=0.3  hook.duration=auto|3  hook.source=ai|manual  hook.animation=fade|pop|none  hook.backgroundColor=#FF6B00",
   '                  cta.text="Link in bio"  cta.duration=auto|5  cta.position=center|top|bottom  cta.animation=pop|fade|none',
-  "                  broll.seconds=auto|3  broll.source=mine_first|mine|stock"
+  "                  broll.seconds=auto|3  broll.source=mine_first|mine|stock",
+  "                  sfx.volume=low|medium|high  sfx.zoom=whoosh|impact|off  sfx.emojis=false  sfx.hook=false  sfx.cta=false  sfx.broll=false"
 ].join("\n");
 var actionName = (raw) => ACTION_ALIASES[raw.trim().toLowerCase()] ?? raw.trim().toLowerCase();
 var list = (v) => Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
@@ -386,7 +415,7 @@ function upsert(actions, name, params) {
 function applyFlagActions(actions, flags) {
   let out = actions;
   if (typeof flags.crop === "string") out = upsert(out, "crop_video", { aspectRatio: flags.crop });
-  if (flags.silence) out = upsert(out, "remove_silence");
+  if (flags.silence || flags.fillers) out = upsert(out, "remove_silence", flags.fillers ? { fillerWords: true } : void 0);
   if (flags.repeats) out = upsert(out, "remove_repeated_sentences");
   if (flags.captions || flags.emojis) out = upsert(out, "add_captions", flags.emojis ? { emojis: true } : void 0);
   if (flags.zoom) out = upsert(out, "punch_zoom");
@@ -399,6 +428,7 @@ function applyFlagActions(actions, flags) {
     out = upsert(out, "hook");
   }
   if (flags.broll) out = upsert(out, "broll");
+  if (flags.sfx) out = upsert(out, "sound_effects");
   if (flags.cta) out = upsert(out, "cta", typeof flags.cta === "string" && flags.cta.trim() ? { text: flags.cta.trim() } : void 0);
   return out;
 }
@@ -566,13 +596,14 @@ var commands = {
   },
   "style create": {
     summary: "Create a style from simple flags",
-    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--hook] [--broll] [--cta [text]] [--set action.setting=value\u2026]",
+    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--fillers] [--hook] [--broll] [--cta [text]] [--sfx] [--set action.setting=value\u2026]",
     help: [
       "Creates a reusable style. Order of edits: crop, silence, repeats, captions, zoom, AI clips.",
       "  --captions      Auto captions (word-by-word highlight)",
       "  --emojis        Add AI-picked emojis to the captions",
       "  --silence       Remove silences and dead air",
       "  --repeats       Remove repeated takes of the same sentence",
+      '  --fillers       Also cut filler words (um, uh, filler "like" / "you know"); turns on --silence',
       "  --crop <ratio>  Crop every video, e.g. 9:16, 1:1, 4:5",
       "  --zoom          Zoom in on key moments",
       "  --clips [n]     Cut long videos into n short clips (default 10; 1 credit per clip)",
@@ -582,6 +613,7 @@ var commands = {
       "                  With --hook too, the text hook is drawn on the clip.",
       "  --broll         Cut away to your B-roll while you talk about what it shows (name clips in the dashboard's Library)",
       `  --cta [text]    A call to action in each video's last seconds (default "Follow for more"; pass --ctas to run/process for one per video)`,
+      "  --sfx           Sound effects on the other edits: whoosh on B-roll and zooms, pop on emojis, riser into the hook, ding on the CTA",
       SET_HELP,
       'Example: batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom --set captions.position=center',
       'Example: batchedits style create "Hooks" --captions --hook --set hook.position=top --set hook.duration=3',
@@ -639,16 +671,51 @@ Use it with: --style "${name}"`);
       return EXIT.OK;
     }
   },
+  "style copy": {
+    summary: "Create a style that copies a video's look",
+    usage: "batchedits style copy <link|file|video id> [--name <name>]",
+    help: [
+      "Reads a reference video's captions (font, colours, word or letter highlight, position), zooms and crop, and saves them as a new style.",
+      "The reference is a YouTube, TikTok, Instagram, X or Vimeo link, a direct link to a video file, a local file (uploaded first), or the id of one of your videos.",
+      "Only the first 90 seconds are read. Colours and font are a close match. Uses no credits; up to 10 copies a day.",
+      "  --name <name>  Name for the new style (default: one based on the look)",
+      'Example: batchedits style copy https://www.tiktok.com/@creator/video/123 --name "Like this"',
+      'Example: batchedits style copy ./reference.mp4 && batchedits run ./raw --style "Like this" --yes'
+    ].join("\n"),
+    async run({ api, positionals, flags }) {
+      const ref = positionals.join(" ").trim();
+      if (!ref) throw new CliError("Give a reference video: a link, a file or a video id.", EXIT.USAGE, "Example: batchedits style copy https://youtu.be/\u2026");
+      const name = typeof flags.name === "string" && flags.name.trim() ? flags.name.trim() : void 0;
+      let source;
+      if (isLink(ref)) source = { video_url: ref };
+      else if (import_node_fs3.default.existsSync(ref) && import_node_fs3.default.statSync(ref).isFile()) {
+        info(`Uploading ${import_node_path3.default.basename(ref)}\u2026`);
+        source = { video_id: (await api.upload(ref)).id };
+      } else if (/^[0-9a-f-]{8,64}$/i.test(ref)) source = { video_id: ref };
+      else throw new CliError(`No such file, link or video id: ${ref}`, EXIT.USAGE, "Give a link (https://\u2026), a local video file, or an id from: batchedits status");
+      info("Reading the reference video's style (about 20-60 seconds)\u2026");
+      const res = await api.copyStyle(source, name);
+      if (!res.styleId) throw new CliError("The server didn't create the style.", EXIT.ERROR, "It may not support copying styles yet. Use: batchedits style create");
+      if (isJson()) printJson({ styleId: res.styleId, name: res.name, summary: res.summary ?? [] });
+      else {
+        say(`Created style "${res.name}" (${res.styleId}).`);
+        for (const line of res.summary ?? []) say(`  \u2022 ${line}`);
+        say(`Colours and font are a close match.
+Use it with: --style "${res.name}"`);
+      }
+      return EXIT.OK;
+    }
+  },
   upload: {
-    summary: "Upload local videos (up to 50)",
-    usage: "batchedits upload <files or folders\u2026>",
-    help: "Uploads videos or audio and prints their ids. A folder uploads the media files inside it.\nExample: batchedits upload ./raw",
+    summary: "Upload videos from files, folders or links (up to 50)",
+    usage: "batchedits upload <files, folders or links\u2026>",
+    help: "Uploads videos or audio and prints their ids. A folder uploads the media files inside it. A link (YouTube, or a public link to a video file such as Dropbox or Google Drive) is downloaded by BatchEdits.\nExample: batchedits upload ./raw https://youtu.be/dQw4w9WgXcQ",
     async run({ api, positionals }) {
-      const files = expandFiles(positionals);
+      const inputs = expandInputs(positionals);
       const uploaded = [];
-      for (let i = 0; i < files.length; i++) {
-        info(`Uploading ${i + 1}/${files.length}: ${import_node_path3.default.basename(files[i])}`);
-        uploaded.push({ ...await api.upload(files[i]), file: files[i] });
+      for (let i = 0; i < inputs.length; i++) {
+        const input = inputs[i];
+        uploaded.push({ ...await uploadInput(api, input, i, inputs.length), file: input.kind === "link" ? input.url : input.path });
       }
       if (isJson()) printJson({ videos: uploaded });
       else {
@@ -723,21 +790,18 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
   },
   run: {
     summary: "Upload, edit, wait and download in one go",
-    usage: "batchedits run <files or folders\u2026> --style <name|id> [--out ./edited] [--hooks <file>] [--ctas <file>] [--yes]",
-    help: 'Uploads up to 50 videos, 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>] [--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',
     async run(ctx) {
       const { api, positionals, flags } = ctx;
-      const files = expandFiles(positionals);
+      const inputs = expandInputs(positionals);
       const style = await resolveStyle(api, flags.style);
-      const hooks = readLinesFile(flags.hooks, style, files.length, "hook");
-      const ctas = readLinesFile(flags.ctas, style, files.length, "cta");
+      const hooks = readLinesFile(flags.hooks, style, inputs.length, "hook");
+      const ctas = readLinesFile(flags.ctas, style, inputs.length, "cta");
       const clips = (style.actions ?? []).some((a) => a.name === "ai_clips");
-      await confirm(flags, `Edit ${files.length} video${files.length === 1 ? "" : "s"} with "${style.name}"? This uses ${files.length} credit${files.length === 1 ? "" : "s"}${clips ? ", plus 1 per AI clip" : ""}.`);
+      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 < files.length; i++) {
-        info(`Uploading ${i + 1}/${files.length}: ${import_node_path3.default.basename(files[i])}`);
-        ids.push((await api.upload(files[i])).id);
-      }
+      for (let i = 0; i < inputs.length; i++) ids.push((await uploadInput(api, inputs[i], i, inputs.length)).id);
       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);
@@ -754,7 +818,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.5.0" : "dev";
+var VERSION = true ? "1.7.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -769,6 +833,7 @@ var FLAG_OPTIONS = {
   emojis: { type: "boolean" },
   silence: { type: "boolean" },
   repeats: { type: "boolean" },
+  fillers: { type: "boolean" },
   crop: { type: "string" },
   zoom: { type: "boolean" },
   clips: { type: "string" },
@@ -777,6 +842,7 @@ var FLAG_OPTIONS = {
   hooks: { type: "string" },
   cta: { type: "string" },
   broll: { type: "boolean" },
+  sfx: { type: "boolean" },
   ctas: { type: "string" },
   set: { type: "string", multiple: true },
   remove: { type: "string", multiple: true },
@@ -800,7 +866,9 @@ function mainHelp() {
     "  batchedits login",
     '  batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom',
     '  batchedits style edit "Shorts" --set captions.position=center',
+    '  batchedits style copy https://www.tiktok.com/@creator/video/123 --name "Like this"',
     '  batchedits run ./raw --style "Shorts" --out ./edited',
+    '  batchedits run https://youtu.be/dQw4w9WgXcQ ./raw --style "Shorts" --yes',
     "",
     "Exit codes: 0 ok \xB7 1 error \xB7 2 usage \xB7 3 sign in needed \xB7 4 some videos failed \xB7 5 needs --yes"
   ].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batchedits",
-  "version": "1.5.0",
+  "version": "1.7.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",