feat: 100 commands milestone! Add oscilloscope, extract-stream, blackdetect (v2.3.0)

🎯 100 command milestone reached!

New commands:
- oscilloscope: Audio visualization overlay on video
- extract-stream: Extract specific stream by index (v:0, a:1, s:0)
- blackdetect: Detect black frames/scenes in video

https://claude.ai/code/session_01BPZRs1uut8bAVcEQsjWjsw

Author: omitsu-dev

.github/workflows/ci.yml

@@ -125,6 +125,9 @@ jobs:
           node bin/ffmpeg-quick.js duration test.mp4 --dry-run
           node bin/ffmpeg-quick.js sample-rate test.mp4 44100 --dry-run
           node bin/ffmpeg-quick.js bit-depth test.mp4 16 --dry-run
+          node bin/ffmpeg-quick.js oscilloscope test.mp4 --dry-run
+          node bin/ffmpeg-quick.js extract-stream test.mp4 v:0 --dry-run
+          node bin/ffmpeg-quick.js blackdetect test.mp4 --dry-run
 
       - name: Test real encode (compress a generated video)
         run: |

bin/ffmpeg-quick.js

@@ -98,13 +98,16 @@ import { register as multiAudio } from "../src/commands/multi-audio.js";
 import { register as duration } from "../src/commands/duration.js";
 import { register as sampleRate } from "../src/commands/sample-rate.js";
 import { register as bitDepth } from "../src/commands/bit-depth.js";
+import { register as oscilloscope } from "../src/commands/oscilloscope.js";
+import { register as extractStream } from "../src/commands/extract-stream.js";
+import { register as blackdetect } from "../src/commands/blackdetect.js";
 
 const program = new Command();
 
 program
   .name("ffmpeg-quick")
   .description("Quick FFmpeg presets for common video tasks")
-  .version("2.2.0");
+  .version("2.3.0");
 
 compress(program);
 gif(program);
@@ -203,5 +206,8 @@ multiAudio(program);
 duration(program);
 sampleRate(program);
 bitDepth(program);
+oscilloscope(program);
+extractStream(program);
+blackdetect(program);
 
 program.parse();

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ffmpeg-quick",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Quick FFmpeg presets for common video tasks / FFmpegプリセットCLI",
   "type": "module",
   "bin": {

src/commands/blackdetect.js

@@ -0,0 +1,17 @@
+import { run } from "../run.js";
+
+export function register(program) {
+  program
+    .command("blackdetect")
+    .description("Detect black frames / black scenes in video")
+    .argument("<input>", "Input video file")
+    .option("--threshold <n>", "Black pixel threshold (0.0-1.0)", "0.98")
+    .option("--duration <sec>", "Minimum black scene duration", "0.5")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .action((input, opts) => {
+      const filter = `blackdetect=d=${opts.duration}:pix_th=${opts.threshold}`;
+      const args = ["-i", input, "-vf", filter, "-f", "null", "-"];
+
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/extract-stream.js

@@ -0,0 +1,24 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("extract-stream")
+    .description("Extract a specific stream by index (video, audio, or subtitle)")
+    .argument("<input>", "Input media file")
+    .argument("<stream>", "Stream specifier (e.g. v:0, a:1, s: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, stream, opts) => {
+      const typeMap = { v: ".mp4", a: ".aac", s: ".srt" };
+      const type = stream.split(":")[0];
+      const ext = typeMap[type] || "";
+      const out = opts.output || outputName(input, `stream-${stream.replace(":", "")}`, ext);
+      const args = ["-i", input, "-map", `0:${stream}`, "-c", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/oscilloscope.js

@@ -0,0 +1,37 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("oscilloscope")
+    .description("Add oscilloscope overlay to video (audio visualization on video)")
+    .argument("<input>", "Input video file with audio")
+    .option("--size <n>", "Oscilloscope size (0.0-1.0)", "0.5")
+    .option("--pos <position>", "Position: top-left, top-right, bottom-left, bottom-right, center", "bottom-right")
+    .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 posMap = {
+        "top-left": "x=0:y=0",
+        "top-right": "x=1:y=0",
+        "bottom-left": "x=0:y=1",
+        "bottom-right": "x=1:y=1",
+        "center": "x=0.5:y=0.5",
+      };
+
+      const pos = posMap[opts.pos];
+      if (!pos) {
+        console.error(`Error: --pos must be one of: ${Object.keys(posMap).join(", ")}`);
+        process.exit(1);
+      }
+
+      const filter = `avectorscope=s=320x320:zoom=1.5:draw=line,format=yuva420p[osc];[0:v][osc]overlay=W*0.7:H*0.7`;
+      const out = opts.output || outputName(input, "oscilloscope");
+      const args = ["-i", input, "-filter_complex", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}