@jnzlab/easy-ytdlp 1.0.3 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 1.1.0 - 2026-07-27
+
+### Added
+
+- Added a shorter default wizard that keeps common downloads focused on mode, quality, and output folder.
+- Added an advanced-options step for subtitles, playlist handling, filename presets, container preferences, embedded thumbnail/metadata, and SponsorBlock.
+- Added a grouped final summary with readable labels for download, source, output, and extras.
+- Added a final action menu with start, show command, change settings, and cancel actions.
+- Added persisted output-folder preferences so the last destination is reused on future runs.
+- Added support for multiple URLs in one command and `--batch-file` input with blank-line and comment handling.
+- Added compact numbered metadata previews for multi-URL jobs.
+- Added per-URL download progress labels for multi-URL runs.
+- Added non-interactive `--yes` mode with flags for mode, quality, output folder, audio format, subtitles, playlist range, filename preset, embedded metadata/thumbnail, and SponsorBlock.
+
+### Changed
+
+- Downloads for multiple URLs now run one URL at a time, which makes progress and failures easier to understand.
+- CLI version output now matches the package version.
+- Plain video-only downloads no longer warn about missing ffmpeg unless remuxing or post-processing is requested.
+- Saved-file output now uses consistent Clack log formatting.
+- README usage examples now cover multi-URL, batch-file, advanced wizard, and non-interactive workflows.
+
+### Fixed
+
+- Batch-file read failures now show a friendly CLI error instead of a raw Node exception.
+- Multi-URL command preview now explains that the displayed command is for the first URL and will be repeated for each URL.

package/README.md

@@ -22,10 +22,38 @@ easy-ytdlp <url>
 ```bash
 easy-ytdlp                                 # prompts for URL
 easy-ytdlp https://youtu.be/dQw4w9WgXcQ    # start with a URL
+easy-ytdlp <url1> <url2>                  # download multiple URLs with shared settings
+easy-ytdlp --batch-file urls.txt          # read URLs from a file, one per line
 easy-ytdlp <url> --show-command            # preview the yt-dlp flags first
+easy-ytdlp <url> --yes --mode audio --audio-format mp3
 easy-ytdlp update-binary                   # force-refresh the cached yt-dlp binary
 ```
 
