feat: add 10 new commands — equalize, stack, detect-silence, extract-subtitle, audio-delay, deflicker, noise, vintage, zoom, interpolate (v1.8.0)

omitsu-dev · claude · commit f689e4703c5b · 2026-04-04T03:13:18.000Z
New commands: - equalize: Auto-correct colors via histogram equalization - stack: Side-by-side or top/bottom two videos - detect-silence: Find silent sections in audio/video - extract-subtitle: Extract subtitle track as .srt file - audio-delay: Fix audio sync by delaying/advancing audio - deflicker: Remove flicker from timelapse videos - noise: Add film grain/noise for cinematic look - vintage: Retro film effect (sepia + grain + vignette) - zoom: Ken Burns style zoom and pan - interpolate: Frame interpolation for smooth slow motion https://claude.ai/code/session_01BPZRs1uut8bAVcEQsjWjsw
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -84,6 +84,16 @@ jobs:
           node bin/ffmpeg-quick.js tile test.mp4 --dry-run
           node bin/ffmpeg-quick.js metadata test.mp4 --title Test --dry-run
           node bin/ffmpeg-quick.js drawbox test.mp4 100:50:200:150 --dry-run
+          node bin/ffmpeg-quick.js equalize test.mp4 --dry-run
+          node bin/ffmpeg-quick.js stack test.mp4 test.mp4 --dry-run
+          node bin/ffmpeg-quick.js detect-silence test.mp4 --dry-run
+          node bin/ffmpeg-quick.js extract-subtitle test.mp4 --dry-run
+          node bin/ffmpeg-quick.js audio-delay test.mp4 500 --dry-run
+          node bin/ffmpeg-quick.js deflicker test.mp4 --dry-run
+          node bin/ffmpeg-quick.js noise test.mp4 --dry-run
+          node bin/ffmpeg-quick.js vintage test.mp4 --dry-run
+          node bin/ffmpeg-quick.js zoom test.mp4 --dry-run
+          node bin/ffmpeg-quick.js interpolate test.mp4 60 --dry-run
 
       - name: Test real encode (compress a generated video)
         run: |
@@ -123,3 +133,8 @@ jobs:
           node bin/ffmpeg-quick.js metadata test-input.mp4 --title "Test Video" -y
           node bin/ffmpeg-quick.js drawbox test-input.mp4 10:10:100:80 -y
           node bin/ffmpeg-quick.js crossfade test-input.mp4 test-input.mp4 0.5 -y
+          node bin/ffmpeg-quick.js equalize test-input.mp4 -y
+          node bin/ffmpeg-quick.js stack test-input.mp4 test-input.mp4 -y
+          node bin/ffmpeg-quick.js deflicker test-input.mp4 -y
+          node bin/ffmpeg-quick.js noise test-input.mp4 -y
+          node bin/ffmpeg-quick.js vintage test-input.mp4 -y
diff --git a/bin/ffmpeg-quick.js b/bin/ffmpeg-quick.js
@@ -57,13 +57,23 @@ import { register as crossfade } from "../src/commands/crossfade.js";
 import { register as tile } from "../src/commands/tile.js";
 import { register as metadata } from "../src/commands/metadata.js";
 import { register as drawbox } from "../src/commands/drawbox.js";
+import { register as equalize } from "../src/commands/equalize.js";
+import { register as stack } from "../src/commands/stack.js";
+import { register as detectSilence } from "../src/commands/detect-silence.js";
+import { register as extractSubtitle } from "../src/commands/extract-subtitle.js";
+import { register as audioDelay } from "../src/commands/audio-delay.js";
+import { register as deflicker } from "../src/commands/deflicker.js";
+import { register as noise } from "../src/commands/noise.js";
+import { register as vintage } from "../src/commands/vintage.js";
+import { register as zoom } from "../src/commands/zoom.js";
+import { register as interpolate } from "../src/commands/interpolate.js";
 
 const program = new Command();
 
 program
   .name("ffmpeg-quick")
   .description("Quick FFmpeg presets for common video tasks")
