youtube-downloader

Download YouTube videos and HLS streams using yt-dlp and ffmpeg.

1.3k|212|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill youtube-downloader-daymade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-downloader
Source: https://github.com/daymade/claude-code-skills/tree/main/youtube-downloader
Command: npx skills add https://github.com/daymade/claude-code-skills --skill youtube-downloader-daymade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables reliable downloading of YouTube videos and HLS streams (m3u8) using yt-dlp and ffmpeg, including protected content with authentication headers and troubleshooting common download failures like nsig extraction errors and 403s.

Core Features & Use Cases

  • High-quality downloads: Access 1080p/4K formats via PO token provider or browser cookies
  • HLS/protected streams: Download m3u8 streams with required headers
  • Format conversion: Extract audio or convert WebM to MP4 when needed

Quick Start

To get started, provide a YouTube URL and choose your method:

  • Use PO token provider for high-quality formats
  • Or fall back to cookies method if PO is unavailable

Frequently Asked Questions about youtube-downloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download YouTube videos with yt-dlp and ffmpeg?

Download YouTube videos using yt-dlp with ffmpeg by providing a video URL and selecting your authentication method—PO token provider for high-quality 1080p/4K formats, or browser cookies as a fallback. The Skill handles format validation, conversion from WebM to MP4, and quality selection automatically.

Can I download protected YouTube streams and HLS content with authentication?

Yes, protected streams and HLS m3u8 content can be downloaded by supplying authentication headers or browser cookies. The Skill manages cookie-based access and header injection to bypass restrictions on platforms like YouTube, Mux, and Vimeo.

Why am I getting 403 errors or nsig extraction failures when downloading videos?

These errors occur when YouTube's signature extraction fails or access is blocked. Use a PO token provider or inject browser cookies to resolve nsig failures; update yt-dlp to the latest version and verify your authentication credentials are current.

How do I extract audio or convert WebM to MP4 from YouTube downloads?

The Skill supports audio extraction and WebM-to-MP4 conversion during the download process via ffmpeg integration. Specify your desired output format and the conversion runs automatically after download completion.

What are the prerequisites for downloading 4K video quality from YouTube?

To access 4K formats, you need yt-dlp and ffmpeg installed, plus either a PO token provider for signature handling or valid browser cookies. High-quality format access requires one of these authentication methods; standard downloads work without them.

Can I download YouTube playlists in bulk using this method?

Yes, yt-dlp supports playlist downloads by passing a playlist URL instead of a single video link. The Skill applies the same authentication and format-selection logic across all videos in the playlist.