@jnzlab/easy-ytdlp 1.1.4 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.2.0 - 2026-09-18
+
+### Added
+
+- When a download or metadata fetch fails because YouTube's JS challenge could
+  not be solved, easy-ytdlp now offers to install Deno for you
+  (`curl -fsSL https://deno.land/install.sh | sh`, or the PowerShell one-liner
+  on Windows) and retries automatically once it is installed. Declining prints
+  the command so you can install it yourself and come back.
+- yt-dlp is now pointed at a Deno binary in `~/.deno/bin` even when that
+  directory is not yet on `PATH` (which is the case right after installing it).
+
 ## 1.1.4 - 2026-09-08
 
 ### Fixed

package/dist/cli.js

@@ -1,6 +1,6 @@
 // src/cli.ts
 import { Command } from "commander";
-import * as p3 from "@clack/prompts";
+import * as p4 from "@clack/prompts";
 import { readFileSync } from "fs";
 
 // src/binary.ts
@@ -252,16 +252,179 @@ function needsFfmpeg(mode, extras) {
 }
 
 // src/youtube-compat.ts
-import { accessSync, constants as constants3, readdirSync } from "fs";
-import { join as join3 } from "path";
+import { accessSync as accessSync2, constants as constants4, readdirSync } from "fs";
+import { join as join4 } from "path";
+
+// src/deno.ts
+import { spawn } from "child_process";
+import { accessSync, constants as constants3 } from "fs";
+import { homedir, platform as platform3 } from "os";
+import { delimiter as delimiter2, dirname, join as join3 } from "path";
+import * as p2 from "@clack/prompts";
+
+// src/ui.ts
+import * as p from "@clack/prompts";
+function contentWidth(pad = 8) {
+  const cols = process.stdout.columns ?? 80;
+  return Math.max(40, cols - pad);
+}
+function wrapText(text2, width = contentWidth()) {
+  return text2.split(/\r?\n/).flatMap((line) => wrapLine(line, width)).join("\n");
+}
+function wrapLine(line, width) {
+  if (line.length <= width) return [line || " "];
+  const out = [];
+  let rest = line;
+  while (rest.length > width) {
+    let breakAt = rest.lastIndexOf(" ", width);
+    if (breakAt < Math.floor(width * 0.5)) breakAt = width;
+    out.push(rest.slice(0, breakAt).trimEnd());
+    rest = rest.slice(breakAt).trimStart();
+  }
+  if (rest.length) out.push(rest);
+  return out;
+}
+function showNote(body, title) {
+  p.note(wrapText(body, contentWidth(14)), title);
+}
+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) {
+  p.log.step("yt-dlp command");
+  for (const line of wrapText(command, contentWidth(4)).split("\n")) {
+    console.log(`  ${line}`);
+  }
+}
+
+// src/deno.ts
+var INSTALL_SH = "curl -fsSL https://deno.land/install.sh | sh";
+var INSTALL_PS = "irm https://deno.land/install.ps1 | iex";
+function isJsRuntimeError(message) {
+  const lower = message.toLowerCase();
+  return lower.includes("http error 403") || lower.includes("403: forbidden") || lower.includes("javascript runtime") || lower.includes("js challenge") || lower.includes("n challenge");
+}
+function denoInstallCommand() {
+  return platform3() === "win32" ? INSTALL_PS : INSTALL_SH;
+}
+function isExecutable2(filePath) {
+  try {
+    accessSync(filePath, constants3.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function denoFilename() {
+  return platform3() === "win32" ? "deno.exe" : "deno";
+}
+function knownDenoDirs() {
+  const dirs = [];
+  if (process.env.DENO_INSTALL) dirs.push(join3(process.env.DENO_INSTALL, "bin"));
+  if (process.env.DENO_INSTALL_ROOT) dirs.push(process.env.DENO_INSTALL_ROOT);
+  const home = homedir();
+  if (home) dirs.push(join3(home, ".deno", "bin"));
+  return dirs;
+}
+function findDeno() {
+  const name = denoFilename();
+  const dirs = [
+    ...(process.env.PATH ?? "").split(delimiter2).filter(Boolean),
+    ...knownDenoDirs()
+  ];
+  for (const dir of dirs) {
+    const candidate = join3(dir, name);
+    if (isExecutable2(candidate)) return candidate;
+  }
+  return null;
+}
+function ensureDenoOnPath(denoPath) {
+  const dir = dirname(denoPath);
+  const entries = (process.env.PATH ?? "").split(delimiter2);
+  if (entries.includes(dir)) return;
+  process.env.PATH = [dir, ...entries].filter(Boolean).join(delimiter2);
+}
+function showManualInstructions() {
+  showNote(
+    [
+      "Install Deno yourself with:",
+      "",
+      `  ${denoInstallCommand()}`,
+      "",
+      "Then re-run easy-ytdlp \u2014 it will pick Deno up automatically."
+    ].join("\n"),
+    "Install Deno"
+  );
+}
+function runInstallCommand() {
+  const isWindows = platform3() === "win32";
+  const command = isWindows ? "powershell.exe" : "sh";
+  const args = isWindows ? ["-NoProfile", "-Command", INSTALL_PS] : ["-c", INSTALL_SH];
+  return new Promise((resolve) => {
+    const child = spawn(command, args, { stdio: "inherit" });
+    child.on("error", (err) => {
+      p2.log.error(`Could not run the installer: ${err.message}`);
+      resolve(false);
+    });
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+async function offerDenoInstall(options = {}) {
+  const existing = findDeno();
+  if (existing) {
+    ensureDenoOnPath(existing);
+    p2.log.info(`Found Deno at ${existing} \u2014 using it for this run.`);
+    return true;
+  }
+  if (options.canPrompt === false || !process.stdin.isTTY) {
+    showManualInstructions();
+    return false;
+  }
+  p2.log.info(`Install command: ${denoInstallCommand()}`);
+  const answer = await p2.confirm({
+    message: "Install Deno now?",
+    initialValue: true
+  });
+  if (p2.isCancel(answer) || !answer) {
+    showManualInstructions();
+    return false;
+  }
+  p2.log.step("Installing Deno\u2026");
+  const ok = await runInstallCommand();
+  if (!ok) {
+    p2.log.error("Deno installation failed.");
+    showManualInstructions();
+    return false;
+  }
+  const installed = findDeno();
+  if (!installed) {
+    p2.log.warn(
+      "The installer finished but no deno binary was found. Open a new terminal and re-run easy-ytdlp."
+    );
+    return false;
+  }
+  ensureDenoOnPath(installed);
+  p2.log.success(`Deno installed: ${installed}`);
+  return true;
+}
+
+// src/youtube-compat.ts
 var MIN_RECOMMENDED_MAJOR = 22;
 function nodeMajor(version) {
   const m = version.replace(/^v/, "").split(".")[0];
   return Number(m) || 0;
 }
-function isExecutable2(filePath) {
+function isExecutable3(filePath) {
   try {
-    accessSync(filePath, constants3.X_OK);
+    accessSync2(filePath, constants4.X_OK);
     return true;
   } catch {
     return false;
@@ -274,7 +437,7 @@ function resolveNodeForYtDlp() {
   }
   const nvmDir = process.env.NVM_DIR;
   if (nvmDir) {
-    const versionsRoot = join3(nvmDir, "versions", "node");
+    const versionsRoot = join4(nvmDir, "versions", "node");
     try {
       const dirs = readdirSync(versionsRoot).filter((name) => /^v\d+\.\d+\.\d+$/.test(name)).sort((a, b) => {
         const pa = a.slice(1).split(".").map(Number);
@@ -288,8 +451,8 @@ function resolveNodeForYtDlp() {
       for (const dir of dirs) {
         const major = nodeMajor(dir);
         if (major < MIN_RECOMMENDED_MAJOR) continue;
-        const candidate = join3(versionsRoot, dir, "bin", "node");
-        if (isExecutable2(candidate)) {
+        const candidate = join4(versionsRoot, dir, "bin", "node");
+        if (isExecutable3(candidate)) {
           return { path: candidate, major };
         }
       }
@@ -300,7 +463,9 @@ function resolveNodeForYtDlp() {
 }
 function youtubeCompatFlags() {
   const { path } = resolveNodeForYtDlp();
+  const deno = findDeno();
   return [
+    ...deno ? ["--js-runtimes", `deno:${deno}`] : [],
     "--js-runtimes",
     `node:${path}`,
     // Fallback if the cached binary's bundled EJS scripts are missing/outdated
@@ -326,14 +491,15 @@ function humanizeError(raw) {
       `yt-dlp said: ${raw.trim()}`
     ].join("\n");
   }
-  if (lower.includes("http error 403") || lower.includes("403: forbidden") || lower.includes("javascript runtime") || lower.includes("js challenge") || lower.includes("n challenge")) {
+  if (isJsRuntimeError(lower)) {
     return [
       "YouTube blocked the download (often HTTP 403) \u2014 usually because a JavaScript runtime is needed to solve YouTube challenges.",
       "",
-      "easy-ytdlp now enables Node automatically. If this still fails:",
+      "easy-ytdlp enables Node automatically, but yt-dlp solves these challenges most reliably with Deno.",
+      "",
+      "If Deno does not help, also try:",
       "  1. Update the yt-dlp binary:  easy-ytdlp update-binary",
       "  2. Use Node 22+ (recommended by yt-dlp for the JS solver)",
-      "  3. Or install Deno: https://deno.land  (yt-dlp\u2019s preferred runtime)",
       "",
       "More detail: https://github.com/yt-dlp/yt-dlp/wiki/EJS",
       "",
@@ -760,16 +926,16 @@ function looksLikeUrl(s) {
 }
 
 // src/questions.ts
-import * as p2 from "@clack/prompts";
-import { homedir } from "os";
-import { join as join5 } from "path";
+import * as p3 from "@clack/prompts";
+import { homedir as homedir2 } from "os";
+import { join as join6 } from "path";
 
 // src/preferences.ts
 import { mkdir as mkdir2, readFile, writeFile } from "fs/promises";
-import { dirname, join as join4 } from "path";
+import { dirname as dirname2, join as join5 } from "path";
 import envPaths2 from "env-paths";
 var paths2 = envPaths2("easy-ytdlp");
-var PREFS_PATH = join4(paths2.config, "preferences.json");
+var PREFS_PATH = join5(paths2.config, "preferences.json");
 async function loadPreferences() {
   try {
     const raw = await readFile(PREFS_PATH, "utf-8");
@@ -780,61 +946,18 @@ async function loadPreferences() {
   }
 }
 async function savePreferences(prefs) {
-  await mkdir2(dirname(PREFS_PATH), { recursive: true });
+  await mkdir2(dirname2(PREFS_PATH), { recursive: true });
   await writeFile(PREFS_PATH, `${JSON.stringify(prefs, null, 2)}
 `, "utf-8");
 }
 
-// src/ui.ts
-import * as p from "@clack/prompts";
-function contentWidth(pad = 8) {
-  const cols = process.stdout.columns ?? 80;
-  return Math.max(40, cols - pad);
-}
-function wrapText(text2, width = contentWidth()) {
-  return text2.split(/\r?\n/).flatMap((line) => wrapLine(line, width)).join("\n");
-}
-function wrapLine(line, width) {
-  if (line.length <= width) return [line || " "];
-  const out = [];
-  let rest = line;
-  while (rest.length > width) {
-    let breakAt = rest.lastIndexOf(" ", width);
-    if (breakAt < Math.floor(width * 0.5)) breakAt = width;
-    out.push(rest.slice(0, breakAt).trimEnd());
-    rest = rest.slice(breakAt).trimStart();
-  }
-  if (rest.length) out.push(rest);
-  return out;
-}
-function showNote(body, title) {
-  p.note(wrapText(body, contentWidth(14)), title);
-}
-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) {
-  p.log.step("yt-dlp command");
-  for (const line of wrapText(command, contentWidth(4)).split("\n")) {
-    console.log(`  ${line}`);
-  }
-}
-
 // src/questions.ts
-function isCancel2(value) {
-  return p2.isCancel(value);
+function isCancel3(value) {
+  return p3.isCancel(value);
 }
 function exitOnCancel(value) {
-  if (isCancel2(value)) {
-    p2.cancel("Cancelled.");
+  if (isCancel3(value)) {
+    p3.cancel("Cancelled.");
     process.exit(0);
   }
 }
@@ -944,13 +1067,13 @@ async function promptUrls(initial) {
   if (initial && initial.length > 0) {
     for (const u of initial) {
       if (!looksLikeUrl2(u)) {
-        p2.log.error(`Invalid URL: ${u}`);
+        p3.log.error(`Invalid URL: ${u}`);
         process.exit(1);
       }
     }
     return initial;
   }
-  const input = await p2.text({
+  const input = await p3.text({
     message: "Paste video URL(s)",
     placeholder: "One or more URLs, separated by spaces or commas",
     initialValue: "",
@@ -967,7 +1090,7 @@ async function promptUrls(initial) {
   return splitUrlList(String(input).trim());
 }
 async function askQuestions(url, meta) {
-  const mode = await p2.select({
+  const mode = await p3.select({
     message: "What do you want to download?",
     options: [
       { value: "video", label: "Video (with audio)" },
@@ -1002,13 +1125,13 @@ async function askQuestions(url, meta) {
         label: "Choose from available resolutions\u2026"
       });
     }
-    const q = await p2.select({
+    const q = await p3.select({
       message: "Video quality?",
       options: qualityOpts
     });
     exitOnCancel(q);
     if (q === "pick") {
-      const picked = await p2.select({
+      const picked = await p3.select({
         message: "Available resolutions",
         options: resolutions.map((h) => ({
           value: String(h),
@@ -1024,7 +1147,7 @@ async function askQuestions(url, meta) {
     }
   }
   if (selectedMode === "audio") {
-    const fmt = await p2.select({
+    const fmt = await p3.select({
       message: "Audio format?",
       options: [
         { value: "mp3", label: "mp3" },
@@ -1037,7 +1160,7 @@ async function askQuestions(url, meta) {
     });
     exitOnCancel(fmt);
     audioFormat = fmt;
-    const aq = await p2.select({
+    const aq = await p3.select({
       message: "Audio quality?",
       options: [
         { value: "best", label: "Best" },
@@ -1051,10 +1174,10 @@ async function askQuestions(url, meta) {
     subMode = "write";
     const langs = availableSubtitleLangs(meta);
     if (langs.length === 0) {
-      p2.log.warn('No subtitle languages found in metadata \u2014 will request "all".');
+      p3.log.warn('No subtitle languages found in metadata \u2014 will request "all".');
       subLangs = ["all"];
     } else {
-      const picked = await p2.multiselect({
+      const picked = await p3.multiselect({
         message: "Which subtitle languages?",
         options: [
           { value: "all", label: "All languages" },
@@ -1068,8 +1191,8 @@ async function askQuestions(url, meta) {
     }
   }
   const prefs = await loadPreferences();
-  const defaultDir = prefs.outputDir ?? join5(homedir(), "Downloads");
-  const outDir = await p2.text({
+  const defaultDir = prefs.outputDir ?? join6(homedir2(), "Downloads");
+  const outDir = await p3.text({
     message: "Destination folder",
     initialValue: defaultDir,
     validate: (v) => !v?.trim() ? "Folder is required" : void 0
@@ -1077,13 +1200,13 @@ async function askQuestions(url, meta) {
   exitOnCancel(outDir);
   const outputDir = String(outDir).trim();
   await savePreferences({ ...prefs, outputDir });
-  const customize = selectedMode === "subs-only" || selectedMode === "thumbnail-only" ? false : await p2.confirm({
+  const customize = selectedMode === "subs-only" || selectedMode === "thumbnail-only" ? false : await p3.confirm({
     message: "Customize advanced options?",
     initialValue: false
   });
   exitOnCancel(customize);
   if (customize && (selectedMode === "video" || selectedMode === "video-only")) {
-    const c = await p2.select({
+    const c = await p3.select({
       message: "Container preference?",
       options: [
         { value: "best", label: "Best available" },
@@ -1096,7 +1219,7 @@ async function askQuestions(url, meta) {
     container = c;
   }
   if (customize && selectedMode !== "thumbnail-only") {
-    const wantSubs = await p2.confirm({
+    const wantSubs = await p3.confirm({
       message: "Download subtitles?",
       initialValue: false
     });
@@ -1104,10 +1227,10 @@ async function askQuestions(url, meta) {
     if (wantSubs) {
       const langs = availableSubtitleLangs(meta);
       if (langs.length === 0) {
-        p2.log.warn('No subtitle languages found \u2014 will request "all".');
+        p3.log.warn('No subtitle languages found \u2014 will request "all".');
         subLangs = ["all"];
       } else {
-        const picked = await p2.multiselect({
+        const picked = await p3.multiselect({
           message: "Which subtitle languages?",
           options: [
             { value: "all", label: "All languages" },
@@ -1119,7 +1242,7 @@ async function askQuestions(url, meta) {
         const sel = picked;
         subLangs = sel.includes("all") ? ["all"] : sel;
       }
-      const how = await p2.select({
+      const how = await p3.select({
         message: "How should subtitles be saved?",
         options: [
           { value: "embed", label: "Embed in the video" },
@@ -1131,7 +1254,7 @@ async function askQuestions(url, meta) {
       subMode = how;
     }
     if (isPlaylistUrl(url, meta)) {
-      const pl = await p2.select({
+      const pl = await p3.select({
         message: "This URL is part of a playlist. What should we download?",
         options: [
           { value: "single", label: "Just this video" },
@@ -1145,7 +1268,7 @@ async function askQuestions(url, meta) {
       } else if (pl === "all") {
         playlist = { kind: "all" };
       } else {
-        const start = await p2.text({
+        const start = await p3.text({
           message: "Playlist start index (1-based)",
           initialValue: "1",
           validate: (v) => {
@@ -1154,7 +1277,7 @@ async function askQuestions(url, meta) {
           }
         });
         exitOnCancel(start);
-        const stop = await p2.text({
+        const stop = await p3.text({
           message: "Playlist stop index (inclusive)",
           initialValue: String(meta.playlist_count ?? 10),
           validate: (v) => {
@@ -1170,7 +1293,7 @@ async function askQuestions(url, meta) {
         };
       }
     }
-    const pickedFilename = await p2.select({
+    const pickedFilename = await p3.select({
       message: "Filename style?",
       options: [
         { value: "title", label: "Title only" },
@@ -1186,7 +1309,7 @@ async function askQuestions(url, meta) {
     });
     exitOnCancel(pickedFilename);
     filenamePreset = pickedFilename;
-    const e = await p2.multiselect({
+    const e = await p3.multiselect({
       message: "Extras (optional)",
       options: [
         {
@@ -1240,7 +1363,7 @@ function readCliVersion() {
 }
 var CLI_VERSION = readCliVersion();
 function fail(message) {
-  p3.log.error(message);
+  p4.log.error(message);
   process.exit(1);
 }
 function pick(value, allowed, name, fallback) {
@@ -1343,13 +1466,13 @@ function displayFlagsForAnswers(answers) {
 }
 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.");
+    p4.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({
+    const action = await p4.select({
       message: "Ready?",
       options: [
         { value: "start", label: "Start download" },
@@ -1358,8 +1481,8 @@ async function confirmStart(answers) {
         { value: "cancel", label: "Cancel" }
       ]
     });
-    if (p3.isCancel(action) || action === "cancel") {
-      p3.cancel("Cancelled.");
+    if (p4.isCancel(action) || action === "cancel") {
+      p4.cancel("Cancelled.");
       process.exit(0);
     }
     if (action === "show-command") {
@@ -1380,41 +1503,143 @@ async function ensureFfmpegIfNeeded(answers) {
   }
   const status = await checkFfmpeg();
   if (status.ok) return;
-  p3.log.warn(
+  p4.log.warn(
     [
       "ffmpeg/ffprobe not found on PATH.",
       ffmpegInstallHint()
     ].join("\n\n")
   );
-  const cont = await p3.confirm({
+  const cont = await p4.confirm({
     message: "Continue anyway? (download may fail at merge/extract)",
     initialValue: false
   });
-  if (p3.isCancel(cont) || !cont) {
-    p3.cancel("Cancelled.");
+  if (p4.isCancel(cont) || !cont) {
+    p4.cancel("Cancelled.");
     process.exit(0);
   }
 }
 async function runDownloads(ytDlp, answers) {
-  const allPaths = [];
+  const filepaths = [];
+  const failures = [];
   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}`);
+    if (label) p4.log.info(`Download ${label}`);
     try {
       const result = await runDownload(ytDlp, flags, { label });
-      allPaths.push(...result.filepaths);
+      filepaths.push(...result.filepaths);
     } catch (err) {
-      if (answers.urls.length === 1) throw err;
-      p3.log.warn(err instanceof Error ? err.message : String(err));
+      failures.push({
+        url,
+        message: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return { filepaths, failures };
+}
+async function gatherMetadata(ytDlp, urls, spinner2) {
+  for (let attempt = 0; ; attempt++) {
+    spinner2.start(
+      attempt === 0 ? "Fetching video info\u2026" : "Fetching video info with Deno\u2026"
+    );
+    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;
+        const isPlaylist = m._type === "playlist";
+        videoInfos.push({
+          url: u,
+          meta: m,
+          title: m.title ?? "Unknown title",
+          uploader: m.uploader ?? "Unknown uploader",
+          duration: isPlaylist ? `${m.playlist_count ?? "?"} videos` : formatDuration(m.duration)
+        });
+      } else {
+        failedUrls.push(u);
+      }
+    }
+    if (videoInfos.length > 0) {
+      spinner2.stop("Metadata loaded");
+      return { videoInfos, failedUrls };
+    }
+    spinner2.stop("Could not fetch metadata");
+    const reasons = [
+      ...new Set(
+        metaResults.filter((r) => r.status === "rejected").map(
+          (r) => r.reason instanceof Error ? r.reason.message : String(r.reason)
+        )
+      )
+    ];
+    p4.log.error(
+      [
+        "Failed to fetch metadata for any of the provided URLs.",
+        ...reasons
+      ].join("\n\n")
+    );
+    if (attempt === 0 && reasons.some(isJsRuntimeError) && await offerDenoInstall()) {
+      continue;
     }
+    process.exit(1);
+  }
+}
+function reportSaved(filepaths, answers) {
+  if (filepaths.length > 0) {
+    showSaved(filepaths);
+    return;
+  }
+  p4.log.success("Done. (No filepath printed \u2014 check your output folder.)");
+  p4.log.info(`Output folder: ${answers.outputDir}`);
+}
+async function downloadAndReport(ytDlp, answers, options = {}) {
+  const allPaths = [];
+  let pending = answers.urls;
+  for (let attempt = 0; ; attempt++) {
+    p4.log.info(
+      attempt === 0 ? "Starting download\u2026" : "Retrying the failed downloads with Deno\u2026"
+    );
+    const { filepaths, failures } = await runDownloads(ytDlp, {
+      ...answers,
+      urls: pending
+    });
+    allPaths.push(...filepaths);
+    if (failures.length === 0) {
+      reportSaved(allPaths, answers);
+      p4.outro("Finished");
+      return;
+    }
+    for (const failure of failures) {
+      p4.log.error(
+        answers.urls.length > 1 ? `${failure.url}
+${failure.message}` : failure.message
+      );
+    }
+    const jsRuntimeFailures = failures.filter(
+      (f) => isJsRuntimeError(f.message)
+    );
+    if (attempt === 0 && jsRuntimeFailures.length > 0 && await offerDenoInstall({ canPrompt: options.canPrompt })) {
+      pending = jsRuntimeFailures.map((f) => f.url);
+      continue;
+    }
+    if (allPaths.length > 0) {
+      reportSaved(allPaths, answers);
+      p4.log.warn(`${failures.length} download(s) failed.`);
+      p4.outro("Finished with errors");
+      return;
+    }
+    p4.outro("Failed");
+    process.exit(1);
   }
-  return allPaths;
 }
 async function runWizard(urlsArg, opts = {}) {
-  p3.intro("easy-ytdlp");
-  const spinner2 = p3.spinner();
+  p4.intro("easy-ytdlp");
+  const spinner2 = p4.spinner();
   spinner2.start("Preparing yt-dlp binary\u2026");
   let ytDlp;
   try {
@@ -1426,7 +1651,7 @@ async function runWizard(urlsArg, opts = {}) {
     spinner2.stop("yt-dlp ready");
   } catch (err) {
     spinner2.stop("Binary setup failed");
-    p3.log.error(err instanceof Error ? err.message : String(err));
+    p4.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
   const urls = await promptUrls(urlsArg);
@@ -1437,62 +1662,10 @@ async function runWizard(urlsArg, opts = {}) {
       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);
-    }
+    await downloadAndReport(ytDlp, answers2, { canPrompt: false });
     return;
   }
-  spinner2.start("Fetching video info\u2026");
-  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;
-      const isPlaylist = m._type === "playlist";
-      videoInfos.push({
-        url: u,
-        meta: m,
-        title: m.title ?? "Unknown title",
-        uploader: m.uploader ?? "Unknown uploader",
-        duration: isPlaylist ? `${m.playlist_count ?? "?"} videos` : formatDuration(m.duration)
-      });
-    } else {
-      failedUrls.push(u);
-    }
-  }
-  if (videoInfos.length === 0) {
-    spinner2.stop("Could not fetch metadata");
-    const reasons = metaResults.filter(
-      (r) => r.status === "rejected"
-    ).map(
-      (r) => r.reason instanceof Error ? r.reason.message : String(r.reason)
-    );
-    p3.log.error(
-      [
-        "Failed to fetch metadata for any of the provided URLs.",
-        ...new Set(reasons)
-      ].join("\n\n")
-    );
-    process.exit(1);
-  }
-  spinner2.stop("Metadata loaded");
+  const { videoInfos, failedUrls } = await gatherMetadata(ytDlp, urls, spinner2);
   if (videoInfos.length === 1) {
     const v = videoInfos[0];
     showNote(`${v.title}
@@ -1505,13 +1678,13 @@ by ${v.uploader} \xB7 ${v.duration}`, "Found");
     showNote(lines.join("\n\n"), `Found (${videoInfos.length} videos)`);
   }
   if (failedUrls.length > 0) {
-    p3.log.warn(
+    p4.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}`);
+    p4.log.info(`Using shared settings based on: ${primary.title}`);
   }
   let answers;
   while (true) {
@@ -1527,33 +1700,19 @@ by ${v.uploader} \xB7 ${v.duration}`, "Found");
     if (action === "start") break;
   }
   await ensureFfmpegIfNeeded(answers);
-  p3.log.info("Starting download\u2026");
-  try {
-    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}`);
-    }
-    p3.outro("Finished");
-  } catch (err) {
-    p3.log.error(err instanceof Error ? err.message : String(err));
-    p3.outro("Failed");
-    process.exit(1);
-  }
+  await downloadAndReport(ytDlp, answers);
 }
 async function runUpdateBinary() {
-  p3.intro("easy-ytdlp update-binary");
-  const spinner2 = p3.spinner();
+  p4.intro("easy-ytdlp update-binary");
+  const spinner2 = p4.spinner();
   spinner2.start("Refreshing yt-dlp binary\u2026");
   try {
     const path = await updateBinary((msg) => spinner2.message(msg));
     spinner2.stop(`Updated: ${path}`);
-    p3.outro("Binary update complete");
+    p4.outro("Binary update complete");
   } catch (err) {
     spinner2.stop("Update failed");
-    p3.log.error(err instanceof Error ? err.message : String(err));
+    p4.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
 }
@@ -1577,7 +1736,7 @@ program.name("easy-ytdlp").description(
       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}`);
+      p4.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("#"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnzlab/easy-ytdlp",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "A user-friendly interactive CLI wrapper for yt-dlp — no Python or flag memorization required",
   "type": "module",
   "main": "./dist/cli.js",