@x12i/youtube-video-uploader-cli 1.4.0 → 1.6.1

package/README.md

@@ -14,8 +14,11 @@
 - **🛡️ Safe Quota Batching**: `--safe-quota`, `--limit`, and `--max-quota` defer excess uploads for the next day (~1,600 units/video + 50/playlist item).
 - **📊 Quota Estimation**: Warns when estimated units approach the standard 10,000/day limit.
 - **🔁 Playlist Video Swap**: `swap` subcommand replaces a playlist entry in place; old video is unlisted, never deleted. Resumable via `.swap-history.json`.
+- **🔄 Sync Playlist**: `sync-playlist` detects local files newer than upload history, swaps them in-place (private by default), and realigns playlist order with overview prefix + album tracks.
+- **🔐 Set Access**: `set-access` sets privacy for a playlist and all its videos (`private`, `unlisted`, or `public`).
 - **🏷️ Metadata & Title Updates**: `update-metadata` / `update-titles` subcommand to batch update video titles and playlist titles on YouTube and in `metadata.json` (e.g. adding postfixes, prefixes, or syncing).
 - **🎬 Automated Stock Media Sourcing**: Search Pexels and Pixabay for high-res stock videos/photos, rank and auto-select best matches, cache responses, and compose final `.mp4` files from audio tracks via ffmpeg.
+- **🧹 Gemini Watermark Removal**: Strip visible Gemini/Veo watermarks from local images and videos via MIT-licensed providers (`remove-watermark` command + `remove-watermark` pipeline action; default provider `@pilio/gemini-watermark-remover`).
 - **🔍 Dry Run Mode**: Validate metadata and estimate quota before uploading or updating.
 
 ---
@@ -237,11 +240,16 @@ Options:
   --playlist-postfix <postfix>  Postfix to append to playlist title (e.g. " (long versions)")
   --title-prefix <prefix>       Prefix to prepend to each video title
   --playlist-title <title>      Explicit new title for the playlist
+  --replace-pattern <pattern>   Find/replace pattern in titles (and metadata.json when saving)
+  --replace-with <replacement>  Replacement string for --replace-pattern
+  --replace-literal             Treat --replace-pattern as a plain substring (not regex)
+  --replace-in-snippet          Also replace in YouTube descriptions and tags
+  --include-playlist <id>       Include all playlist videos (e.g. overview prefix videos)
   --video <videoId>             Target a specific YouTube video ID
   --title <title>               Explicit new title for the targeted video
   --playlist <playlistId>       Target a specific YouTube playlist ID
   --no-update-file              Do not update metadata.json on disk
-  -n, --dry-run                 Preview changes without making any API calls
+  --dry-run                     Preview changes without making any API calls
   --token-file <file>           OAuth token path (default: token.json in target dir)
   --client-secrets-file <file>  Path to client_secret.json
   --client-id <id>              Google OAuth Client ID
@@ -283,6 +291,23 @@ npx @x12i/youtube-video-uploader-cli ./my-videos
 npx @x12i/youtube-video-uploader-cli ./my-videos --client-secrets-file ./client_secret.json
 ```
 
+### 6. Rename band/artist text across playlist titles and metadata
+```bash
+yvu-cli update-metadata ./my-album \
+  --replace-pattern "The White Stoic" \
+  --replace-with "White Stoic" \
+  --replace-literal \
+  --include-playlist PLxxxx \
+  --dry-run
+
+# Apply:
+yvu-cli update-metadata ./my-album \
+  --replace-pattern "The White Stoic" \
+  --replace-with "White Stoic" \
+  --replace-literal \
+  --include-playlist PLxxxx
+```
+
 ---
 
 ## 🔁 Replacing a Video in a Playlist (`swap`)
@@ -481,6 +506,39 @@ yt-uploader preview-journey 01-first.mp4 --dir ./my-videos
 yt-uploader preview-journey 01-first.mp4 --center-text "Custom prompt question?" -o ./preview.png
 ```
 
