vid-yt

A local-first, zero-dependency Node.js library that extracts raw YouTube video and audio streams.

Installation

npm install vid-yt

Quick Start

import { vidSave } from 'vid-yt';

const bestVideo = await vidSave.getBestVideo('https://www.youtube.com/watch?v=dQw4w9WgXcQ');

console.log(bestVideo.quality);    // "1080P"
console.log(bestVideo.directUrl); // "https://rr2---...googlevideo.com/..."

Features

• Raw Google Streams: Extracts direct googlevideo.com URLs when available.
• Smart Helpers: getBestVideo() and getBestAudio() automatically find the highest quality.
• Advanced Filtering: Filter by type, format, or link type using getFormats().
• Link Type Detection: Automatically flags URLs as direct or proxy so you know how to handle them.
• Type-Safe: Built with TypeScript and validated at runtime with Zod.

Documentation

For full guides, API reference, and architecture limitations, visit the Documentation Site.

License

MIT