feat: add 8 new commands — audio-pitch, audio-eq, pan-audio, trim-silence, gif-to-video, progress, backdrop, count-frames (v2.1.0)

91 total commands.

New commands:
- audio-pitch: Change pitch without changing speed (rubberband)
- audio-eq: Bass/treble/mid equalizer
- pan-audio: Stereo panning (left/right positioning)
- trim-silence: Auto-remove silent sections
- gif-to-video: Convert GIF to MP4
- progress: Add animated progress bar overlay
- backdrop: Blurred background for vertical videos (SNS-ready)
- count-frames: Count total frames in a video

https://claude.ai/code/session_01BPZRs1uut8bAVcEQsjWjsw

Author: omitsu-dev

.github/workflows/ci.yml

@@ -111,10 +111,19 @@ jobs:
           node bin/ffmpeg-quick.js timecode test.mp4 --dry-run
           node bin/ffmpeg-quick.js compare test.mp4 test.mp4 --dry-run
           node bin/ffmpeg-quick.js concat-audio test.mp3 test.mp3 --dry-run
+          node bin/ffmpeg-quick.js audio-pitch test.mp4 2 --dry-run
+          node bin/ffmpeg-quick.js audio-eq test.mp4 --bass 5 --dry-run
+          node bin/ffmpeg-quick.js pan-audio test.mp4 -0.5 --dry-run
+          node bin/ffmpeg-quick.js trim-silence test.mp4 --dry-run
+          node bin/ffmpeg-quick.js gif-to-video test.gif --dry-run
+          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
 
       - name: Test real encode (compress a generated video)
         run: |
           ffmpeg -f lavfi -i testsrc=duration=2:size=320x240:rate=15 -c:v libx264 -pix_fmt yuv420p test-input.mp4
+          ffmpeg -f lavfi -i testsrc=duration=1:size=160x120:rate=5 test-input-gif.gif
           node bin/ffmpeg-quick.js compress test-input.mp4 -y
           node bin/ffmpeg-quick.js trim test-input.mp4 -s 0 -d 1 -y
           node bin/ffmpeg-quick.js resize test-input.mp4 -w 160 -y
@@ -163,3 +172,7 @@ jobs:
           node bin/ffmpeg-quick.js pixelate test-input.mp4 -y
           node bin/ffmpeg-quick.js timecode test-input.mp4 -y
           node bin/ffmpeg-quick.js compare test-input.mp4 test-input.mp4 -y
+          node bin/ffmpeg-quick.js progress test-input.mp4 2 -y
+          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

bin/ffmpeg-quick.js

@@ -84,13 +84,21 @@ import { register as pixelate } from "../src/commands/pixelate.js";
 import { register as timecode } from "../src/commands/timecode.js";
 import { register as compare } from "../src/commands/compare.js";
 import { register as concatAudio } from "../src/commands/concat-audio.js";
+import { register as audioPitch } from "../src/commands/audio-pitch.js";
+import { register as audioEq } from "../src/commands/audio-eq.js";
+import { register as panAudio } from "../src/commands/pan-audio.js";
+import { register as trimSilence } from "../src/commands/trim-silence.js";
+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";
 
 const program = new Command();
 
 program
   .name("ffmpeg-quick")
   .description("Quick FFmpeg presets for common video tasks")
-  .version("2.0.0");
+  .version("2.1.0");
 
 compress(program);
 gif(program);
@@ -175,5 +183,13 @@ pixelate(program);
 timecode(program);
 compare(program);
 concatAudio(program);
+audioPitch(program);
+audioEq(program);
+panAudio(program);
+trimSilence(program);
+gifToVideo(program);
+progress(program);
+backdrop(program);
+countFrames(program);
 
 program.parse();

package.json

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

src/commands/audio-eq.js