-  .version("1.7.0");
+  .version("1.8.0");
 
 compress(program);
 gif(program);
@@ -121,5 +131,15 @@ crossfade(program);
 tile(program);
 metadata(program);
 drawbox(program);
+equalize(program);
+stack(program);
+detectSilence(program);
+extractSubtitle(program);
+audioDelay(program);
+deflicker(program);
+noise(program);
+vintage(program);
+zoom(program);
+interpolate(program);
 
 program.parse();
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ffmpeg-quick",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Quick FFmpeg presets for common video tasks / FFmpegプリセットCLI",
   "type": "module",
   "bin": {
diff --git a/src/commands/audio-delay.js b/src/commands/audio-delay.js
@@ -0,0 +1,35 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("audio-delay")
+    .description("Delay or advance audio track (fix audio sync)")
+    .argument("<input>", "Input video file")
+    .argument("<ms>", "Delay in milliseconds (positive = delay audio, negative = advance)")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, ms, opts) => {
+      const delay = parseInt(ms, 10);
+      if (isNaN(delay)) {
+        console.error("Error: delay must be a number in milliseconds.");
+        process.exit(1);
+      }
+
+      const out = opts.output || outputName(input, "synced");
+      const args = ["-i", input];
+
+      if (delay >= 0) {
+        args.push("-af", `adelay=${delay}|${delay}`, "-c:v", "copy");
+      } else {
+        // Negative = advance audio by trimming the start
+        const trimSec = Math.abs(delay) / 1000;
+        args.push("-af", `atrim=start=${trimSec},asetpts=PTS-STARTPTS`, "-c:v", "copy");
+      }
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/deflicker.js b/src/commands/deflicker.js
@@ -0,0 +1,21 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("deflicker")
+    .description("Remove flicker from video (useful for timelapse)")
+    .argument("<input>", "Input video file")
+    .option("--size <n>", "Averaging window size (must be odd)", "5")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      const out = opts.output || outputName(input, "deflickered");
+      const args = ["-i", input, "-vf", `deflicker=size=${opts.size}`, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/detect-silence.js b/src/commands/detect-silence.js
@@ -0,0 +1,17 @@
+import { run } from "../run.js";
+
+export function register(program) {
+  program
+    .command("detect-silence")
+    .description("Detect silent sections in audio/video")
+    .argument("<input>", "Input video/audio file")
+    .option("--threshold <dB>", "Silence threshold in dB", "-30")
+    .option("--duration <sec>", "Minimum silence duration in seconds", "2")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .action((input, opts) => {
+      const filter = `silencedetect=noise=${opts.threshold}dB:d=${opts.duration}`;
+      const args = ["-i", input, "-af", filter, "-f", "null", "-"];
+
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/equalize.js b/src/commands/equalize.js
@@ -0,0 +1,20 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("equalize")
+    .description("Auto-correct colors with histogram equalization")
+    .argument("<input>", "Input video file")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      const out = opts.output || outputName(input, "equalized");
+      const args = ["-i", input, "-vf", "histeq", "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/extract-subtitle.js b/src/commands/extract-subtitle.js
@@ -0,0 +1,21 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("extract-subtitle")
+    .description("Extract subtitle track from video as .srt file")
+    .argument("<input>", "Input video file")
+    .option("--stream <n>", "Subtitle stream index", "0")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      const out = opts.output || outputName(input, "sub", ".srt");
+      const args = ["-i", input, "-map", `0:s:${opts.stream}`, "-c:s", "srt"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/interpolate.js b/src/commands/interpolate.js
@@ -0,0 +1,23 @@
+import { run } from "../run.js";
+import { outputName, parsePositiveNumber } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("interpolate")
+    .description("Frame interpolation for smooth slow motion")
+    .argument("<input>", "Input video file")
+    .argument("<target-fps>", "Target frame rate (e.g. 60, 120)")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, targetFps, opts) => {
+      const fps = parsePositiveNumber(targetFps, "target FPS");
+      const filter = `minterpolate=fps=${fps}:mi_mode=mci:mc_mode=aobmc:me_mode=bidir:vsbmc=1`;
+      const out = opts.output || outputName(input, `${fps}fps-interp`);
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/noise.js b/src/commands/noise.js
@@ -0,0 +1,24 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("noise")
+    .description("Add film grain / noise to video")
+    .argument("<input>", "Input video file")
+    .option("--strength <n>", "Noise intensity (1-100)", "20")
+    .option("--type <type>", "Noise type: uniform or gaussian", "gaussian")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      const flags = opts.type === "uniform" ? "u" : "a";
+      const filter = `noise=alls=${opts.strength}:allf=t+${flags}`;
+      const out = opts.output || outputName(input, "noisy");
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/stack.js b/src/commands/stack.js
@@ -0,0 +1,37 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("stack")
+    .description("Stack two videos side by side or top/bottom")
+    .argument("<input1>", "First video file")
+    .argument("<input2>", "Second video file")
+    .option("--direction <dir>", "Stack direction: horizontal or vertical", "horizontal")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input1, input2, opts) => {
+      let filter;
+      if (opts.direction === "horizontal") {
+        filter = "[0:v][1:v]hstack=inputs=2";
+      } else if (opts.direction === "vertical") {
+        filter = "[0:v][1:v]vstack=inputs=2";
+      } else {
+        console.error("Error: --direction must be horizontal or vertical.");
+        process.exit(1);
+      }
+
+      const out = opts.output || outputName(input1, "stacked");
+      const args = [
+        "-i", input1,
+        "-i", input2,
+        "-filter_complex", filter,
+        "-c:a", "copy",
+      ];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/vintage.js b/src/commands/vintage.js
@@ -0,0 +1,28 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("vintage")
+    .description("Apply vintage / retro film effect")
+    .argument("<input>", "Input video file")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      // Combine: slight sepia tone + reduced saturation + vignette + grain
+      const filter = [
+        "colorchannelmixer=.35:.75:.20:0:.30:.65:.17:0:.25:.50:.13:0",
+        "eq=saturation=0.7:contrast=1.1:brightness=0.02",
+        "vignette=angle=PI/4",
+        "noise=alls=15:allf=t+a",
+      ].join(",");
+
+      const out = opts.output || outputName(input, "vintage");
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}
diff --git a/src/commands/zoom.js b/src/commands/zoom.js
@@ -0,0 +1,32 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("zoom")
+    .description("Apply Ken Burns style zoom and pan effect")
+    .argument("<input>", "Input video file")
+    .option("--direction <dir>", "Zoom direction: in or out", "in")
+    .option("--speed <n>", "Zoom speed (0.001-0.01, lower=slower)", "0.002")
+    .option("-o, --output <path>", "Output file path")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((input, opts) => {
+      let filter;
+      if (opts.direction === "in") {
+        filter = `scale=8000:-1,zoompan=z='min(zoom+${opts.speed},1.5)':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':s=1920x1080:fps=30`;
+      } else if (opts.direction === "out") {
+        filter = `scale=8000:-1,zoompan=z='if(eq(on,1),1.5,max(zoom-${opts.speed},1))':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':s=1920x1080:fps=30`;
+      } else {
+        console.error("Error: --direction must be in or out.");
+        process.exit(1);
+      }
+
+      const out = opts.output || outputName(input, `zoom-${opts.direction}`);
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "ffmpeg-quick",`
`3`		`- "version": "1.7.0",`
	`3`	`+ "version": "1.8.0",`
`4`	`4`	`"description": "Quick FFmpeg presets for common video tasks / FFmpegプリセットCLI",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"bin": {`