@jnzlab/easy-ytdlp 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.1.3 - 2026-08-05
+
+### Fixed
+
+- Pasting a bare YouTube playlist link no longer fails/hangs at startup. The
+  metadata fetch now uses `--flat-playlist` for playlist URLs (fast, one small
+  line per video) and shows the playlist title + video count instead of dumping
+  full metadata for every video. "Just this video" on a bare playlist URL now
+  downloads only the first entry (`--playlist-items 1`) instead of the whole
+  playlist.
+
 ## 1.1.0 - 2026-07-27
 
 ### Added

package/README.md

@@ -56,7 +56,7 @@ Useful flags:
 
 ### Example session
 
-![easy-ytdlp demo](https://pub-453eda74623641f7967529680d3689bb.r2.dev/easy-ytdlp-demo.gif)
+![easy-ytdlp demo](https://pub-453eda74623641f7967529680d3689bb.r2.dev/demo.gif)
 
 ### Audio-only example
 

package/dist/cli.js

@@ -179,129 +179,6 @@ async function createYtDlp(options = {}) {
   return new YTDlpWrap(binPath);
 }
 
-// src/builder.ts
-var FILENAME_TEMPLATES = {
-  title: "%(title)s.%(ext)s",
-  "title-channel": "%(title)s [%(uploader)s].%(ext)s",
-  "title-date": "%(upload_date)s - %(title)s.%(ext)s"
-};
-function audioQualityValue(q) {
-  return q === "good" ? "5" : "0";
-}
-function videoQualityFlags(quality) {
-  if (!quality || quality === "best") {
-    return ["-f", "bv*+ba/b"];
-  }
-  if (typeof quality === "object" && "height" in quality) {
-    const h = quality.height;
-    return ["-f", `bv*[height=${h}]+ba/b`];
-  }
-  return ["-S", `res:${quality}`, "-f", "bv*+ba/b"];
-}
-function containerFlags(container) {
-  if (!container || container === "best") return [];
-  return ["--merge-output-format", container];
-}
-function buildFlags(answers) {
-  const flags = [];
-  switch (answers.mode) {
-    case "video":
-      flags.push(...videoQualityFlags(answers.videoQuality));
-      flags.push(...containerFlags(answers.container));
-      break;
-    case "video-only":
-      if (answers.videoQuality && answers.videoQuality !== "best" && typeof answers.videoQuality !== "object") {
-        flags.push("-S", `res:${answers.videoQuality}`, "-f", "bv");
-      } else if (typeof answers.videoQuality === "object" && answers.videoQuality?.height) {
-        flags.push("-f", `bv[height=${answers.videoQuality.height}]`);
-      } else {
-        flags.push("-f", "bv");
-      }
-      flags.push(...containerFlags(answers.container));
-      break;
-    case "audio":
-      flags.push(
-        "-x",
-        "--audio-format",
-        answers.audioFormat ?? "best",
-        "--audio-quality",
-        audioQualityValue(answers.audioQuality)
-      );
-      break;
-    case "subs-only":
-      flags.push("--skip-download", "--write-subs");
-      break;
-    case "thumbnail-only":
-      flags.push("--skip-download", "--write-thumbnail");
-      break;
-  }
-  if (answers.mode === "subs-only") {
-    const langs = answers.subtitles.languages.length > 0 ? answers.subtitles.languages.join(",") : "all";
-    flags.push("--sub-langs", langs);
-  } else if (answers.subtitles.mode !== "none" && answers.mode !== "thumbnail-only") {
-    const langs = answers.subtitles.languages.length > 0 ? answers.subtitles.languages.join(",") : "all";
-    flags.push("--sub-langs", langs);
-    if (answers.subtitles.mode === "write" || answers.subtitles.mode === "both") {
-      flags.push("--write-subs");
-    }
-    if (answers.subtitles.mode === "embed" || answers.subtitles.mode === "both") {
-      flags.push("--embed-subs");
-    }
-  }
-  switch (answers.playlist.kind) {
-    case "single":
-      flags.push("--no-playlist");
-      break;
-    case "all":
-      flags.push("--yes-playlist");
-      break;
-    case "range":
-      flags.push(
-        "--yes-playlist",
-        "-I",
-        `${answers.playlist.start}:${answers.playlist.stop}`
-      );
-      break;
-  }
-  flags.push("-P", answers.outputDir);
-  flags.push("-o", FILENAME_TEMPLATES[answers.filenamePreset]);
-  if (answers.embedThumbnail && answers.mode !== "thumbnail-only") {
-    flags.push("--embed-thumbnail");
-  }
-  if (answers.embedMetadata) {
-    flags.push("--embed-metadata");
-  }
-  if (answers.sponsorBlock) {
-    flags.push("--sponsorblock-remove", "default");
-  }
-  flags.push("--print", "after_move:filepath");
-  flags.push(...answers.urls);
-  if (answers.urls.length > 1) {
-    flags.unshift("--ignore-errors");
-  }
-  return flags;
-}
-function formatCommand(flags) {
-  const quoted = flags.map(
-    (f) => /[\s"'\\]/.test(f) ? JSON.stringify(f) : f
-  );
-  const parts = ["yt-dlp"];
-  for (let i = 0; i < quoted.length; i++) {
-    const cur = quoted[i];
-    const next = quoted[i + 1];
-    if (cur.startsWith("-") && next && !next.startsWith("-") && !looksLikeUrl(next)) {
-      parts.push(`${cur} ${next}`);
-      i++;
-    } else {
-      parts.push(cur);
-    }
-  }
-  return parts.join("\n  ");
-}
-function looksLikeUrl(s) {
-  return /^https?:\/\//i.test(s) || s.startsWith('"http');
-}
-
 // src/downloader.ts
 import cliProgress from "cli-progress";
 
@@ -492,13 +369,56 @@ yt-dlp said: ${raw.trim()}`;
   }
   return raw.trim() || "Download failed for an unknown reason.";
 }
+var YOUTUBE_HOST_RE = /(\.|^)youtube\.com$/i;
+var YOUTUBE_SHORT_HOST_RE = /(\.|^)youtu\.be$/i;
+var VIDEO_ID_RE = /^[A-Za-z0-9_-]{11}$/;
+function isPlaylistOnlyUrl(url) {
+  let u;
+  try {
+    u = new URL(url);
+  } catch {
+    return false;
+  }
+  const host = u.hostname.toLowerCase();
+  const isYoutube = YOUTUBE_HOST_RE.test(host) || YOUTUBE_SHORT_HOST_RE.test(host);
+  if (!isYoutube || !u.searchParams.has("list")) return false;
+  const v = u.searchParams.get("v") ?? "";
+  if (VIDEO_ID_RE.test(v)) return false;
+  if (host.endsWith("youtu.be") && u.pathname.length > 1) return false;
+  if (/^\/(?:shorts|embed|live)\/[A-Za-z0-9_-]{11}/.test(u.pathname)) {
+    return false;
+  }
+  return true;
+}
+function metadataArgs(url) {
+  const scopeFlags = isPlaylistOnlyUrl(url) ? ["--flat-playlist", "-f", "best"] : ["--no-playlist"];
+  return [...youtubeCompatFlags(), ...scopeFlags, url];
+}
+function normalizePlaylistMeta(raw, url) {
+  const entries = Array.isArray(raw) ? raw : raw && typeof raw === "object" ? [raw] : [];
+  const first = entries[0];
+  if (!first) {
+    return { _type: "playlist", webpage_url: url, playlist_count: 0, entries: [] };
+  }
+  const count = first.playlist_count ?? first.n_entries ?? entries.length;
+  return {
+    _type: "playlist",
+    id: first.playlist_id ?? first.id,
+    title: first.playlist_title ?? first.playlist ?? first.title,
+    uploader: first.playlist_uploader,
+    playlist: first.playlist_title ?? first.playlist,
+    playlist_id: first.playlist_id,
+    playlist_count: count,
+    n_entries: count,
+    webpage_url: url,
+    entries
+  };
+}
 async function fetchMetadata(ytDlp, url) {
+  const playlistOnly = isPlaylistOnlyUrl(url);
   try {
-    return await ytDlp.getVideoInfo([
-      ...youtubeCompatFlags(),
-      "--no-playlist",
-      url
-    ]);
+    const raw = await ytDlp.getVideoInfo(metadataArgs(url));
+    return playlistOnly ? normalizePlaylistMeta(raw, url) : raw;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     throw new Error(humanizeError(msg));
@@ -694,9 +614,7 @@ async function runDownload(ytDlp, flags, options = {}) {
       }
       if (code !== 0 && code !== null) {
         reject(
-          new Error(
-            humanizeError(lastError || `yt-dlp exited with code ${code}`)
-          )
+          new Error(humanizeError(lastError || `yt-dlp exited with code ${code}`))
         );
         return;
       }
@@ -705,6 +623,135 @@ async function runDownload(ytDlp, flags, options = {}) {
   });
 }
 
+// src/builder.ts
+var FILENAME_TEMPLATES = {
+  title: "%(title)s.%(ext)s",
+  "title-channel": "%(title)s [%(uploader)s].%(ext)s",
+  "title-date": "%(upload_date)s - %(title)s.%(ext)s"
+};
+function audioQualityValue(q) {
+  return q === "good" ? "5" : "0";
+}
+function videoQualityFlags(quality) {
+  if (!quality || quality === "best") {
+    return ["-f", "bv*+ba/b"];
+  }
+  if (typeof quality === "object" && "height" in quality) {
+    const h = quality.height;
+    return ["-f", `bv*[height=${h}]+ba/b`];
+  }
+  return ["-S", `res:${quality}`, "-f", "bv*+ba/b"];
+}
+function containerFlags(container) {
+  if (!container || container === "best") return [];
+  return ["--merge-output-format", container];
+}
+function buildFlags(answers) {
+  const flags = [];
+  switch (answers.mode) {
+    case "video":
+      flags.push(...videoQualityFlags(answers.videoQuality));
+      flags.push(...containerFlags(answers.container));
+      break;
+    case "video-only":
+      if (answers.videoQuality && answers.videoQuality !== "best" && typeof answers.videoQuality !== "object") {
+        flags.push("-S", `res:${answers.videoQuality}`, "-f", "bv");
+      } else if (typeof answers.videoQuality === "object" && answers.videoQuality?.height) {
+        flags.push("-f", `bv[height=${answers.videoQuality.height}]`);
+      } else {
+        flags.push("-f", "bv");
+      }
+      flags.push(...containerFlags(answers.container));
+      break;
+    case "audio":
+      flags.push(
+        "-x",
+        "--audio-format",
+        answers.audioFormat ?? "best",
+        "--audio-quality",
+        audioQualityValue(answers.audioQuality)
+      );
+      break;
+    case "subs-only":
+      flags.push("--skip-download", "--write-subs");
+      break;
+    case "thumbnail-only":
+      flags.push("--skip-download", "--write-thumbnail");
+      break;
+  }
+  if (answers.mode === "subs-only") {
+    const langs = answers.subtitles.languages.length > 0 ? answers.subtitles.languages.join(",") : "all";
+    flags.push("--sub-langs", langs);
+  } else if (answers.subtitles.mode !== "none" && answers.mode !== "thumbnail-only") {
+    const langs = answers.subtitles.languages.length > 0 ? answers.subtitles.languages.join(",") : "all";
+    flags.push("--sub-langs", langs);
+    if (answers.subtitles.mode === "write" || answers.subtitles.mode === "both") {
+      flags.push("--write-subs");
+    }
+    if (answers.subtitles.mode === "embed" || answers.subtitles.mode === "both") {
+      flags.push("--embed-subs");
+    }
+  }
+  switch (answers.playlist.kind) {
+    case "single": {
+      const firstUrl = answers.urls[0];
+      if (firstUrl && isPlaylistOnlyUrl(firstUrl)) {
+        flags.push("--playlist-items", "1");
+      } else {
+        flags.push("--no-playlist");
+      }
+      break;
+    }
+    case "all":
+      flags.push("--yes-playlist");
+      break;
+    case "range":
+      flags.push(
+        "--yes-playlist",
+        "-I",
+        `${answers.playlist.start}:${answers.playlist.stop}`
+      );
+      break;
+  }
+  flags.push("-P", answers.outputDir);
+  flags.push("-o", FILENAME_TEMPLATES[answers.filenamePreset]);
+  if (answers.embedThumbnail && answers.mode !== "thumbnail-only") {
+    flags.push("--embed-thumbnail");
+  }
+  if (answers.embedMetadata) {
+    flags.push("--embed-metadata");
+  }
+  if (answers.sponsorBlock) {
+    flags.push("--sponsorblock-remove", "default");
+  }
+  flags.push("--print", "after_move:filepath");
+  flags.push(...answers.urls);
+  if (answers.urls.length > 1) {
+    flags.unshift("--ignore-errors");
+  }
+  return flags;
+}
+function formatCommand(flags) {
+  const quoted = flags.map(
+    (f) => /[\s"'\\]/.test(f) ? JSON.stringify(f) : f
+  );
+  const parts = ["yt-dlp"];
+  for (let i = 0; i < quoted.length; i++) {
+    const cur = quoted[i];
+    const next = quoted[i + 1];
+    if (cur.startsWith("-") && next && !next.startsWith("-") && !looksLikeUrl(next)) {
+      parts.push(`${cur} ${next}`);
+      i++;
+    } else {
+      parts.push(cur);
+    }
+  }
+  return parts.join("\n  ");
+}
+function looksLikeUrl(s) {
+  return /^https?:\/\//i.test(s) || s.startsWith('"http');
+}
+
 // src/questions.ts
 import * as p2 from "@clack/prompts";
 import { homedir } from "os";
@@ -1174,7 +1221,7 @@ async function askQuestions(url, meta) {
 }
 
 // src/cli.ts
-var CLI_VERSION = "1.1.0";
+var CLI_VERSION = "1.1.3";
 function fail(message) {
   p3.log.error(message);
   process.exit(1);
@@ -1401,12 +1448,13 @@ async function runWizard(urlsArg, opts = {}) {
     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: formatDuration(m.duration)
+        duration: isPlaylist ? `${m.playlist_count ?? "?"} videos` : formatDuration(m.duration)
       });
     } else {
       failedUrls.push(u);

package/package.json

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