+Batch files may include blank lines and comments that start with `#`.
+When multiple URLs are provided, easy-ytdlp fetches metadata for each URL, then asks one set of questions using the first URL with valid metadata as the prompt context.
+The default wizard keeps common downloads short. Choose advanced options to customize subtitles, playlists, filename presets, containers, and embeds.
+
+### Non-interactive options
+
+Use `--yes` to skip prompts and run with defaults plus any flags you provide:
+
+```bash
+easy-ytdlp <url> --yes --mode video --quality 1080 --output ~/Videos
+easy-ytdlp <url> --yes --mode audio --audio-format mp3 --audio-quality good
+easy-ytdlp --batch-file urls.txt --yes --mode video --quality best
+```
+
+Useful flags:
+
+- `--mode video|audio|video-only|subs-only|thumbnail-only`
+- `--quality best|1080|720|480|<height>`
+- `--container best|mp4|mkv|webm`
+- `--audio-format best|mp3|m4a|opus|flac|wav`
+- `--subs none|embed|write|both --sub-langs en,es`
+- `--playlist single|all|range --playlist-range 2:5`
+- `--filename title|title-channel|title-date`
+- `--embed-thumbnail --embed-metadata --sponsorblock`
+
 ### Example session
 
 ![easy-ytdlp demo](https://pub-453eda74623641f7967529680d3689bb.r2.dev/easy-ytdlp-demo.gif)

package/dist/cli.js

@@ -1,6 +1,7 @@
 // src/cli.ts
 import { Command } from "commander";
 import * as p3 from "@clack/prompts";
+import { readFileSync } from "fs";
 
 // src/binary.ts
 import { createWriteStream } from "fs";
@@ -274,7 +275,10 @@ function buildFlags(answers) {
     flags.push("--sponsorblock-remove", "default");
   }
   flags.push("--print", "after_move:filepath");
-  flags.push(answers.url);
+  flags.push(...answers.urls);
+  if (answers.urls.length > 1) {
+    flags.unshift("--ignore-errors");
+  }
   return flags;
 }
 function formatCommand(flags) {
@@ -363,7 +367,8 @@ function ffmpegInstallHint() {
   return lines.join("\n");
 }
 function needsFfmpeg(mode, extras) {
-  if (mode === "video" || mode === "video-only") return true;
+  if (mode === "video") return true;
+  if (mode === "video-only" && extras.remuxVideo) return true;
   if (mode === "audio" || extras.extractAudio) return true;
   if (extras.embedSubs || extras.embedThumbnail) return true;
   return false;
@@ -538,7 +543,7 @@ function parsePostprocessLine(line) {
 function progressFlags() {
   return ["--newline", "--progress"];
 }
-async function runDownload(ytDlp, flags) {
+async function runDownload(ytDlp, flags, options = {}) {
   const filepaths = [];
   let lastError = "";
   let part = 1;
@@ -561,7 +566,7 @@ async function runDownload(ytDlp, flags) {
   );
   let barStarted = false;
   let lastPercent = 0;
-  let phase = "Downloading";
+  let phase = options.label ? `Downloading ${options.label}` : "Downloading";
   const ensureBar = () => {
     if (!barStarted) {
       bar.start(100, 0, {
@@ -577,7 +582,7 @@ async function runDownload(ytDlp, flags) {
     if (!Number.isFinite(percent)) return;
     if (percent + 5 < lastPercent) {
       part += 1;
-      phase = `Downloading (${part})`;
+      phase = options.label ? `Downloading ${options.label} (${part})` : `Downloading (${part})`;
     }
     lastPercent = percent;
     ensureBar();
@@ -613,7 +618,7 @@ async function runDownload(ytDlp, flags) {
       if (lastPercent >= 99) {
         part += 1;
         lastPercent = 0;
-        phase = `Downloading (${part})`;
+        phase = options.label ? `Downloading ${options.label} (${part})` : `Downloading (${part})`;
         ensureBar();
         bar.update(0, {
           phase,
@@ -703,7 +708,28 @@ async function runDownload(ytDlp, flags) {
 // src/questions.ts
 import * as p2 from "@clack/prompts";
 import { homedir } from "os";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
+
+// src/preferences.ts
+import { mkdir as mkdir2, readFile, writeFile } from "fs/promises";
+import { dirname, join as join4 } from "path";
+import envPaths2 from "env-paths";
+var paths2 = envPaths2("easy-ytdlp");
+var PREFS_PATH = join4(paths2.config, "preferences.json");
+async function loadPreferences() {
+  try {
+    const raw = await readFile(PREFS_PATH, "utf-8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+async function savePreferences(prefs) {
+  await mkdir2(dirname(PREFS_PATH), { recursive: true });
+  await writeFile(PREFS_PATH, `${JSON.stringify(prefs, null, 2)}
+`, "utf-8");
+}
 
 // src/ui.ts
 import * as p from "@clack/prompts";
@@ -730,13 +756,15 @@ function wrapLine(line, width) {
 function showNote(body, title) {
   p.note(wrapText(body, contentWidth(14)), title);
 }
-function showSaved(paths2) {
-  p.log.step("Saved");
-  const width = contentWidth(4);
-  for (const filePath of paths2) {
-    for (const line of wrapText(filePath, width).split("\n")) {
-      console.log(`  ${line}`);
-    }
+function showSaved(paths3) {
+  if (paths3.length === 0) return;
+  if (paths3.length === 1) {
+    p.log.success(paths3[0]);
+    return;
+  }
+  p.log.success(`Saved ${paths3.length} files`);
+  for (const filePath of paths3) {
+    p.log.info(filePath);
   }
 }
 function showCommand(command) {
@@ -764,6 +792,9 @@ function looksLikeUrl2(input) {
     return false;
   }
 }
+function splitUrlList(text2) {
+  return text2.split(/[\s,]+/).map((s) => s.trim()).filter(Boolean);
+}
 function formatDuration(seconds) {
   if (seconds == null || Number.isNaN(seconds)) return "unknown duration";
   const h = Math.floor(seconds / 3600);
@@ -803,26 +834,85 @@ function isPlaylistUrl(url, meta) {
     return false;
   }
 }
-async function promptUrl(initial) {
-  if (initial && looksLikeUrl2(initial)) return initial;
-  const url = await p2.text({
-    message: "Paste the video URL",
-    placeholder: "https://www.youtube.com/watch?v=\u2026",
-    initialValue: initial ?? "",
+function modeLabel(mode) {
+  const labels = {
+    video: "Video with audio",
+    audio: "Audio only",
+    "video-only": "Video only",
+    "subs-only": "Subtitles only",
+    "thumbnail-only": "Thumbnail only"
+  };
+  return labels[mode];
+}
+function filenameLabel(preset) {
+  const labels = {
+    title: "Title only",
+    "title-channel": "Title + Channel",
+    "title-date": "Title + Upload Date"
+  };
+  return labels[preset];
+}
+function playlistLabel(playlist) {
+  if (playlist.kind === "single") return "Just this video";
+  if (playlist.kind === "all") return "Whole playlist";
+  return `Playlist items ${playlist.start}:${playlist.stop}`;
+}
+function videoQualityLabel(quality) {
+  if (!quality || quality === "best") return "Best available";
+  if (typeof quality === "object") return `${quality.height}p`;
+  return `Up to ${quality}p`;
+}
+function summarizeAnswers(answers, sourceCount = answers.urls.length) {
+  const lines = [
+    "Download",
+    `  Mode        ${modeLabel(answers.mode)}`,
+    answers.mode === "video" || answers.mode === "video-only" ? `  Quality     ${videoQualityLabel(answers.videoQuality)}` : null,
+    answers.container ? `  Container   ${answers.container}` : null,
+    answers.mode === "audio" ? `  Audio       ${answers.audioFormat ?? "best"} (${answers.audioQuality ?? "best"})` : null,
+    "",
+    "Sources",
+    `  URLs        ${sourceCount}`,
+    `  Playlist    ${playlistLabel(answers.playlist)}`,
+    "",
+    "Output",
+    `  Folder      ${answers.outputDir}`,
+    `  Filename    ${filenameLabel(answers.filenamePreset)}`,
+    "",
+    "Extras",
+    answers.subtitles.mode !== "none" ? `  Subtitles   ${answers.subtitles.mode} [${answers.subtitles.languages.join(", ")}]` : "  Subtitles   none",
+    answers.embedThumbnail ? "  Thumbnail   embed" : null,
+    answers.embedMetadata ? "  Metadata    embed" : null,
+    answers.sponsorBlock ? "  SponsorBlock remove segments" : null
+  ];
+  return lines.filter((line) => line != null).join("\n");
+}
+async function promptUrls(initial) {
+  if (initial && initial.length > 0) {
+    for (const u of initial) {
+      if (!looksLikeUrl2(u)) {
+        p2.log.error(`Invalid URL: ${u}`);
+        process.exit(1);
+      }
+    }
+    return initial;
+  }
+  const input = await p2.text({
+    message: "Paste video URL(s)",
+    placeholder: "One or more URLs, separated by spaces or commas",
+    initialValue: "",
     validate: (v) => {
-      if (!v?.trim()) return "URL is required";
-      if (!looksLikeUrl2(v.trim())) return "That does not look like a valid http(s) URL";
+      if (!v?.trim()) return "At least one URL is required";
+      const urls = splitUrlList(v.trim());
+      if (urls.length === 0) return "At least one valid URL is required";
+      for (const u of urls) {
+        if (!looksLikeUrl2(u)) return `Invalid URL: ${u}`;
+      }
     }
   });
-  exitOnCancel(url);
-  return String(url).trim();
+  exitOnCancel(input);
+  return splitUrlList(String(input).trim());
 }
 async function askQuestions(url, meta) {
-  const title = meta.title ?? "Unknown title";
-  const uploader = meta.uploader ?? "Unknown uploader";
-  const duration = formatDuration(meta.duration);
-  showNote(`${title}
-by ${uploader} \xB7 ${duration}`, "Found");
   const mode = await p2.select({
     message: "What do you want to download?",
     options: [
@@ -834,11 +924,17 @@ by ${uploader} \xB7 ${duration}`, "Found");
     ]
   });
   exitOnCancel(mode);
+  const selectedMode = mode;
   let videoQuality;
-  let container;
+  let container = selectedMode === "video" || selectedMode === "video-only" ? "best" : void 0;
   let audioFormat;
   let audioQuality;
-  if (mode === "video" || mode === "video-only") {
+  let subMode = "none";
+  let subLangs = [];
+  let playlist = { kind: "single" };
+  let filenamePreset = "title";
+  let extras = [];
+  if (selectedMode === "video" || selectedMode === "video-only") {
     const resolutions = availableResolutions(meta);
     const qualityOpts = [
       { value: "best", label: "Best available" },
@@ -872,19 +968,8 @@ by ${uploader} \xB7 ${duration}`, "Found");
     } else {
       videoQuality = q;
     }
-    const c = await p2.select({
-      message: "Container preference?",
-      options: [
-        { value: "best", label: "Best available" },
-        { value: "mp4", label: "mp4" },
-        { value: "mkv", label: "mkv" },
-        { value: "webm", label: "webm" }
-      ]
-    });
-    exitOnCancel(c);
-    container = c;
   }
-  if (mode === "audio") {
+  if (selectedMode === "audio") {
     const fmt = await p2.select({
       message: "Audio format?",
       options: [
@@ -908,9 +993,7 @@ by ${uploader} \xB7 ${duration}`, "Found");
     exitOnCancel(aq);
     audioQuality = aq;
   }
-  let subMode = "none";
-  let subLangs = [];
-  if (mode === "subs-only") {
+  if (selectedMode === "subs-only") {
     subMode = "write";
     const langs = availableSubtitleLangs(meta);
     if (langs.length === 0) {
@@ -929,7 +1012,36 @@ by ${uploader} \xB7 ${duration}`, "Found");
       const sel = picked;
       subLangs = sel.includes("all") ? ["all"] : sel;
     }
-  } else if (mode !== "thumbnail-only") {
+  }
+  const prefs = await loadPreferences();
+  const defaultDir = prefs.outputDir ?? join5(homedir(), "Downloads");
+  const outDir = await p2.text({
+    message: "Destination folder",
+    initialValue: defaultDir,
+    validate: (v) => !v?.trim() ? "Folder is required" : void 0
+  });
+  exitOnCancel(outDir);
+  const outputDir = String(outDir).trim();
+  await savePreferences({ ...prefs, outputDir });
+  const customize = selectedMode === "subs-only" || selectedMode === "thumbnail-only" ? false : await p2.confirm({
+    message: "Customize advanced options?",
+    initialValue: false
+  });
+  exitOnCancel(customize);
+  if (customize && (selectedMode === "video" || selectedMode === "video-only")) {
+    const c = await p2.select({
+      message: "Container preference?",
+      options: [
+        { value: "best", label: "Best available" },
+        { value: "mp4", label: "mp4" },
+        { value: "mkv", label: "mkv" },
+        { value: "webm", label: "webm" }
+      ]
+    });
+    exitOnCancel(c);
+    container = c;
+  }
+  if (customize && selectedMode !== "thumbnail-only") {
     const wantSubs = await p2.confirm({
       message: "Download subtitles?",
       initialValue: false
@@ -964,71 +1076,62 @@ by ${uploader} \xB7 ${duration}`, "Found");
       exitOnCancel(how);
       subMode = how;
     }
-  }
-  let playlist = { kind: "single" };
-  if (isPlaylistUrl(url, meta)) {
-    const pl = await p2.select({
-      message: "This URL is part of a playlist. What should we download?",
+    if (isPlaylistUrl(url, meta)) {
+      const pl = await p2.select({
+        message: "This URL is part of a playlist. What should we download?",
+        options: [
+          { value: "single", label: "Just this video" },
+          { value: "all", label: "Whole playlist" },
+          { value: "range", label: "A specific range" }
+        ]
+      });
+      exitOnCancel(pl);
+      if (pl === "single") {
+        playlist = { kind: "single" };
+      } else if (pl === "all") {
+        playlist = { kind: "all" };
+      } else {
+        const start = await p2.text({
+          message: "Playlist start index (1-based)",
+          initialValue: "1",
+          validate: (v) => {
+            const n = Number(v);
+            if (!Number.isInteger(n) || n < 1) return "Enter a positive integer";
+          }
+        });
+        exitOnCancel(start);
+        const stop = await p2.text({
+          message: "Playlist stop index (inclusive)",
+          initialValue: String(meta.playlist_count ?? 10),
+          validate: (v) => {
+            const n = Number(v);
+            if (!Number.isInteger(n) || n < 1) return "Enter a positive integer";
+          }
+        });
+        exitOnCancel(stop);
+        playlist = {
+          kind: "range",
+          start: Number(start),
+          stop: Number(stop)
+        };
+      }
+    }
+    const pickedFilename = await p2.select({
+      message: "Filename style?",
       options: [
-        { value: "single", label: "Just this video" },
-        { value: "all", label: "Whole playlist" },
-        { value: "range", label: "A specific range" }
+        { value: "title", label: "Title only" },
+        {
+          value: "title-channel",
+          label: "Title + Channel"
+        },
+        {
+          value: "title-date",
+          label: "Title + Upload Date"
+        }
       ]
     });
-    exitOnCancel(pl);
-    if (pl === "single") {
-      playlist = { kind: "single" };
-    } else if (pl === "all") {
-      playlist = { kind: "all" };
-    } else {
-      const start = await p2.text({
-        message: "Playlist start index (1-based)",
-        initialValue: "1",
-        validate: (v) => {
-          const n = Number(v);
-          if (!Number.isInteger(n) || n < 1) return "Enter a positive integer";
-        }
-      });
-      exitOnCancel(start);
-      const stop = await p2.text({
-        message: "Playlist stop index (inclusive)",
-        initialValue: String(meta.playlist_count ?? 10),
-        validate: (v) => {
-          const n = Number(v);
-          if (!Number.isInteger(n) || n < 1) return "Enter a positive integer";
-        }
-      });
-      exitOnCancel(stop);
-      playlist = {
-        kind: "range",
-        start: Number(start),
-        stop: Number(stop)
-      };
-    }
-  }
-  const defaultDir = join4(homedir(), "Downloads");
-  const outDir = await p2.text({
-    message: "Destination folder",
-    initialValue: defaultDir,
-    validate: (v) => !v?.trim() ? "Folder is required" : void 0
-  });
-  exitOnCancel(outDir);
-  const filenamePreset = await p2.select({
-    message: "Filename style?",
-    options: [
-      { value: "title", label: "Title only" },
-      {
-        value: "title-channel",
-        label: "Title + Channel"
-      },
-      {
-        value: "title-date",
-        label: "Title + Upload Date"
-      }
-    ]
-  });
-  exitOnCancel(filenamePreset);
-  const extras = mode === "subs-only" || mode === "thumbnail-only" ? [] : await (async () => {
+    exitOnCancel(pickedFilename);
+    filenamePreset = pickedFilename;
     const e = await p2.multiselect({
       message: "Extras (optional)",
       options: [
@@ -1045,29 +1148,10 @@ by ${uploader} \xB7 ${duration}`, "Found");
       required: false
     });
     exitOnCancel(e);
-    return e;
-  })();
-  const selectedMode = mode;
-  const selectedFilename = filenamePreset;
-  const summaryLines = [
-    `Mode: ${selectedMode}`,
-    videoQuality ? `Quality: ${typeof videoQuality === "object" ? `${videoQuality.height}p` : videoQuality}` : null,
-    container ? `Container: ${container}` : null,
-    audioFormat ? `Audio: ${audioFormat} (${audioQuality ?? "best"})` : null,
-    subMode !== "none" ? `Subtitles: ${subMode} [${subLangs.join(", ")}]` : "Subtitles: none",
-    `Playlist: ${playlist.kind}${playlist.kind === "range" ? ` ${playlist.start}:${playlist.stop}` : ""}`,
-    `Output: ${String(outDir).trim()}`,
-    `Filename: ${selectedFilename}`,
-    extras.length ? `Extras: ${extras.join(", ")}` : "Extras: none"
-  ].filter(Boolean).join("\n");
-  showNote(summaryLines, "Summary");
-  const showCmd = await p2.confirm({
-    message: "Show the yt-dlp command before downloading?",
-    initialValue: false
-  });
-  exitOnCancel(showCmd);
-  return {
-    url,
+    extras = e;
+  }
+  const answers = {
+    urls: [url],
     mode: selectedMode,
     videoQuality,
     container,
@@ -1078,17 +1162,193 @@ by ${uploader} \xB7 ${duration}`, "Found");
       languages: subLangs
     },
     playlist,
-    outputDir: String(outDir).trim(),
-    filenamePreset: selectedFilename,
+    outputDir,
+    filenamePreset,
     embedThumbnail: extras.includes("thumbnail"),
     embedMetadata: extras.includes("metadata"),
     sponsorBlock: extras.includes("sponsorblock"),
-    showCommand: Boolean(showCmd)
+    showCommand: false
   };
+  showNote(summarizeAnswers(answers), "Summary");
+  return answers;
 }
 
 // src/cli.ts
-async function runWizard(urlArg, opts = {}) {
+var CLI_VERSION = "1.1.0";
+function fail(message) {
+  p3.log.error(message);
+  process.exit(1);
+}
+function pick(value, allowed, name, fallback) {
+  if (value == null) return fallback;
+  if (allowed.includes(value)) return value;
+  fail(`Invalid ${name}: ${value}. Expected one of: ${allowed.join(", ")}`);
+}
+function parseQuality(value) {
+  if (!value || value === "best") return "best";
+  if (value === "1080" || value === "720" || value === "480") return value;
+  const height = Number(value.replace(/p$/i, ""));
+  if (Number.isInteger(height) && height > 0) return { height };
+  fail(`Invalid quality: ${value}. Use best, 1080, 720, 480, or a height like 1440.`);
+}
+function parsePlaylist(options) {
+  const kind = pick(
+    options.playlist,
+    ["single", "all", "range"],
+    "playlist",
+    "single"
+  );
+  if (kind !== "range") return { kind };
+  if (!options.playlistRange) {
+    fail("--playlist range requires --playlist-range <start:stop>");
+  }
+  const [startRaw, stopRaw] = options.playlistRange.split(":");
+  const start = Number(startRaw);
+  const stop = Number(stopRaw);
+  if (!Number.isInteger(start) || !Number.isInteger(stop) || start < 1 || stop < start) {
+    fail("Invalid --playlist-range. Use a 1-based inclusive range like 2:5.");
+  }
+  return { kind: "range", start, stop };
+}
+function parseLanguages(value) {
+  return value ? value.split(",").map((lang) => lang.trim()).filter(Boolean) : [];
+}
+function compactTitle(title, max = 72) {
+  return title.length > max ? `${title.slice(0, max - 1)}\u2026` : title;
+}
+function answersFromOptions(urls, options) {
+  const mode = pick(
+    options.mode,
+    ["video", "audio", "video-only", "subs-only", "thumbnail-only"],
+    "mode",
+    "video"
+  );
+  const subtitlesMode = pick(
+    options.subs,
+    ["none", "embed", "write", "both"],
+    "subs",
+    mode === "subs-only" ? "write" : "none"
+  );
+  return {
+    urls,
+    mode,
+    videoQuality: mode === "video" || mode === "video-only" ? parseQuality(options.quality) : void 0,
+    container: mode === "video" || mode === "video-only" ? pick(
+      options.container,
+      ["best", "mp4", "mkv", "webm"],
+      "container",
+      "best"
+    ) : void 0,
+    audioFormat: mode === "audio" ? pick(
+      options.audioFormat,
+      ["best", "mp3", "m4a", "opus", "flac", "wav"],
+      "audio-format",
+      "best"
+    ) : void 0,
+    audioQuality: mode === "audio" ? pick(
+      options.audioQuality,
+      ["best", "good"],
+      "audio-quality",
+      "best"
+    ) : void 0,
+    subtitles: {
+      mode: subtitlesMode,
+      languages: parseLanguages(options.subLangs)
+    },
+    playlist: parsePlaylist(options),
+    outputDir: options.output ?? process.cwd(),
+    filenamePreset: pick(
+      options.filename,
+      ["title", "title-channel", "title-date"],
+      "filename",
+      "title"
+    ),
+    embedThumbnail: Boolean(options.embedThumbnail),
+    embedMetadata: Boolean(options.embedMetadata),
+    sponsorBlock: Boolean(options.sponsorblock),
+    showCommand: Boolean(options.showCommand)
+  };
+}
+function displayFlagsForAnswers(answers) {
+  const urls = answers.urls.length > 1 ? [answers.urls[0]] : answers.urls;
+  return [
+    ...youtubeCompatFlags(),
+    ...progressFlags(),
+    ...buildFlags({ ...answers, urls })
+  ];
+}
+function showCommandForAnswers(answers) {
+  if (answers.urls.length > 1) {
+    p3.log.info("Showing the command for the first URL. It will be repeated for each URL.");
+  }
+  showCommand(formatCommand(displayFlagsForAnswers(answers)));
+}
+async function confirmStart(answers) {
+  while (true) {
+    const action = await p3.select({
+      message: "Ready?",
+      options: [
+        { value: "start", label: "Start download" },
+        { value: "show-command", label: "Show yt-dlp command" },
+        { value: "change", label: "Change settings" },
+        { value: "cancel", label: "Cancel" }
+      ]
+    });
+    if (p3.isCancel(action) || action === "cancel") {
+      p3.cancel("Cancelled.");
+      process.exit(0);
+    }
+    if (action === "show-command") {
+      showCommandForAnswers(answers);
+      continue;
+    }
+    return action;
+  }
+}
+async function ensureFfmpegIfNeeded(answers) {
+  if (!needsFfmpeg(answers.mode, {
+    embedSubs: answers.subtitles.mode === "embed" || answers.subtitles.mode === "both",
+    embedThumbnail: answers.embedThumbnail,
+    extractAudio: answers.mode === "audio",
+    remuxVideo: answers.container != null && answers.container !== "best"
+  })) {
+    return;
+  }
+  const status = await checkFfmpeg();
+  if (status.ok) return;
+  p3.log.warn(
+    [
+      "ffmpeg/ffprobe not found on PATH.",
+      ffmpegInstallHint()
+    ].join("\n\n")
+  );
+  const cont = await p3.confirm({
+    message: "Continue anyway? (download may fail at merge/extract)",
+    initialValue: false
+  });
+  if (p3.isCancel(cont) || !cont) {
+    p3.cancel("Cancelled.");
+    process.exit(0);
+  }
+}
+async function runDownloads(ytDlp, answers) {
+  const allPaths = [];
+  for (let i = 0; i < answers.urls.length; i++) {
+    const url = answers.urls[i];
+    const label = answers.urls.length > 1 ? `${i + 1} of ${answers.urls.length}` : void 0;
+    const flags = buildFlags({ ...answers, urls: [url] });
+    if (label) p3.log.info(`Download ${label}`);
+    try {
+      const result = await runDownload(ytDlp, flags, { label });
+      allPaths.push(...result.filepaths);
+    } catch (err) {
+      if (answers.urls.length === 1) throw err;
+      p3.log.warn(err instanceof Error ? err.message : String(err));
+    }
+  }
+  return allPaths;
+}
+async function runWizard(urlsArg, opts = {}) {
   p3.intro("easy-ytdlp");
   const spinner2 = p3.spinner();
   spinner2.start("Preparing yt-dlp binary\u2026");
@@ -1105,75 +1365,98 @@ async function runWizard(urlArg, opts = {}) {
     p3.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
-  const url = await promptUrl(urlArg);
+  const urls = await promptUrls(urlsArg);
+  if (opts.yes) {
+    const answers2 = answersFromOptions(urls, opts);
+    showNote(summarizeAnswers(answers2), "Summary");
+    if (answers2.showCommand) {
+      showCommandForAnswers(answers2);
+    }
+    await ensureFfmpegIfNeeded(answers2);
+    p3.log.info("Starting download\u2026");
+    try {
+      const filepaths = await runDownloads(ytDlp, answers2);
+      if (filepaths.length > 0) {
+        showSaved(filepaths);
+      } else {
+        p3.log.success("Done. (No filepath printed \u2014 check your output folder.)");
+        p3.log.info(`Output folder: ${answers2.outputDir}`);
+      }
+      p3.outro("Finished");
+    } catch (err) {
+      p3.log.error(err instanceof Error ? err.message : String(err));
+      p3.outro("Failed");
+      process.exit(1);
+    }
+    return;
+  }
   spinner2.start("Fetching video info\u2026");
-  let meta;
-  try {
-    meta = await fetchMetadata(ytDlp, url);
-    spinner2.stop("Metadata loaded");
-  } catch (err) {
+  const metaResults = await Promise.allSettled(
+    urls.map((u) => fetchMetadata(ytDlp, u))
+  );
+  const videoInfos = [];
+  const failedUrls = [];
+  for (let i = 0; i < metaResults.length; i++) {
+    const r = metaResults[i];
+    const u = urls[i];
+    if (r.status === "fulfilled") {
+      const m = r.value;
+      videoInfos.push({
+        url: u,
+        meta: m,
+        title: m.title ?? "Unknown title",
+        uploader: m.uploader ?? "Unknown uploader",
+        duration: formatDuration(m.duration)
+      });
+    } else {
+      failedUrls.push(u);
+    }
+  }
+  if (videoInfos.length === 0) {
     spinner2.stop("Could not fetch metadata");
-    p3.log.error(err instanceof Error ? err.message : String(err));
+    p3.log.error("Failed to fetch metadata for any of the provided URLs.");
     process.exit(1);
   }
-  const answers = await askQuestions(url, meta);
-  if (opts.showCommand) {
-    answers.showCommand = true;
-  }
-  const flags = buildFlags(answers);
-  const displayFlags = [
-    ...youtubeCompatFlags(),
-    ...progressFlags(),
-    ...flags
-  ];
-  if (answers.showCommand) {
-    showCommand(formatCommand(displayFlags));
-    const proceed = await p3.confirm({
-      message: "Run this command?",
-      initialValue: true
-    });
-    if (p3.isCancel(proceed) || !proceed) {
-      p3.cancel("Cancelled.");
-      process.exit(0);
-    }
+  spinner2.stop("Metadata loaded");
+  if (videoInfos.length === 1) {
+    const v = videoInfos[0];
+    showNote(`${v.title}
+by ${v.uploader} \xB7 ${v.duration}`, "Found");
   } else {
-    const proceed = await p3.confirm({
-      message: "Start download?",
-      initialValue: true
-    });
-    if (p3.isCancel(proceed) || !proceed) {
-      p3.cancel("Cancelled.");
-      process.exit(0);
-    }
+    const lines = videoInfos.map(
+      (v, index) => `${index + 1}. ${compactTitle(v.title)}
+   by ${v.uploader} \xB7 ${v.duration}`
+    );
+    showNote(lines.join("\n\n"), `Found (${videoInfos.length} videos)`);
   }
-  if (needsFfmpeg(answers.mode, {
-    embedSubs: answers.subtitles.mode === "embed" || answers.subtitles.mode === "both",
-    embedThumbnail: answers.embedThumbnail,
-    extractAudio: answers.mode === "audio"
-  })) {
-    const status = await checkFfmpeg();
-    if (!status.ok) {
-      p3.log.warn(
-        [
-          "ffmpeg/ffprobe not found on PATH.",
-          ffmpegInstallHint()
-        ].join("\n\n")
-      );
-      const cont = await p3.confirm({
-        message: "Continue anyway? (download may fail at merge/extract)",
-        initialValue: false
-      });
-      if (p3.isCancel(cont) || !cont) {
-        p3.cancel("Cancelled.");
-        process.exit(0);
-      }
+  if (failedUrls.length > 0) {
+    p3.log.warn(
+      `Could not fetch metadata for ${failedUrls.length} URL(s). They will still be downloaded with shared settings.`
+    );
+  }
+  const primary = videoInfos[0];
+  if (urls.length > 1) {
+    p3.log.info(`Using shared settings based on: ${primary.title}`);
+  }
+  let answers;
+  while (true) {
+    answers = await askQuestions(primary.url, primary.meta);
+    answers.urls = urls;
+    if (opts.showCommand) {
+      answers.showCommand = true;
     }
+    if (answers.showCommand) {
+      showCommandForAnswers(answers);
+    }
+    const action = await confirmStart(answers);
+    if (action === "start") break;
   }
+  await ensureFfmpegIfNeeded(answers);
   p3.log.info("Starting download\u2026");
   try {
-    const result = await runDownload(ytDlp, flags);
-    if (result.filepaths.length > 0) {
-      showSaved(result.filepaths);
+    const filepaths = await runDownloads(ytDlp, answers);
+    if (filepaths.length > 0) {
+      showSaved(filepaths);
     } else {
       p3.log.success("Done. (No filepath printed \u2014 check your output folder.)");
       p3.log.info(`Output folder: ${answers.outputDir}`);
@@ -1202,11 +1485,35 @@ async function runUpdateBinary() {
 var program = new Command();
 program.name("easy-ytdlp").description(
   "Interactive, user-friendly wrapper around yt-dlp \u2014 no flag memorization required"
-).version("1.0.0").argument("[url]", "Video URL (prompted if omitted)").option(
+).version(CLI_VERSION).argument("[urls...]", "One or more video URLs (prompted if omitted)").option(
   "--show-command",
   "Always show the generated yt-dlp command before running"
-).action(async (url, options) => {
-  await runWizard(url, { showCommand: options.showCommand });
+).option(
+  "-a, --batch-file <path>",
+  "File containing URLs to download, one per line"
+).option("-y, --yes", "Run without interactive prompts using defaults/options").option(
+  "--mode <mode>",
+  "Download mode: video, audio, video-only, subs-only, thumbnail-only"
+).option("--quality <quality>", "Video quality: best, 1080, 720, 480, or height").option("--container <container>", "Container: best, mp4, mkv, webm").option("--audio-format <format>", "Audio format: best, mp3, m4a, opus, flac, wav").option("--audio-quality <quality>", "Audio quality: best, good").option("-o, --output <dir>", "Destination folder").option("--filename <preset>", "Filename preset: title, title-channel, title-date").option("--subs <mode>", "Subtitle mode: none, embed, write, both").option("--sub-langs <langs>", "Comma-separated subtitle languages, for example en,es").option("--playlist <mode>", "Playlist mode: single, all, range").option("--playlist-range <range>", "Playlist range for --playlist range, for example 2:5").option("--embed-thumbnail", "Embed thumbnail as cover art").option("--embed-metadata", "Embed metadata").option("--sponsorblock", "Remove SponsorBlock default segments").action(async (urls, options) => {
+  let allUrls = urls ?? [];
+  if (options.batchFile) {
+    let content;
+    try {
+      content = readFileSync(options.batchFile, "utf-8");
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      p3.log.error(`Could not read batch file "${options.batchFile}": ${detail}`);
+      process.exit(1);
+    }
+    const fileUrls = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+    allUrls = [...allUrls, ...fileUrls];
+  }
+  if (options.yes && allUrls.length === 0) {
+    fail("--yes requires at least one URL or --batch-file.");
+  }
+  await runWizard(allUrls.length > 0 ? allUrls : void 0, {
+    ...options
+  });
 });
 program.command("update-binary").description("Force-refresh the cached yt-dlp binary").action(async () => {
   await runUpdateBinary();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnzlab/easy-ytdlp",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A user-friendly interactive CLI wrapper for yt-dlp — no Python or flag memorization required",
   "type": "module",
   "main": "./dist/cli.js",
@@ -15,6 +15,7 @@
     "bin",
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {
@@ -36,6 +37,14 @@
     "video"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jnzlab/easy-ytdlp.git"
+  },
+  "homepage": "https://github.com/jnzlab/easy-ytdlp#readme",
+  "bugs": {
+    "url": "https://github.com/jnzlab/easy-ytdlp/issues"
+  },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
     "cli-progress": "^3.12.0",