@ooneex/youtube

YouTube video downloader and metadata extraction library for fetching video information, thumbnails, and media streams.

Features

✅ Transcript Fetching - Retrieve timestamped transcripts and video metadata via Youtube#transcript

✅ ytdlp Integration - Type definitions for ytdlp-nodejs including video/audio quality, format options, and download progress

✅ Quality Types - YoutubeVideoQualityType (144p to 2160p) and YoutubeAudioQualityType for stream selection

✅ Error Handling - Custom YoutubeException for YouTube-specific error scenarios

✅ Type-Safe - Full TypeScript support with IYoutube interface and re-exported ytdlp types

For URL helpers like getId, getEmbedUrl, and getWatchUrl, see @ooneex/youtube-utils.

Installation

bun add @ooneex/youtube

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Setup

Clone the repository
Install dependencies: bun install
Run tests: bun run test
Build the project: bun run build

Guidelines

Write tests for new features
Follow the existing code style
Update documentation for API changes
Ensure all tests pass before submitting PR

Made with ❤️ by the Ooneex team