+#### Remove Watermark (`remove-watermark`)
+Clean visible Gemini/Veo watermarks from a local file or folder using a permissive-license provider (default: `pilio` / `@pilio/gemini-watermark-remover`):
+
+```bash
+# Single file → writes stem-clean.ext next to the input
+yt-uploader remove-watermark ./clip.mp4
+
+# Explicit output path
+yt-uploader remove-watermark ./clip.mp4 -o ./clean.mp4
+
+# Batch a folder into a sibling *-clean directory
+yt-uploader remove-watermark ./gemini-exports --out-dir ./gemini-exports-clean
+
+# Preview provider commands
+yt-uploader remove-watermark ./clip.mp4 --dry-run
+
+# Higher video encode target (provider-specific)
+yt-uploader remove-watermark ./clip.mp4 -o ./clean.mp4 --video-bitrate-mbps 20 --overwrite
+```
+
+Or as a pipeline action in `metadata.json` / `--actions-file`:
+
+```json
+{
+  "type": "remove-watermark",
+  "provider": "pilio",
+  "videoBitrateMbps": 20,
+  "overwrite": true
+}
+```
+
+Only MIT / Apache-2.0 / BSD / ISC providers are registered. Additional providers are added under `src/providers/watermark/` without changing the pipeline.
+
 ---
 
 ## 🛠️ Programmatic Node.js API

package/bin/cli.js

