Productivity
yt-dlp-downloader avatar

yt-dlp-downloader

Download videos from YouTube, Twitter, Bilibili, and thousands of sites using yt-dlp. Supports audio extraction, subtitle downloading, and format selection.

Introduction

The yt-dlp-downloader is a powerful automation skill designed for AI agents to retrieve media content from the web efficiently. It leverages the robust yt-dlp command-line tool, enabling users to interact with thousands of video-sharing platforms, including major services like YouTube, Bilibili, Twitter/X, TikTok, and Twitch. This skill is ideal for content creators, researchers, and developers who need a reliable, programmatic way to archive media or extract audio components for further processing.

  • Full compatibility with yt-dlp functionality, allowing for high-quality video downloads, playlist processing, and specific format selection (e.g., 720p, 1080p, or best available).

  • Specialized support for audio extraction, enabling the conversion of video content directly into MP3 format via ffmpeg integration.

  • Automated subtitle management, allowing users to fetch available subtitles in all languages for accessibility and transcription purposes.

  • Intelligent handling of platform-specific restrictions, such as using browser cookies (via chrome, firefox, safari, edge, or brave) to bypass 403 Forbidden errors common on YouTube.

  • Thumbnail acquisition and flexible output path configuration to keep your local downloads organized.

  • Prerequisites: Requires yt-dlp and ffmpeg installed in your environment. Use pip install yt-dlp and brew install ffmpeg to ensure full functionality.

  • Inputs: Accepts standard video URLs or playlist links. Users can specify preferences for quality, audio extraction, or subtitles in natural language prompts.

  • Outputs: Downloads files directly to the local file system with optional naming patterns defined by standard yt-dlp templates.

  • Constraints: Always ensure browser cookies are configured when targeting YouTube to prevent download failures. Use the -F flag to list available formats if the default download quality does not meet requirements. Ensure network access is enabled for the shell environment executing these commands.

Repository Stats

Stars
4,456
Forks
1,217
Open Issues
7
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 30, 2026, 03:45 PM
View on GitHub