ytgrab 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harry Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# ytgrab
+
+A Node.js YouTube video downloader ported from [yt-dlp](https://github.com/yt-dlp/yt-dlp).
+
+## Features
+
+- Download YouTube videos in available formats
+- Download auto-generated and manual subtitles/captions
+- Extract video metadata (title, description, thumbnails, chapters, etc.)
+- N-parameter challenge solver (uses yt-dlp's EJS solver scripts)
+- InnerTube API integration (android_vr, web_safari clients)
+- Audio extraction with FFmpeg
+- HLS/M3U8 stream downloading
+- Playlist and search support
+- CLI and programmatic API
+
+## Requirements
+
+- Node.js >= 18
+- [yt-dlp](https://github.com/yt-dlp/yt-dlp) installed (for the EJS challenge solver scripts)
+- [FFmpeg](https://ffmpeg.org/) (optional, for audio extraction and format conversion)
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## CLI Usage
+
+```bash
+# Download a video
+node bin/ytgrab.js "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Download with subtitles
+node bin/ytgrab.js --write-auto-subs --sub-langs en "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# List available formats
+node bin/ytgrab.js -F "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Download to a specific directory
+node bin/ytgrab.js -P /path/to/output "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Extract audio as MP3
+node bin/ytgrab.js -x --audio-format mp3 "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Print video info as JSON
+node bin/ytgrab.js -j "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Download with custom format
+node bin/ytgrab.js -f 720p "https://www.youtube.com/watch?v=VIDEO_ID"
+
+# Write metadata files
+node bin/ytgrab.js --write-info-json --write-thumbnail --write-description "URL"
+```
+
+Run `node bin/ytgrab.js -h` for all options.
+
+## Programmatic API
+
+```typescript
+import { YtGrab } from 'ytgrab';
+
+// Get video info without downloading
+const yt = new YtGrab();
+const info = await yt.getInfo('https://www.youtube.com/watch?v=VIDEO_ID');
+console.log(info.title);
+console.log(info.formats);
+console.log(info.automatic_captions);
+
+// Download a video
+await yt.download('https://www.youtube.com/watch?v=VIDEO_ID');
+
+// Download with options
+const ytWithOpts = new YtGrab({
+  format: 'best',
+  output: '%(title)s.%(ext)s',
+  writeSubtitles: true,
+  subtitleLanguages: ['en'],
+  paths: { home: './downloads' },
+  progressHooks: [(progress) => {
+    console.log(`${progress.status}: ${progress.downloaded_bytes} bytes`);
+  }],
+});
+await ytWithOpts.download('https://www.youtube.com/watch?v=VIDEO_ID');
+
+// Extract audio
+const ytAudio = new YtGrab({
+  extractAudio: true,
+  audioFormat: 'mp3',
+});
+await ytAudio.download('https://www.youtube.com/watch?v=VIDEO_ID');
+
+// List formats
+const formats = await yt.listFormats('https://www.youtube.com/watch?v=VIDEO_ID');
+
+// List subtitles
+const subs = await yt.listSubtitles('https://www.youtube.com/watch?v=VIDEO_ID');
+```
+
+## Project Structure
+
+```
+ytgrab/
+├── bin/ytgrab.js              # CLI entry point
+├── src/
+│   ├── index.ts               # Public API exports
+│   ├── types.ts               # TypeScript interfaces
+│   ├── ytgrab.ts              # Main orchestrator (YtGrab class)
+│   ├── utils/
+│   │   ├── index.ts           # Utility functions
+│   │   └── traversal.ts       # traverse_obj / tryGet
+│   ├── networking/
+│   │   └── index.ts           # HTTP client
+│   ├── extractor/
+│   │   ├── common.ts          # Base InfoExtractor
+│   │   ├── youtube.ts         # YouTube extractor
+│   │   └── nsig.ts            # N-parameter challenge solver
+│   ├── downloader/
+│   │   ├── common.ts          # Base downloader
+│   │   ├── http.ts            # HTTP downloader
+│   │   ├── hls.ts             # HLS downloader
+│   │   └── index.ts           # Downloader registry
+│   └── postprocessor/
+│       ├── common.ts          # Base post-processor
+│       └── ffmpeg.ts          # FFmpeg post-processors
+└── dist/                      # Compiled output
+```
+
+## How It Works
+
+1. **Webpage fetch** — Downloads the YouTube watch page to extract the initial player response and player JS URL
+2. **InnerTube API** — Calls YouTube's internal API with `android_vr` and `web_safari` clients to get video formats and captions
+3. **N-parameter solving** — Uses yt-dlp's EJS challenge solver (meriyah + astring) to transform the `n` throttle parameter in format URLs
+4. **Format selection** — Picks the best available format based on user preferences
+5. **Download** — Downloads the video via HTTP with resume support, or HLS fragment downloading
+6. **Post-processing** — Optional FFmpeg operations (audio extraction, format conversion, subtitle embedding)
+
+## License
+
+MIT

package/bin/ytgrab.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+/**
+ * ytgrab CLI - YouTube video downloader
+ * Usage: ytgrab [OPTIONS] URL [URL...]
+ */
+
+import { parseArgs } from 'node:util';
+import { YtGrab } from '../dist/index.js';
+
+const { values: opts, positionals: urls } = parseArgs({
+  allowPositionals: true,
+  options: {
+    // Output
+    output: { type: 'string', short: 'o', default: '%(title)s [%(id)s].%(ext)s' },
+    paths: { type: 'string', short: 'P' },
+
+    // Format selection
+    format: { type: 'string', short: 'f', default: 'best' },
+    'merge-output-format': { type: 'string' },
+
+    // Info
+    'list-formats': { type: 'boolean', short: 'F', default: false },
+    'list-subs': { type: 'boolean', default: false },
+    'print-json': { type: 'boolean', short: 'j', default: false },
+    simulate: { type: 'boolean', short: 's', default: false },
+    'skip-download': { type: 'boolean', default: false },
+
+    // Subtitles
+    'write-subs': { type: 'boolean', default: false },
+    'write-auto-subs': { type: 'boolean', default: false },
+    'sub-langs': { type: 'string', default: 'en' },
+    'sub-format': { type: 'string', default: 'srt' },
+
+    // Thumbnails & metadata
+    'write-thumbnail': { type: 'boolean', default: false },
+    'write-info-json': { type: 'boolean', default: false },
+    'write-description': { type: 'boolean', default: false },
+
+    // Audio
+    'extract-audio': { type: 'boolean', short: 'x', default: false },
+    'audio-format': { type: 'string', default: 'mp3' },
+    'audio-quality': { type: 'string', default: '5' },
+
+    // Embedding
+    'embed-subs': { type: 'boolean', default: false },
+    'embed-thumbnail': { type: 'boolean', default: false },
+    'embed-metadata': { type: 'boolean', default: false },
+
+    // Network
+    proxy: { type: 'string' },
+    retries: { type: 'string', short: 'R', default: '10' },
+
+    // FFmpeg
+    'ffmpeg-location': { type: 'string' },
+
+    // Verbosity
+    quiet: { type: 'boolean', short: 'q', default: false },
+    verbose: { type: 'boolean', short: 'v', default: false },
+    'no-progress': { type: 'boolean', default: false },
+
+    // Help
+    help: { type: 'boolean', short: 'h', default: false },
+    version: { type: 'boolean', short: 'V', default: false },
+  },
+});
+
+if (opts.help) {
+  console.log(`
+ytgrab - YouTube video downloader for Node.js (ported from yt-dlp)
+
+Usage: ytgrab [OPTIONS] URL [URL...]
+
+Options:
+  -o, --output TEMPLATE      Output filename template (default: %(title)s [%(id)s].%(ext)s)
+  -P, --paths PATH           Output directory
+  -f, --format FORMAT        Video format (default: best)
+                             Examples: best, worst, bestaudio, 720p, 1080p, 137
+  -F, --list-formats         List available formats and exit
+      --list-subs            List available subtitles and exit
+  -j, --print-json           Print info JSON and exit
+  -s, --simulate             Do not download, just print info
+
+  --write-subs               Download subtitles
+  --write-auto-subs          Download auto-generated subtitles
+  --sub-langs LANGS          Subtitle languages (comma-separated, default: en)
+  --sub-format FMT           Subtitle format (default: srt)
+
+  --write-thumbnail          Download thumbnail
+  --write-info-json          Write video info to .info.json
+  --write-description        Write description to .description
+
+  -x, --extract-audio        Extract audio (requires FFmpeg)
+  --audio-format FMT         Audio format: mp3, aac, opus, flac, wav (default: mp3)
+  --audio-quality Q          Audio quality: 0 (best) to 9 (worst) (default: 5)
+
+  --embed-subs               Embed subtitles (requires FFmpeg)
+  --embed-thumbnail          Embed thumbnail (requires FFmpeg)
+  --embed-metadata           Embed metadata (requires FFmpeg)
+  --merge-output-format FMT  Merge format: mp4, mkv, webm
+
+  --proxy URL                Use proxy
+  -R, --retries N            Number of retries (default: 10)
+  --ffmpeg-location PATH     FFmpeg binary path
+
+  -q, --quiet                Suppress output
+  -v, --verbose              Verbose output
+  --no-progress              Hide progress bar
+
+  -h, --help                 Show this help
+  -V, --version              Show version
+`);
+  process.exit(0);
+}
+
+if (opts.version) {
+  console.log('ytgrab 0.1.0');
+  process.exit(0);
+}
+
+if (urls.length === 0) {
+  console.error('Error: No URL provided. Use -h for help.');
+  process.exit(1);
+}
+
+const ytgrab = new YtGrab({
+  format: opts.format,
+  output: opts.output,
+  paths: opts.paths ? { home: opts.paths } : undefined,
+  quiet: opts.quiet,
+  verbose: opts.verbose,
+  noProgress: opts['no-progress'],
+  simulate: opts.simulate || opts['print-json'],
+  skipDownload: opts['skip-download'],
+  listFormats: opts['list-formats'],
+  listSubtitles: opts['list-subs'],
+  writeSubtitles: opts['write-subs'],
+  writeAutoSubtitles: opts['write-auto-subs'],
+  subtitleLanguages: opts['sub-langs']?.split(','),
+  subtitleFormat: opts['sub-format'],
+  writeThumbnail: opts['write-thumbnail'],
+  writeInfoJson: opts['write-info-json'],
+  writeDescription: opts['write-description'],
+  extractAudio: opts['extract-audio'],
+  audioFormat: opts['audio-format'],
+  audioQuality: opts['audio-quality'],
+  embedSubtitles: opts['embed-subs'],
+  embedThumbnail: opts['embed-thumbnail'],
+  embedMetadata: opts['embed-metadata'],
+  mergeOutputFormat: opts['merge-output-format'],
+  proxy: opts.proxy,
+  retries: parseInt(opts.retries || '10'),
+  ffmpegLocation: opts['ffmpeg-location'],
+  progressHooks: opts.quiet ? [] : [
+    (progress) => {
+      if (opts['no-progress']) return;
+      if (progress.status === 'downloading') {
+        const pct = progress.total_bytes
+          ? ((progress.downloaded_bytes || 0) / progress.total_bytes * 100).toFixed(1)
+          : '?';
+        const speed = progress.speed
+          ? `${(progress.speed / 1024 / 1024).toFixed(2)} MiB/s`
+          : '? MiB/s';
+        const eta = progress.eta ? `ETA ${progress.eta}s` : '';
+        const frag = progress.fragment_count
+          ? `frag ${progress.fragment_index}/${progress.fragment_count}`
+          : '';
+        process.stdout.write(
+          `\r[download] ${pct}% ${speed} ${eta} ${frag}`.padEnd(80)
+        );
+      } else if (progress.status === 'finished') {
+        process.stdout.write('\n');
+      }
+    },
+  ],
+});
+
+async function main() {
+  try {
+    if (opts['print-json']) {
+      for (const url of urls) {
+        const info = await ytgrab.getInfo(url);
+        console.log(JSON.stringify(info, null, 2));
+      }
+    } else {
+      await ytgrab.download(urls);
+    }
+  } catch (err) {
+    console.error(`ERROR: ${(err).message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/downloader/common.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Base FileDownloader - ported from yt_dlp/downloader/common.py
+ */
+import type { InfoDict, DownloadProgress, ProgressHook } from '../types.js';
+export declare abstract class FileDownloader {
+    protected _ydl: any;
+    protected _progressHooks: ProgressHook[];
+    constructor(ydl: any);
+    abstract realDownload(filename: string, infoDict: InfoDict): Promise<boolean>;
+    addProgressHook(hook: ProgressHook): void;
+    protected _hookProgress(progress: DownloadProgress): void;
+    protected tempName(filename: string): string;
+    protected undoTempName(filename: string): string;
+    protected reportDestination(filename: string): void;
+    protected reportProgress(downloaded: number, total: number | null, startTime: number): void;
+    protected reportFinished(filename: string, filesize: number): void;
+    protected calcSpeed(start: number, now: number, bytes: number): number | null;
+    protected calcEta(start: number, now: number, total: number, current: number): number | null;
+    protected ensureDir(filepath: string): void;
+    protected _log(msg: string): void;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/downloader/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/downloader/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG5E,8BAAsB,cAAc;IAClC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;IACpB,SAAS,CAAC,cAAc,EAAE,YAAY,EAAE,CAAM;gBAElC,GAAG,EAAE,GAAG;IAOpB,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7E,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIzC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAMzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5C,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIhD,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInD,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAe3F,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUlE,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7E,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO5F,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO3C,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAQlC"}

package/dist/downloader/common.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Base FileDownloader - ported from yt_dlp/downloader/common.py
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDownloader = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const index_js_1 = require("../utils/index.js");
+class FileDownloader {
+    _ydl;
+    _progressHooks = [];
+    constructor(ydl) {
+        this._ydl = ydl;
+        if (ydl?.params?.progressHooks) {
+            this._progressHooks.push(...ydl.params.progressHooks);
+        }
+    }
+    addProgressHook(hook) {
+        this._progressHooks.push(hook);
+    }
+    _hookProgress(progress) {
+        for (const hook of this._progressHooks) {
+            try {
+                hook(progress);
+            }
+            catch { /* ignore hook errors */ }
+        }
+    }
+    tempName(filename) {
+        return `${filename}.part`;
+    }
+    undoTempName(filename) {
+        return filename.replace(/\.part$/, '');
+    }
+    reportDestination(filename) {
+        this._log(`Destination: ${filename}`);
+    }
+    reportProgress(downloaded, total, startTime) {
+        const elapsed = (Date.now() - startTime) / 1000;
+        const speed = elapsed > 0 ? downloaded / elapsed : 0;
+        const eta = total && speed > 0 ? Math.round((total - downloaded) / speed) : undefined;
+        this._hookProgress({
+            status: 'downloading',
+            downloaded_bytes: downloaded,
+            total_bytes: total ?? undefined,
+            elapsed,
+            speed,
+            eta,
+        });
+    }
+    reportFinished(filename, filesize) {
+        this._log(`Download completed: ${filename} (${(0, index_js_1.formatBytes)(filesize)})`);
+        this._hookProgress({
+            status: 'finished',
+            filename,
+            downloaded_bytes: filesize,
+            total_bytes: filesize,
+        });
+    }
+    calcSpeed(start, now, bytes) {
+        const elapsed = (now - start) / 1000;
+        if (elapsed <= 0)
+            return null;
+        return bytes / elapsed;
+    }
+    calcEta(start, now, total, current) {
+        const elapsed = (now - start) / 1000;
+        if (elapsed <= 0 || current <= 0)
+            return null;
+        const rate = current / elapsed;
+        return Math.round((total - current) / rate);
+    }
+    ensureDir(filepath) {
+        const dir = path.dirname(filepath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    _log(msg) {
+        if (this._ydl?.params?.quiet)
+            return;
+        if (this._ydl) {
+            this._ydl.toScreen(`[download] ${msg}`);
+        }
+        else {
+            console.log(`[download] ${msg}`);
+        }
+    }
+}
+exports.FileDownloader = FileDownloader;
+//# sourceMappingURL=common.js.map

package/dist/downloader/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/downloader/common.ts"],"names":[],"mappings":"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"}

package/dist/downloader/hls.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HLS (M3U8) Downloader - ported from yt_dlp/downloader/hls.py
+ * Downloads HTTP Live Streaming content by fetching fragments.
+ */
+import { FileDownloader } from './common.js';
+import type { InfoDict } from '../types.js';
+export declare class HlsFD extends FileDownloader {
+    realDownload(filename: string, infoDict: InfoDict): Promise<boolean>;
+    private _parseMediaPlaylist;
+}
+//# sourceMappingURL=hls.d.ts.map

package/dist/downloader/hls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hls.d.ts","sourceRoot":"","sources":["../../src/downloader/hls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,qBAAa,KAAM,SAAQ,cAAc;IACjC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IA0E1E,OAAO,CAAC,mBAAmB;CAoB5B"}

package/dist/downloader/hls.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * HLS (M3U8) Downloader - ported from yt_dlp/downloader/hls.py
+ * Downloads HTTP Live Streaming content by fetching fragments.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HlsFD = void 0;
+const fs = __importStar(require("node:fs"));
+const common_js_1 = require("./common.js");
+const index_js_1 = require("../networking/index.js");
+class HlsFD extends common_js_1.FileDownloader {
+    async realDownload(filename, infoDict) {
+        const manifestUrl = (infoDict.url || infoDict.manifest_url);
+        if (!manifestUrl)
+            throw new Error('No HLS manifest URL');
+        this.ensureDir(filename);
+        this.reportDestination(filename);
+        // Download manifest
+        this._log('Downloading HLS manifest');
+        const manifestResp = await (0, index_js_1.makeRequest)(manifestUrl, {
+            headers: infoDict.http_headers ?? {},
+        });
+        const manifest = manifestResp.text();
+        // Parse fragments
+        const fragments = this._parseMediaPlaylist(manifest, manifestUrl);
+        if (fragments.length === 0) {
+            throw new Error('No fragments found in HLS manifest');
+        }
+        this._log(`Downloading ${fragments.length} fragments`);
+        const tmpFilename = this.tempName(filename);
+        const stream = fs.createWriteStream(tmpFilename);
+        const startTime = Date.now();
+        let downloadedBytes = 0;
+        for (let i = 0; i < fragments.length; i++) {
+            const frag = fragments[i];
+            try {
+                const resp = await (0, index_js_1.makeRequest)(frag.url, {
+                    headers: infoDict.http_headers ?? {},
+                    timeout: 60000,
+                });
+                stream.write(resp.body);
+                downloadedBytes += resp.body.length;
+                this._hookProgress({
+                    status: 'downloading',
+                    downloaded_bytes: downloadedBytes,
+                    fragment_index: i + 1,
+                    fragment_count: fragments.length,
+                    elapsed: (Date.now() - startTime) / 1000,
+                    speed: this.calcSpeed(startTime, Date.now(), downloadedBytes) ?? undefined,
+                });
+            }
+            catch (err) {
+                this._log(`Fragment ${i + 1}/${fragments.length} failed: ${err.message}`);
+                // Continue with next fragment
+            }
+        }
+        await new Promise((resolve, reject) => {
+            stream.end(() => {
+                try {
+                    if (fs.existsSync(filename))
+                        fs.unlinkSync(filename);
+                    fs.renameSync(tmpFilename, filename);
+                    resolve();
+                }
+                catch {
+                    try {
+                        fs.copyFileSync(tmpFilename, filename);
+                        fs.unlinkSync(tmpFilename);
+                        resolve();
+                    }
+                    catch (err) {
+                        reject(err);
+                    }
+                }
+            });
+        });
+        this.reportFinished(filename, downloadedBytes);
+        return true;
+    }
+    _parseMediaPlaylist(manifest, baseUrl) {
+        const fragments = [];
+        const lines = manifest.split('\n');
+        let duration = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (line.startsWith('#EXTINF:')) {
+                const match = line.match(/#EXTINF:([\d.]+)/);
+                if (match)
+                    duration = parseFloat(match[1]);
+            }
+            else if (line && !line.startsWith('#')) {
+                const fragUrl = line.startsWith('http') ? line : new URL(line, baseUrl).toString();
+                fragments.push({ url: fragUrl, duration });
+                duration = 0;
+            }
+        }
+        return fragments;
+    }
+}
+exports.HlsFD = HlsFD;
+//# sourceMappingURL=hls.js.map

package/dist/downloader/hls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hls.js","sourceRoot":"","sources":["../../src/downloader/hls.ts"],"names":[],"mappings":"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"}