feat: add 6 new commands — motion-blur, border, multi-audio, duration, sample-rate, bit-depth (v2.2.0)

97 total commands!

New commands:
- motion-blur: Temporal motion blur effect
- border: Decorative border/frame around video
- multi-audio: Add multiple audio tracks (multilingual)
- duration: Show media file duration
- sample-rate: Change audio sample rate
- bit-depth: Change audio bit depth (16/24/32)

https://claude.ai/code/session_01BPZRs1uut8bAVcEQsjWjsw

Author: omitsu-dev

.github/workflows/ci.yml

@@ -119,6 +119,12 @@ jobs:
           node bin/ffmpeg-quick.js progress test.mp4 10 --dry-run
           node bin/ffmpeg-quick.js backdrop test.mp4 --dry-run
           node bin/ffmpeg-quick.js count-frames test.mp4 --dry-run
+          node bin/ffmpeg-quick.js motion-blur test.mp4 --dry-run
+          node bin/ffmpeg-quick.js border test.mp4 --dry-run
+          node bin/ffmpeg-quick.js multi-audio test.mp4 test.mp3 --dry-run
+          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
 
       - name: Test real encode (compress a generated video)
         run: |
@@ -176,3 +182,6 @@ jobs:
           node bin/ffmpeg-quick.js backdrop test-input.mp4 --size 640x480 -y
           node bin/ffmpeg-quick.js gif-to-video test-input-gif.gif -y
           node bin/ffmpeg-quick.js count-frames test-input.mp4
+          node bin/ffmpeg-quick.js motion-blur test-input.mp4 -y
+          node bin/ffmpeg-quick.js border test-input.mp4 -y
+          node bin/ffmpeg-quick.js duration test-input.mp4

bin/ffmpeg-quick.js

@@ -92,13 +92,19 @@ import { register as gifToVideo } from "../src/commands/gif-to-video.js";
 import { register as progress } from "../src/commands/progress.js";
 import { register as backdrop } from "../src/commands/backdrop.js";
 import { register as countFrames } from "../src/commands/count-frames.js";
+import { register as motionBlur } from "../src/commands/motion-blur.js";
+import { register as border } from "../src/commands/border.js";
+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";
 
 const program = new Command();
 
 program
   .name("ffmpeg-quick")
   .description("Quick FFmpeg presets for common video tasks")
-  .version("2.1.0");
+  .version("2.2.0");
 
 compress(program);
 gif(program);
@@ -191,5 +197,11 @@ gifToVideo(program);
 progress(program);
 backdrop(program);
 countFrames(program);
+motionBlur(program);
+border(program);
+multiAudio(program);
+duration(program);
+sampleRate(program);
+bitDepth(program);
 
 program.parse();

package.json

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

src/commands/bit-depth.js

@@ -0,0 +1,33 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("bit-depth")
+    .description("Change audio bit depth (16, 24, 32)")
+    .argument("<input>", "Input video/audio file")
+    .argument("<bits>", "Target bit depth: 16, 24, or 32")
+    .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, bits, opts) => {
+      const formatMap = {
+        "16": "s16",
+        "24": "s24",
+        "32": "s32",
+      };
+
+      const fmt = formatMap[bits];
+      if (!fmt) {
+        console.error("Error: bit depth must be 16, 24, or 32.");
+        process.exit(1);
+      }
+
+      const out = opts.output || outputName(input, `${bits}bit`);
+      const args = ["-i", input, "-sample_fmt", fmt, "-c:v", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/border.js

@@ -0,0 +1,24 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("border")
+    .description("Add a decorative border / frame around video")
+    .argument("<input>", "Input video file")
+    .option("--width <px>", "Border width in pixels", "20")
+    .option("--color <name>", "Border color", "white")
+    .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 w = opts.width;
+      const filter = `pad=iw+${w}*2:ih+${w}*2:${w}:${w}:color=${opts.color}`;
+      const out = opts.output || outputName(input, "bordered");
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/duration.js

@@ -0,0 +1,20 @@
+import { run } from "../run.js";
+
+export function register(program) {
+  program
+    .command("duration")
+    .description("Show duration of a media file")
+    .argument("<input>", "Input media file")
+    .option("--dry-run", "Print the ffprobe command without running it")
+    .action((input, opts) => {
+      const args = [
+        "-v", "error",
+        "-show_entries", "format=duration",
+        "-of", "csv=p=0",
+        "-sexagesimal",
+        input,
+      ];
+
+      run(args, { bin: "ffprobe", dryRun: opts.dryRun });
+    });
+}

src/commands/motion-blur.js

@@ -0,0 +1,21 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("motion-blur")
+    .description("Apply motion blur effect to video")
+    .argument("<input>", "Input video file")
+    .option("--frames <n>", "Number of frames to blend (higher = more blur)", "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, "motion-blur");
+      const args = ["-i", input, "-vf", `tmix=frames=${opts.frames}`, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/multi-audio.js

@@ -0,0 +1,32 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("multi-audio")
+    .description("Add multiple audio tracks to a video (e.g. multilingual)")
+    .argument("<video>", "Input video file")
+    .argument("<audios...>", "Audio files to add as separate tracks")
+    .option("-o, --output <path>", "Output file path (.mkv recommended)")
+    .option("--dry-run", "Print the FFmpeg command without running it")
+    .option("-y", "Overwrite output without asking")
+    .action((video, audios, opts) => {
+      const out = opts.output || outputName(video, "multi-audio", ".mkv");
+      const args = ["-i", video];
+
+      for (const a of audios) {
+        args.push("-i", a);
+      }
+
+      args.push("-map", "0:v");
+      args.push("-map", "0:a?");
+      for (let i = 0; i < audios.length; i++) {
+        args.push("-map", `${i + 1}:a`);
+      }
+      args.push("-c", "copy");
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/sample-rate.js

@@ -0,0 +1,22 @@
+import { run } from "../run.js";
+import { outputName, parsePositiveNumber } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("sample-rate")
+    .description("Change audio sample rate (e.g. 44100, 48000, 96000)")
+    .argument("<input>", "Input video/audio file")
+    .argument("<rate>", "Target sample rate in Hz (e.g. 44100, 48000)")
+    .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, rate, opts) => {
+      const sr = parsePositiveNumber(rate, "sample rate");
+      const out = opts.output || outputName(input, `${Math.floor(sr)}hz`);
+      const args = ["-i", input, "-ar", String(Math.floor(sr)), "-c:v", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}