cloud-ytdl next version

cloud-ytdl is a modern, production-ready YouTube downloader and data scraper built on top of official YouTube InnerTube API clients (primarily the Android client). Unlike many other libraries, it provides robust support for downloading and scraping video, live streams, community posts (text, images, polls), playlists, and subtitles/captions, while also handling signature/cipher decryption internally.



Author: AlfiDev
Repository: github.com/cloudkuimages/cloud-ytdl
Fork:YT-DLP

---

🌟 Key Features

- Official InnerTube Client – Uses real YouTube Android API for reliable data extraction.
- Signature Decoding – Handles encrypted signature/cipher transparently.
- Restricted Videos – Download age-restricted/region-locked/member-only videos using cookies.
- Community Post Extraction – Scrape text, images, and polls from YouTube community posts.
- Subtitle/Caption Download – Download subtitles as XML or SRT.
- Playlist Extraction – Get all videos in playlists/radios.
- Multi-Format Support – MP4, WebM, M4A, DASH, HLS, and more.
- Stream Support – HLS and DASH streaming.
- Cookie/Proxy Agent Support – Use cookies from browser or proxy for restricted/private videos.
- Modern Node.js – Requires Node 18+ (uses undici and modern async/await patterns).
- Event-based Streaming – Download with progress, error, and info events.

---

🚀 Quick Start

$3

``bash
npm install cloud-ytdl
`

$3

`js
const ytdl = require('cloud-ytdl');
const fs = require('fs');

ytdl('https://www.youtube.com/watch?v=dQw4w9WgXcQ')
.pipe(fs.createWriteStream('video.mp4'));
`

$3

`js
// Highest quality
ytdl('VIDEO_URL', { quality: 'highest' })
.pipe(fs.createWriteStream('video.mp4'));

// 1080p only (ITAG 137)
ytdl('VIDEO_URL', { quality: 137 })
.pipe(fs.createWriteStream('video-1080p.mp4'));

// Audio only
ytdl('VIDEO_URL', { filter: 'audioonly' })
.pipe(fs.createWriteStream('audio.m4a'));
`

---

📚 API Documentation

$3

Below are the main functions and classes exposed by the library, with detailed descriptions and usage.

---

$3

Download a YouTube video as a readable stream. Emits Node.js stream events (info, progress, error, etc.).

- Parameters:
- url (string): YouTube video URL or ID.
- options (object, optional): Download options.

- Returns: ReadableStream

- Events:
- info – Video info and selected format.
- progress – Download progress (chunk size, downloaded, total).
- data – Raw data chunk.
- end – Download finished.
- error – Error occurred.

#### Example

`js
const ytdl = require('cloud-ytdl');
const fs = require('fs');

const video = ytdl('https://www.youtube.com/watch?v=dQw4w9WgXcQ', { quality: 'highest' });
video.on('progress', (chunkLength, downloaded) => {
console.log(Downloaded: ${downloaded} bytes);
});
video.pipe(fs.createWriteStream('video.mp4'));
`

---

$3

Fetch full metadata and format info for a video.

- Parameters:
- url (string): Video URL or ID.
- options (object, optional): { lang, requestOptions, agent, ... }

- Returns: Promise