@@ -11,6 +11,8 @@ import {
   swapSong,
   SwapStore,
   QUOTA_PER_SWAP,
+  syncPlaylist,
+  setPlaylistAccess,
   batchUpdateMetadata,
   searchMedia,
   rankCandidates,
@@ -18,6 +20,9 @@ import {
   composeVideo,
   batchApplyActions,
   previewJourney,
+  batchRemoveWatermark,
+  listWatermarkProviders,
+  DEFAULT_WATERMARK_PROVIDER,
 } from '../src/index.js';
 import { authenticate } from '../src/auth.js';
 
@@ -248,6 +253,7 @@ program
   .option('--client-id <id>', 'Google OAuth Client ID')
   .option('--client-secret <secret>', 'Google OAuth Client Secret')
   .option('--fresh', 'Discard any previous swap state for this key and start over', false)
+  .option('--privacy <preserve|private|public>', 'Final privacy for the new video (default: public)', 'public')
   .option('-n, --dry-run', 'Print the swap plan without any API calls', false)
   .option('-q, --quiet', 'Minimal output mode', false)
   .action(async (videoFile, options) => {
@@ -318,6 +324,7 @@ program
         stateDir,
         stateFile: options.stateFile,
         fresh: options.fresh,
+        privacyMode: options.privacy || 'public',
         onEvent: (event) => {
           if (isQuiet) return;
           if (event.type === 'swap_step') {
@@ -337,7 +344,8 @@ program
         console.log();
         console.log(pc.green(pc.bold(`🎉 Swap complete!`)));
         console.log(`  • Playlist entry replaced: ${pc.bold(options.playlist)} (position preserved)`);
-        console.log(`  • New video is public    : ${pc.underline(pc.blue(`https://youtu.be/${record.newVideoId}`))}`);
+        console.log(`  • New video privacy    : ${pc.bold(options.privacy || 'public')}`);
+        console.log(`  • New video            : ${pc.underline(pc.blue(`https://youtu.be/${record.newVideoId}`))}`);
         console.log(`  • Old video unlisted     : ${pc.dim(`https://youtu.be/${options.oldVideo} (direct links still work)`)}`);
         console.log();
       }
@@ -347,6 +355,202 @@ program
     }
   });
 
+program
+  .command('sync-playlist')
+  .description('Push local videos that changed since upload (playlist swap) and realign playlist order — keeps videos private by default')
+  .argument('[directory]', 'Album folder with metadata.json and .upload-history.json (default: current directory)', '.')
+  .option('--album-dir <path>', 'Explicit album directory path (alias for positional directory)')
+  .option('-d, --dir <path>', 'Alias for --album-dir')
+  .requiredOption('--playlist <id>', 'YouTube playlist ID to sync')
+  .option('--overview-history <file>', 'Upload history JSON for overview/prefix videos')
+  .option('--overview-key <file>', 'Overview filename keys in order (repeatable)', (value, prev) => [...prev, value], [])
+  .option('--only <filename>', 'Restrict push to specific filenames (repeatable)', (value, prev) => [...prev, value], [])
+  .option('--privacy <preserve|private|public>', 'Privacy for swapped videos (default: private)', 'private')
+  .option('--skip-reorder', 'Push outdated files without reordering the playlist', false)
+  .option('--fresh', 'Discard previous swap state and start swaps fresh', false)
+  .option('--token-file <file>', 'OAuth token file (default: token.json in target dir)')
+  .option('--client-secrets-file <file>', 'Path to client_secret.json')
+  .option('--client-id <id>', 'Google OAuth Client ID')
+  .option('--client-secret <secret>', 'Google OAuth Client Secret')
+  .option('-n, --dry-run', 'Print the sync plan without API calls')
+  .option('-q, --quiet', 'Minimal output mode', false)
+  .action(async (directoryArg, options) => {
+    const isQuiet = options.quiet;
+    const albumDir = path.resolve(options.albumDir || options.dir || directoryArg || process.cwd());
+    const dryRun = Boolean(options.dryRun);
+
+    if (!isQuiet) {
+      console.log();
+      console.log(pc.bold(pc.red(`🔄 Sync Playlist`)) + ` ${pc.dim(`v${pkg.version}`)}`);
+      console.log(pc.dim(`──────────────────────────────────────────────────────────`));
+      console.log(`${pc.bold('📂 Album Dir       :')} ${pc.white(albumDir)}`);
+      console.log(`${pc.bold('📑 Playlist ID     :')} ${pc.white(options.playlist)}`);
+      if (options.overviewHistory) {
+        console.log(`${pc.bold('🎬 Overview History:')} ${pc.white(path.resolve(options.overviewHistory))}`);
+      }
+      console.log(`${pc.bold('🔒 Privacy Mode    :')} ${pc.white(options.privacy || 'private')}`);
+      console.log();
+    }
+
+    try {
+      const tokenFile = options.tokenFile
+        ? path.resolve(options.tokenFile)
+        : path.join(albumDir, 'token.json');
+
+      let youtube = null;
+      if (!dryRun) {
+        const auth = await authenticate({
+          tokenFile,
+          clientSecretsFile: options.clientSecretsFile,
+          clientId: options.clientId,
+          clientSecret: options.clientSecret,
+        });
+        youtube = google.youtube({ version: 'v3', auth });
+      }
+
+      const result = await syncPlaylist({
+        youtube,
+        albumDir,
+        playlistId: options.playlist,
+        overviewHistoryPath: options.overviewHistory ? path.resolve(options.overviewHistory) : undefined,
+        overviewKeys: options.overviewKey,
+        onlyFilenames: options.only,
+        privacyMode: options.privacy || 'private',
+        dryRun,
+        skipReorder: options.skipReorder,
+        freshSwap: options.fresh,
+        onEvent: (event) => {
+          if (isQuiet) return;
+          if (event.type === 'sync_push_start') {
+            console.log(pc.cyan(`⬆️  Pushing ${event.filename} (replacing ${event.oldVideoId})…`));
+          } else if (event.type === 'sync_push_success') {
+            console.log(pc.green(`  ✅ ${event.filename} → ${event.record.newVideoId}`));
+          } else if (event.type === 'sync_reorder_success') {
+            console.log(pc.green(`  🔀 Reordered playlist (${event.changed} position updates)`));
+          }
+        },
+      });
+
+      if (!isQuiet) {
+        if (dryRun || result.dryRun) {
+          console.log(pc.yellow('🔍 DRY RUN plan'));
+          console.log(`  Outdated local files: ${result.outdated.length}`);
+          for (const item of result.outdated) {
+            console.log(`    • ${item.filename} (local ${item.modifiedAt} > uploaded ${item.uploadedAt})`);
+          }
+          console.log(`  Desired order (${result.desiredOrder.length} videos):`);
+          result.desiredOrder.forEach((id, i) => console.log(`    ${i}. ${id}`));
+          if (result.currentOrder?.length) {
+            console.log(`  Current order aligned: ${result.orderAligned ? 'yes' : 'no'}`);
+          }
+          console.log();
+        } else {
+          console.log();
+          console.log(pc.green(pc.bold('🎉 Sync complete')));
+          console.log(`  • Pushed   : ${result.pushed.length} video(s)`);
+          console.log(`  • Reordered: ${result.reordered ? 'yes' : 'already aligned'}`);
+          console.log(`  • Playlist : https://www.youtube.com/playlist?list=${options.playlist}`);
+          console.log();
+        }
+      }
+    } catch (err) {
+      console.error(pc.red(`\n❌ Error: ${err.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('set-access')
+  .description('Set privacy/access for a playlist and its videos (private, unlisted, or public)')
+  .argument('[directory]', 'Album folder for metadata/history updates (default: current directory)', '.')
+  .option('--album-dir <path>', 'Explicit album directory path')
+  .requiredOption('--playlist <id>', 'YouTube playlist ID')
+  .requiredOption('--privacy <private|unlisted|public>', 'Target privacy status')
+  .option('--videos <playlist|history>', 'Where to resolve member videos (default: playlist)', 'playlist')
+  .option('--overview-history <file>', 'Overview upload history when --videos history')
+  .option('--overview-key <file>', 'Overview filename keys in order (repeatable)', (value, prev) => [...prev, value], [])
+  .option('--update-metadata', 'Write privacy status into metadata.json', false)
+  .option('--token-file <file>', 'OAuth token file (default: token.json in album dir)')
+  .option('--client-secrets-file <file>', 'Path to client_secret.json')
+  .option('--client-id <id>', 'Google OAuth Client ID')
+  .option('--client-secret <secret>', 'Google OAuth Client Secret')
+  .option('--dry-run', 'Print the access plan without API updates')
+  .option('-q, --quiet', 'Minimal output mode', false)
+  .action(async (directoryArg, options) => {
+    const isQuiet = options.quiet;
+    const albumDir = path.resolve(options.albumDir || directoryArg || process.cwd());
+    const parentOpts = program.opts();
+    const dryRun = Boolean(options.dryRun || parentOpts.dryRun);
+
+    if (!isQuiet) {
+      console.log();
+      console.log(pc.bold(pc.red(`🔐 Set Access`)) + ` ${pc.dim(`v${pkg.version}`)}`);
+      console.log(pc.dim(`──────────────────────────────────────────────────────────`));
+      console.log(`${pc.bold('📂 Album Dir       :')} ${pc.white(albumDir)}`);
+      console.log(`${pc.bold('📑 Playlist ID     :')} ${pc.white(options.playlist)}`);
+      console.log(`${pc.bold('🔒 Target Privacy  :')} ${pc.white(options.privacy)}`);
+      console.log(`${pc.bold('🎬 Video Source    :')} ${pc.white(options.videos || 'playlist')}`);
+      console.log();
+    }
+
+    try {
+      const tokenFile = options.tokenFile
+        ? path.resolve(options.tokenFile)
+        : path.join(albumDir, 'token.json');
+
+      let youtube = null;
+      const auth = await authenticate({
+        tokenFile,
+        clientSecretsFile: options.clientSecretsFile,
+        clientId: options.clientId,
+        clientSecret: options.clientSecret,
+      });
+      youtube = google.youtube({ version: 'v3', auth });
+
+      const result = await setPlaylistAccess({
+        youtube,
+        playlistId: options.playlist,
+        privacyStatus: options.privacy,
+        videoSource: options.videos || 'playlist',
+        albumDir,
+        overviewHistoryPath: options.overviewHistory ? path.resolve(options.overviewHistory) : undefined,
+        overviewKeys: options.overviewKey,
+        updateMetadata: Boolean(options.updateMetadata),
+        dryRun,
+        onEvent: (event) => {
+          if (isQuiet) return;
+          if (event.type === 'access_video_start') {
+            console.log(pc.cyan(`  🔒 ${event.title || event.videoId} → ${options.privacy}`));
+          }
+        },
+      });
+
+      if (!isQuiet) {
+        if (dryRun || result.dryRun) {
+          console.log(pc.yellow('🔍 DRY RUN plan'));
+          console.log(`  Playlist ${result.playlist.playlistId}: ${result.playlist.currentPrivacy || '?'} → ${result.playlist.targetPrivacy}${result.playlist.changed ? '' : ' (no change)'}`);
+          console.log(`  Videos (${result.videos.length}):`);
+          for (const video of result.videos) {
+            const label = video.title || video.videoId;
+            console.log(`    • ${label}: ${video.currentPrivacy || '?'} → ${video.targetPrivacy}${video.changed ? '' : ' (no change)'}`);
+          }
+          console.log(`  Estimated quota: ~${result.estimatedQuota} units`);
+          console.log();
+        } else {
+          console.log();
+          console.log(pc.green(pc.bold('🎉 Access updated')));
+          console.log(`  • Playlist : ${result.updated.playlist ? options.privacy : 'unchanged'} (${options.playlist})`);
+          console.log(`  • Videos   : ${result.updated.videos.length} updated to ${options.privacy}`);
+          console.log(`  • URL      : https://www.youtube.com/playlist?list=${options.playlist}`);
+          console.log();
+        }
+      }
+    } catch (err) {
+      console.error(pc.red(`\n❌ Error: ${err.message}\n`));
+      process.exit(1);
+    }
+  });
+
 program
   .command('update-metadata')
   .alias('update-titles')
@@ -360,12 +564,15 @@ program
   .option('--playlist-title <title>', 'Explicit new title for the playlist')
   .option('--replace-pattern <pattern>', 'Regex/string pattern to replace in titles')
   .option('--replace-with <replacement>', 'Replacement string for --replace-pattern', '')
+  .option('--replace-literal', 'Treat --replace-pattern as a plain substring (not regex)', false)
+  .option('--replace-in-snippet', 'Also replace in descriptions and tags on YouTube', false)
+  .option('--include-playlist <id>', 'Include all videos in this playlist (covers overview/prefix videos outside metadata.json)')
   .option('--sync-metadata', 'Sync titles directly from metadata.json to YouTube')
   .option('--video <videoId>', 'Target a specific YouTube video ID')
   .option('--title <title>', 'Explicit new title for the targeted video')
   .option('--playlist <playlistId>', 'Target a specific YouTube playlist ID')
   .option('--no-update-file', 'Do not update metadata.json on disk')
-  .option('-n, --dry-run', 'Preview changes without making any API calls')
+  .option('--dry-run', 'Preview changes without making any API calls')
   .option('--token-file <file>', 'Path to store or read OAuth token (default: token.json in target dir)')
   .option('--client-secrets-file <file>', 'Path to client_secret.json downloaded from Google Cloud')
   .option('--client-id <id>', 'Google OAuth Client ID')
@@ -374,12 +581,17 @@ program
   .action(async (directoryArg, options) => {
     const targetDir = path.resolve(options.dir || directoryArg || process.cwd());
     const isQuiet = options.quiet;
+    const parentOpts = program.opts();
+    const dryRun = Boolean(options.dryRun || parentOpts.dryRun);
 
     if (!isQuiet) {
       console.log();
       console.log(pc.bold(pc.cyan(`📝 YouTube Metadata & Title Updater`)) + ` ${pc.dim(`v${pkg.version}`)}`);
       console.log(pc.dim(`──────────────────────────────────────────────────────────`));
       console.log(`${pc.bold('📂 Target Folder   :')} ${pc.white(targetDir)}`);
+      if (options.replacePattern) {
+        console.log(`${pc.bold('🔁 Replace         :')} ${pc.green(JSON.stringify(options.replacePattern))} → ${pc.green(JSON.stringify(options.replaceWith || ''))}`);
+      }
       if (options.titlePostfix) {
         console.log(`${pc.bold('🏷️  Title Postfix   :')} ${pc.green(JSON.stringify(options.titlePostfix))}`);
       }
@@ -389,7 +601,10 @@ program
       if (options.titlePrefix) {
         console.log(`${pc.bold('🏷️  Title Prefix    :')} ${pc.green(JSON.stringify(options.titlePrefix))}`);
       }
-      if (options.dryRun) {
+      if (options.includePlaylist) {
+        console.log(`${pc.bold('📑 Include Playlist:')} ${pc.white(options.includePlaylist)}`);
+      }
+      if (dryRun) {
         console.log(`${pc.yellow(pc.bold('🔍 Mode            :'))} ${pc.yellow('DRY RUN (no updates will be performed)')}`);
       }
       console.log();
@@ -407,13 +622,16 @@ program
         playlistTitle: options.playlistTitle,
         replacePattern: options.replacePattern,
         replaceWith: options.replaceWith,
+        replaceLiteral: options.replaceLiteral,
+        replaceInSnippet: options.replaceInSnippet,
+        includePlaylistId: options.includePlaylist,
         syncMetadata: options.syncMetadata,
         metadataFile: options.metadata,
         updateLocalMetadata: options.updateFile !== false,
         singleVideoId: options.video,
         singleVideoTitle: options.title,
         singlePlaylistId: options.playlist,
-        dryRun: options.dryRun,
+        dryRun,
         tokenFile,
         clientSecretsFile: options.clientSecretsFile,
         clientId: options.clientId,
@@ -465,7 +683,7 @@ program
       });
 
       if (!isQuiet) {
-        if (options.dryRun) {
+        if (dryRun) {
           console.log(pc.yellow(`✨ Dry run complete. No YouTube updates were performed.`));
           console.log();
           process.exit(0);
@@ -733,7 +951,7 @@ program
 
 program
   .command('apply-actions')
-  .description('Run configured video processing actions (shorten, replace-background, journey-overlay) on videos')
+  .description('Run configured video processing actions (shorten, replace-background, journey-overlay, remove-watermark) on videos')
   .argument('[directory]', 'Source folder containing metadata.json and video files (default: current directory)', '.')
   .option('-d, --dir <path>', 'Explicit target directory path')
   .option('-m, --metadata <file>', 'Custom path to metadata.json file')
@@ -866,6 +1084,126 @@ program
     }
   });
 
+program
+  .command('remove-watermark')
+  .description('Remove Gemini/Veo visible watermarks from a local image/video file or folder (MIT providers)')
+  .argument('[input]', 'Input file or folder (default: current directory)', '.')
+  .option('-o, --output <file>', 'Output file path (single-file input)')
+  .option('--out-dir <dir>', 'Output directory (folder input, or folder for a single file basename)')
+  .option('--provider <id>', `Watermark provider id (default: ${DEFAULT_WATERMARK_PROVIDER})`, DEFAULT_WATERMARK_PROVIDER)
+  .option('--overwrite', 'Overwrite existing outputs', false)
+  .option('-f, --force', 'Alias for --overwrite', false)
+  .option('--video-bitrate-mbps <n>', 'Video encode bitrate in Mbps (provider-specific)')
+  .option('--json', 'Ask the provider for JSON logs when supported', false)
+  .option('-n, --dry-run', 'Print planned provider commands without writing files', false)
+  .option('-q, --quiet', 'Minimal output mode', false)
+  .action(async (inputArg, options, command) => {
+    const parentOpts = command?.parent?.opts() || {};
+    const dryRun = Boolean(options.dryRun || parentOpts.dryRun);
+    const overwrite = Boolean(options.overwrite || options.force || parentOpts.force);
+    const isQuiet = Boolean(options.quiet || parentOpts.quiet);
+    const input = path.resolve(inputArg || '.');
+
+    let videoBitrateMbps;
+    if (options.videoBitrateMbps !== undefined) {
+      videoBitrateMbps = parseFloat(options.videoBitrateMbps);
+      if (!Number.isFinite(videoBitrateMbps) || videoBitrateMbps <= 0) {
+        console.error(pc.red(`\n❌ Error: Invalid --video-bitrate-mbps value\n`));
+        process.exit(1);
+      }
+    }
+
+    if (!isQuiet) {
+      const providers = listWatermarkProviders()
+        .map((p) => `${p.id} (${p.license})`)
+        .join(', ');
+      console.log();
+      console.log(pc.bold(pc.cyan(`🧹 Remove Watermark`)) + ` ${pc.dim(`v${pkg.version}`)}`);
+      console.log(pc.dim(`──────────────────────────────────────────────────────────`));
+      console.log(`${pc.bold('📂 Input           :')} ${pc.white(input)}`);
+      console.log(`${pc.bold('🔌 Provider        :')} ${pc.cyan(options.provider)}`);
+      console.log(`${pc.bold('📜 Known providers :')} ${pc.dim(providers)}`);
+      if (options.output) {
+        console.log(`${pc.bold('📄 Output File     :')} ${pc.white(path.resolve(options.output))}`);
+      }
+      if (options.outDir) {
+        console.log(`${pc.bold('📁 Output Dir      :')} ${pc.white(path.resolve(options.outDir))}`);
+      }
+      if (videoBitrateMbps) {
+        console.log(`${pc.bold('🎥 Video bitrate   :')} ${pc.cyan(`${videoBitrateMbps} Mbps`)}`);
+      }
+      if (dryRun) {
+        console.log(`${pc.yellow(pc.bold('🔍 Mode            :'))} ${pc.yellow('DRY RUN (no file writes)')}`);
+      }
+      if (overwrite) {
+        console.log(`${pc.magenta(pc.bold('⚡ Overwrite       :'))} ${pc.magenta('ENABLED')}`);
+      }
+      console.log();
+    }
+
+    try {
+      const result = await batchRemoveWatermark(input, {
+        output: options.output,
+        outDir: options.outDir,
+        provider: options.provider,
+        overwrite,
+        json: Boolean(options.json),
+        videoBitrateMbps,
+        dryRun,
+        onEvent: (event) => {
+          if (isQuiet) return;
+          if (event.type === 'watermark_plan') {
+            console.log(
+              pc.bold('Found ') +
+              pc.green(pc.bold(`${event.total}`)) +
+              pc.bold(` media file(s) to clean.`)
+            );
+            if (event.outDir) {
+              console.log(`${pc.bold('📁 Output Directory:')} ${pc.cyan(event.outDir)}`);
+            }
+            console.log();
+          } else if (event.type === 'entry_start') {
+            console.log(`  🧹 [${event.index + 1}/${event.total}] ${pc.bold(event.filename)}`);
+          } else if (event.type === 'entry_complete') {
+            if (dryRun) {
+              console.log(`     ${pc.dim(event.command)}`);
+            } else {
+              console.log(`     ${pc.green('✓')} ${pc.underline(event.outputPath)}`);
+            }
+          } else if (event.type === 'entry_skipped') {
+            console.log(`     ${pc.yellow('⏭')} skipped: ${event.reason}`);
+          } else if (event.type === 'entry_failed') {
+            console.log(`     ${pc.red('✗')} ${event.error?.message || event.error}`);
+          }
+        },
+      });
+
+      if (!isQuiet) {
+        console.log();
+        console.log(pc.bold('Summary'));
+        console.log(`  • Processed : ${pc.green(String(result.processed.length))}`);
+        console.log(`  • Skipped   : ${pc.yellow(String(result.skipped.length))}`);
+        console.log(`  • Failed    : ${pc.red(String(result.failed.length))}`);
+        console.log();
+        if (dryRun) {
+          console.log(pc.yellow(`✨ Dry run complete. No files were written.`));
+          console.log();
+        } else if (result.failed.length > 0) {
+          console.log(pc.red(`⚠️  Completed with ${result.failed.length} failure(s).`));
+          process.exit(1);
+        } else {
+          console.log(pc.green(pc.bold(`🎉 Watermark removal complete!`)));
+          console.log();
+        }
+      } else if (result.failed.length > 0) {
+        process.exit(1);
+      }
+    } catch (err) {
+      console.error(pc.red(`\n❌ Error: ${err.message}\n`));
+      process.exit(1);
+    }
+  });
+
 program
   .command('preview-journey')
   .description('Generate and preview the journey overlay graphic as a standalone PNG image')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x12i/youtube-video-uploader-cli",
-  "version": "1.4.0",
-  "description": "CLI tool to batch upload MP4 videos to YouTube via YouTube Data API v3 with OAuth2, metadata.json config, playlist assignment, and smart upload-state resume.",
+  "version": "1.6.1",
+  "description": "CLI tool to batch upload MP4 videos to YouTube via YouTube Data API v3 with OAuth2, metadata.json config, playlist assignment, swap, and sync-playlist alignment.",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "type": "module",
@@ -44,6 +44,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
+    "@pilio/gemini-watermark-remover": "^1.0.41",
     "@resvg/resvg-js": "^2.6.2",
     "commander": "^13.1.0",
     "ffmpeg-static": "^5.2.0",
@@ -53,6 +54,7 @@
     "mime-types": "^2.1.35",
     "open": "^10.1.0",
     "p-limit": "^6.1.0",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "sharp": "^0.35.4"
   }
 }