feat: add watermark and denoise commands, link to 32blog command generator

Author: omitsu-dev

README.md

@@ -68,6 +68,10 @@ npx ffmpeg-quick compress input.mp4
 | `trim` | Cut a section from a video |
 | `resize` | Resize video to a target width or height |
 | `crop` | Crop a region from the video |
+| `watermark` | Add image watermark overlay |
+| `denoise` | Reduce noise from video or audio |
+
+> Prefer a visual interface? Try the [FFmpeg Command Generator](https://32blog.com/en/tools/ffmpeg-command-generator) on 32blog — build commands by clicking options instead of typing flags.
 
 ### Usage
 
@@ -116,6 +120,12 @@ npx ffmpeg-quick resize input.mp4 -w 1280
 
 # Crop center 1280x720 region
 npx ffmpeg-quick crop input.mp4 1280x720
+
+# Add watermark (bottom-right, 10px margin)
+npx ffmpeg-quick watermark input.mp4 logo.png
+
+# Denoise video (medium strength)
+npx ffmpeg-quick denoise input.mp4 --strength medium
 ```
 
 ### Common Options
@@ -176,6 +186,15 @@ npx ffmpeg-quick crop input.mp4 1280x720
 - `<size>` — Crop size as WxH (e.g. 1280x720)
 - `--pos <x:y>` — Top-left position (default: center)
 
+**watermark**
+- `<image>` — Watermark image file (PNG recommended)
+- `--position <pos>` — Position: topleft, top, topright, left, center, right, bottomleft, bottom, bottomright (default: bottomright)
+- `--margin <n>` — Margin from edge in pixels (default: 10)
+
+**denoise**
+- `--target <type>` — Target: video or audio (default: video)
+- `--strength <level>` — Strength: light, medium, strong (default: medium)
+
 ### The Hard Stuff, Made Easy
 
 These commands solve problems that send you down a rabbit hole every time:
@@ -293,6 +312,10 @@ npx ffmpeg-quick compress input.mp4
 | `trim` | 動画の一部を切り出し |
 | `resize` | 解像度を変更 |
 | `crop` | 動画の一部を切り抜き |
+| `watermark` | 透かし画像をオーバーレイ |
+| `denoise` | 映像/音声のノイズ除去 |
+
+> GUIでコマンドを組み立てたい場合は、32blogの [FFmpegコマンドジェネレーター](https://32blog.com/ja/tools/ffmpeg-command-generator) をどうぞ。
 
 ### 使い方
 
@@ -341,6 +364,12 @@ npx ffmpeg-quick resize input.mp4 -w 1280
 
 # 中央を1280x720で切り抜き
 npx ffmpeg-quick crop input.mp4 1280x720
+
+# 透かし追加（右下、マージン10px）
+npx ffmpeg-quick watermark input.mp4 logo.png
+
+# ノイズ除去（映像、中程度）
+npx ffmpeg-quick denoise input.mp4 --strength medium
 ```
 
 ### 共通オプション
@@ -401,6 +430,15 @@ npx ffmpeg-quick crop input.mp4 1280x720
 - `<size>` — 切り抜きサイズ WxH（例: 1280x720）
 - `--pos <x:y>` — 左上の位置（デフォルト: center）
 
+**watermark**
+- `<image>` — 透かし画像ファイル（PNG推奨）
+- `--position <pos>` — 位置: topleft, top, topright, left, center, right, bottomleft, bottom, bottomright（デフォルト: bottomright）
+- `--margin <n>` — 端からのマージン（px、デフォルト: 10）
+
+**denoise**
+- `--target <type>` — 対象: video または audio（デフォルト: video）
+- `--strength <level>` — 強度: light, medium, strong（デフォルト: medium）
+
 ### 面倒なやつ、全部やります
 
 毎回ググるハメになるやつを1コマンドに：

bin/ffmpeg-quick.js

@@ -16,13 +16,15 @@ import { register as stabilize } from "../src/commands/stabilize.js";
 import { register as trim } from "../src/commands/trim.js";
 import { register as resize } from "../src/commands/resize.js";
 import { register as crop } from "../src/commands/crop.js";
+import { register as watermark } from "../src/commands/watermark.js";
+import { register as denoise } from "../src/commands/denoise.js";
 
 const program = new Command();
 
 program
   .name("ffmpeg-quick")
   .description("Quick FFmpeg presets for common video tasks")
-  .version("1.1.0");
+  .version("1.2.0");
 
 compress(program);
 gif(program);
@@ -39,5 +41,7 @@ stabilize(program);
 trim(program);
 resize(program);
 crop(program);
+watermark(program);
+denoise(program);
 
 program.parse();

package.json

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

src/commands/denoise.js

@@ -0,0 +1,42 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+const VIDEO_STRENGTH = {
+  light: "3:2:3:2",
+  medium: "5:4:5:4",
+  strong: "7:6:7:6",
+};
+
+const AUDIO_NOISE_FLOOR = {
+  light: "-20",
+  medium: "-30",
+  strong: "-40",
+};
+
+export function register(program) {
+  program
+    .command("denoise")
+    .description("Reduce noise from video or audio")
+    .argument("<input>", "Input video file")
+    .option("--target <type>", "Target: video or audio", "video")
+    .option("--strength <level>", "Strength: light, medium, strong", "medium")
+    .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, "denoised");
+      const args = ["-i", input];
+
+      if (opts.target === "audio") {
+        const nf = AUDIO_NOISE_FLOOR[opts.strength] || AUDIO_NOISE_FLOOR.medium;
+        args.push("-af", `afftdn=nf=${nf}`, "-c:v", "copy");
+      } else {
+        const params = VIDEO_STRENGTH[opts.strength] || VIDEO_STRENGTH.medium;
+        args.push("-vf", `hqdn3d=${params}`, "-c:a", "copy");
+      }
+
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}

src/commands/watermark.js

@@ -0,0 +1,41 @@
+import { run } from "../run.js";
+import { outputName } from "../utils.js";
+
+const POS_MAP = {
+  topleft: (m) => `${m}:${m}`,
+  top: (m) => `(W-w)/2:${m}`,
+  topright: (m) => `W-w-${m}:${m}`,
+  left: (m) => `${m}:(H-h)/2`,
+  center: () => "(W-w)/2:(H-h)/2",
+  right: (m) => `W-w-${m}:(H-h)/2`,
+  bottomleft: (m) => `${m}:H-h-${m}`,
+  bottom: (m) => `(W-w)/2:H-h-${m}`,
+  bottomright: (m) => `W-w-${m}:H-h-${m}`,
+};
+
+export function register(program) {
+  program
+    .command("watermark")
+    .description("Add image watermark overlay to video")
+    .argument("<input>", "Input video file")
+    .argument("<image>", "Watermark image file (PNG recommended)")
+    .option("--position <pos>", "Position: topleft, top, topright, left, center, right, bottomleft, bottom, bottomright", "bottomright")
+    .option("--margin <n>", "Margin from edge in pixels", "10")
+    .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, image, opts) => {
+      const out = opts.output || outputName(input, "watermarked");
+      const posFn = POS_MAP[opts.position] || POS_MAP.bottomright;
+      const overlay = posFn(opts.margin);
+      const args = [
+        "-i", input,
+        "-i", image,
+        "-filter_complex", `overlay=${overlay}`,
+        "-c:a", "copy",
+      ];
+      if (opts.y) args.push("-y");
+      args.push(out);
+      run(args, { dryRun: opts.dryRun });
+    });
+}