@@ -0,0 +1,33 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("audio-eq")
+    .description("Apply audio equalizer (bass / treble adjustment)")
+    .argument("<input>", "Input video/audio file")
+    .option("--bass <dB>", "Bass gain in dB (-20 to 20)", "0")
+    .option("--treble <dB>", "Treble gain in dB (-20 to 20)", "0")
+    .option("--mid <dB>", "Mid-range gain in dB (-20 to 20)", "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 filters = [];
+      if (opts.bass !== "0") filters.push(`bass=g=${opts.bass}`);
+      if (opts.treble !== "0") filters.push(`treble=g=${opts.treble}`);
+      if (opts.mid !== "0") filters.push(`equalizer=f=1000:t=h:width=500:g=${opts.mid}`);
+
+      if (filters.length === 0) {
+        console.error("Error: specify at least --bass, --treble, or --mid.");
+        process.exit(1);
+      }
+
+      const out = opts.output || outputName(input, "eq");
+      const args = ["-i", input, "-af", filters.join(","), "-c:v", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/audio-pitch.js

@@ -0,0 +1,31 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("audio-pitch")
+    .description("Change audio pitch without changing speed")
+    .argument("<input>", "Input video/audio file")
+    .argument("<semitones>", "Pitch shift in semitones (e.g. 2, -3)")
+    .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, semitones, opts) => {
+      const n = parseFloat(semitones);
+      if (isNaN(n)) {
+        console.error("Error: semitones must be a number (e.g. 2, -3).");
+        process.exit(1);
+      }
+
+      // rubberband pitch shift: 2^(semitones/12)
+      const factor = Math.pow(2, n / 12);
+      const filter = `rubberband=pitch=${factor.toFixed(6)}`;
+      const suffix = n >= 0 ? `pitch+${n}` : `pitch${n}`;
+      const out = opts.output || outputName(input, suffix);
+      const args = ["-i", input, "-af", filter, "-c:v", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/backdrop.js

@@ -0,0 +1,35 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("backdrop")
+    .description("Add blurred background to vertical video (for 16:9 output)")
+    .argument("<input>", "Input vertical video file")
+    .option("--size <WxH>", "Output canvas size", "1920x1080")
+    .option("--blur <n>", "Background blur strength", "20")
+    .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 match = opts.size.match(/^(\d+)x(\d+)$/);
+      if (!match) {
+        console.error("Error: --size must be WxH (e.g. 1920x1080).");
+        process.exit(1);
+      }
+      const [, w, h] = match;
+
+      const filter = [
+        `[0:v]scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h},boxblur=${opts.blur}[bg]`,
+        `[0:v]scale=${w}:${h}:force_original_aspect_ratio=decrease[fg]`,
+        `[bg][fg]overlay=(W-w)/2:(H-h)/2`,
+      ].join(";");
+
+      const out = opts.output || outputName(input, "backdrop");
+      const args = ["-i", input, "-filter_complex", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/count-frames.js

@@ -0,0 +1,21 @@
+import { run } from "../run.js";
+
+export function register(program) {
+  program
+    .command("count-frames")
+    .description("Count total number of frames in a video")
+    .argument("<input>", "Input video file")
+    .option("--dry-run", "Print the ffprobe command without running it")
+    .action((input, opts) => {
+      const args = [
+        "-v", "error",
+        "-count_frames",
+        "-select_streams", "v:0",
+        "-show_entries", "stream=nb_read_frames",
+        "-of", "csv=p=0",
+        input,
+      ];
+
+      run(args, { bin: "ffprobe", dryRun: opts.dryRun });
+    });
+}

src/commands/gif-to-video.js

@@ -0,0 +1,32 @@
+import { run } from "../run.js";
+import { basename, extname, dirname, join } from "node:path";
+
+export function register(program) {
+  program
+    .command("gif-to-video")
+    .description("Convert GIF to video (MP4)")
+    .argument("<input>", "Input GIF file")
+    .option("--loop <n>", "Number of loops (0 = single play)", "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 dir = dirname(input);
+      const base = basename(input, extname(input));
+      const out = opts.output || join(dir, `${base}.mp4`);
+
+      const args = ["-i", input];
+      if (parseInt(opts.loop, 10) > 0) {
+        args.unshift("-stream_loop", opts.loop);
+      }
+      args.push(
+        "-movflags", "faststart",
+        "-pix_fmt", "yuv420p",
+        "-vf", "scale=trunc(iw/2)*2:trunc(ih/2)*2",
+      );
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/pan-audio.js

@@ -0,0 +1,31 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("pan-audio")
+    .description("Pan audio left/right (stereo positioning)")
+    .argument("<input>", "Input video/audio file")
+    .argument("<position>", "Pan position: -1.0 (full left) to 1.0 (full right), 0 = center")
+    .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, position, opts) => {
+      const p = parseFloat(position);
+      if (isNaN(p) || p < -1 || p > 1) {
+        console.error("Error: position must be between -1.0 (left) and 1.0 (right).");
+        process.exit(1);
+      }
+
+      // Calculate left/right volumes
+      const left = Math.min(1, 1 - p).toFixed(2);
+      const right = Math.min(1, 1 + p).toFixed(2);
+      const filter = `pan=stereo|c0=${left}*c0+0*c1|c1=0*c0+${right}*c1`;
+      const out = opts.output || outputName(input, "panned");
+      const args = ["-i", input, "-af", filter, "-c:v", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/progress.js

@@ -0,0 +1,28 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+export function register(program) {
+  program
+    .command("progress")
+    .description("Add a progress bar overlay to video")
+    .argument("<input>", "Input video file")
+    .argument("<duration>", "Total video duration in seconds")
+    .option("--pos <position>", "Position: top or bottom", "bottom")
+    .option("--color <name>", "Progress bar color", "red")
+    .option("--height <px>", "Bar height in pixels", "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, duration, opts) => {
+      const h = opts.height;
+      const y = opts.pos === "top" ? "0" : `ih-${h}`;
+      const filter = `drawbox=x=0:y=${y}:w='iw*t/${duration}':h=${h}:color=${opts.color}:t=fill`;
+
+      const out = opts.output || outputName(input, "progress");
+      const args = ["-i", input, "-vf", filter, "-c:a", "copy"];
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}