Skip to content
Back to search

yt-dlp-downloader

Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "下载视频", "download video", "yt-dlp", "YouTube", "B站", "抖音", "提取音频", "extract audio".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mapleshaw--yt-dlp-downloader-skill/badge.svg)](/listings/mapleshaw--yt-dlp-downloader-skill)

HTML

<a href="/listings/mapleshaw--yt-dlp-downloader-skill"><img src="/api/listings/mapleshaw--yt-dlp-downloader-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: Clone to Cursor skills directory

git clone https://github.com/MapleShaw/yt-dlp-downloader-skill.git ~/.cursor/skills/yt-dlp-downloader

Option 2: Manual installation

1. Create the skill directory:

   mkdir -p ~/.cursor/skills/yt-dlp-downloader/scripts

2. Download `SKILL.md` and `scripts/download.sh` from this repository

3. Place them in the created directory

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 236 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: yt-dlp-downloader
  3. description: Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "下载视频", "download video", "yt-dlp", "YouTube", "B站", "抖音", "提取音频", "extract audio".
  4. ---
  5. # yt-dlp Video Downloader
  6. Download videos from thousands of websites using yt-dlp.
  7. ## Prerequisites
  8. Before downloading, verify dependencies are installed:
  9. ```bash
  10. # Check yt-dlp
  11. which yt-dlp || echo "yt-dlp not installed. Install with: pip install yt-dlp"
  12. # Check ffmpeg (required for audio extraction and format merging)
  13. which ffmpeg || echo "ffmpeg not installed. Install with: brew install ffmpeg"
  14. ```
  15. If not installed, install them first:
  16. ```bash
  17. pip install yt-dlp
  18. brew install ffmpeg # macOS
  19. ```
  20. ## Quick Start
  21. ### Basic Download (Best Quality)
  22. ```bash
  23. yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"
  24. ```
  25. ### YouTube Download (Recommended - with cookies)
  26. YouTube often blocks direct downloads with 403 errors. Always use browser cookies for YouTube:
  27. ```bash
  28. yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"
  29. ```
  30. Supported browsers: `chrome`, `firefox`, `safari`, `edge`, `brave`, `opera`
  31. ### Download with Custom Output Path
  32. ```bash
  33. yt-dlp -P "/path/to/save" -o "%(title)s.%(ext)s" "VIDEO_URL"
  34. ```
  35. ## Common Tasks
  36. ### 1. Download Video (Default - Best Quality)
  37. ```bash
  38. yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"
  39. ```
  40. ### 2. Extract Audio Only (MP3)
  41. ```bash
  42. yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "VIDEO_URL"
  43. ```
  44. ### 3. Download with Subtitles
  45. ```bash
  46. yt-dlp -P "~/Downloads/yt-dlp" --write-subs --sub-langs all "VIDEO_URL"
  47. ```
  48. ### 4. Download Specific Quality
  49. **720p:**
  50. ```bash
  51. yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL"
  52. ```
  53. **1080p:**
  54. ```bash
  55. yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL"
  56. ```
  57. **Best available:**
  58. ```bash
  59. yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo+bestaudio/best" "VIDEO_URL"
  60. ```
  61. ### 5. List Available Formats (Before Download)
  62. ```bash
  63. yt-dlp -F "VIDEO_URL"
  64. ```
  65. Then download specific format by ID:
  66. ```bash
  67. yt-dlp -P "~/Downloads/yt-dlp" -f FORMAT_ID "VIDEO_URL"
  68. ```
  69. ### 6. Download Playlist
  70. ```bash
  71. # Download entire playlist
  72. yt-dlp -P "~/Downloads/yt-dlp" -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"
  73. # Download specific range (e.g., items 1-5)
  74. yt-dlp -P "~/Downloads/yt-dlp" -I 1:5 "PLAYLIST_URL"
  75. ```
  76. ### 7. Download with Thumbnail
  77. ```bash
  78. yt-dlp -P "~/Downloads/yt-dlp" --write-thumbnail "VIDEO_URL"
  79. ```
  80. ## Workflow
  81. When user provides a video URL:
  82. 1. **Identify the platform**:
  83. - YouTube/YouTube Music → **Always use `--cookies-from-browser chrome`**
  84. - Other sites → Try without cookies first
  85. 2. **Ask what they want** (if not specified):
  86. - Just download the video?
  87. - Extract audio only?
  88. - Need subtitles?
  89. - Specific quality?
  90. 3. **Construct the command** based on requirements
  91. 4. **Execute the download** using Shell tool with `required_permissions: ["all", "network"]`
  92. 5. **Handle errors**:
  93. - 403 Forbidden → Retry with `--cookies-from-browser`
  94. - Connection issues → yt-dlp auto-resumes, just retry
  95. - Format unavailable → Use `-F` to list formats, then select
  96. 6. **Report the result** - file location and any errors
  97. ## Example Interaction
  98. User: "帮我下载这个视频 https://www.youtube.com/watch?v=xxx"
  99. Response:
  100. ```bash
  101. # YouTube - use cookies to avoid 403 errors
  102. yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"
  103. ```
  104. User: "下载这个视频的音频 https://www.bilibili.com/video/xxx"
  105. Response:
  106. ```bash
  107. # Bilibili - extracting audio as MP3
  108. yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "https://www.bilibili.com/video/xxx"
  109. ```
  110. User: "下载这个 Twitter 视频 https://twitter.com/xxx/status/123"
  111. Response:
  112. ```bash
  113. # Twitter/X - direct download usually works
  114. yt-dlp -P "~/Downloads/yt-dlp" "https://twitter.com/xxx/status/123"
  115. ```
  116. ## Supported Sites
  117. yt-dlp supports thousands of sites including:
  118. - YouTube, YouTube Music
  119. - Bilibili (B站)
  120. - Twitter/X
  121. - TikTok, Douyin (抖音)
  122. - Vimeo
  123. - Twitch
  124. - And many more...
  125. Full list: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
  126. ## Troubleshooting
  127. ### Common Errors and Solutions
  128. | Error | Cause | Solution |
  129. |-------|-------|----------|
  130. | HTTP 403 Forbidden | YouTube blocks unauthenticated requests | Use `--cookies-from-browser chrome` |
  131. | Video unavailable | Geo-restricted or private | Use cookies or VPN |
  132. | Download interrupted | Network issues | Retry - yt-dlp auto-resumes |
  133. | Format not available | Requested format doesn't exist | Use `-F` to list formats |
  134. ### Error: "yt-dlp: command not found"
  135. ```bash
  136. pip install yt-dlp
  137. ```
  138. ### Error: "ffmpeg not found" (for audio extraction)
  139. ```bash
  140. brew install ffmpeg # macOS
  141. ```
  142. ### Error: HTTP 403 Forbidden (YouTube)
  143. This is the most common YouTube error. **Always use cookies for YouTube:**
  144. ```bash
  145. # Recommended approach for YouTube
  146. yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"
  147. ```
  148. Supported browsers: `chrome`, `firefox`, `safari`, `edge`, `brave`, `opera`
  149. ### Error: Video unavailable or geo-restricted
  150. ```bash
  151. # Try with cookies from browser
  152. yt-dlp --cookies-from-browser chrome "VIDEO_URL"
  153. # Or use a specific format
  154. yt-dlp -F "VIDEO_URL" # List formats first
  155. yt-dlp -f FORMAT_ID "VIDEO_URL"
  156. ```
  157. ### Error: Download keeps failing
  158. ```bash
  159. # Update yt-dlp to latest version
  160. pip install -U yt-dlp
  161. # Force IPv4 (sometimes helps with connection issues)
  162. yt-dlp -4 "VIDEO_URL"
  163. ```
  164. ### Best Practices
  165. 1. **YouTube downloads**: Always use `--cookies-from-browser chrome`
  166. 2. **Large files**: yt-dlp auto-resumes, just retry if interrupted
  167. 3. **Keep yt-dlp updated**: `pip install -U yt-dlp`
  168. 4. **Check formats first**: Use `-F` before downloading if unsure
README.md · README · 105 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # yt-dlp Downloader Skill
  2. A [Cursor](https://cursor.sh) Agent Skill for downloading videos from YouTube, Bilibili, Twitter, and thousands of other sites using [yt-dlp](https://github.com/yt-dlp/yt-dlp).
  3. [中文文档](./README_CN.md)
  4. ## Features
  5. - Download videos from 1000+ websites
  6. - Extract audio (MP3)
  7. - Download subtitles
  8. - Select video quality (720p/1080p/best)
  9. - Auto-handle YouTube 403 errors with browser cookies
  10. - Resume interrupted downloads
  11. ## Prerequisites
  12. Before using this skill, make sure you have the following installed:
  13. ```bash
  14. # Install yt-dlp
  15. pip install yt-dlp
  16. # Install ffmpeg (required for audio extraction)
  17. brew install ffmpeg # macOS
  18. # or: sudo apt install ffmpeg # Linux
  19. ```
  20. ## Installation
  21. ### Option 1: Clone to Cursor skills directory
  22. ```bash
  23. git clone https://github.com/MapleShaw/yt-dlp-downloader-skill.git ~/.cursor/skills/yt-dlp-downloader
  24. ```
  25. ### Option 2: Manual installation
  26. 1. Create the skill directory:
  27. ```bash
  28. mkdir -p ~/.cursor/skills/yt-dlp-downloader/scripts
  29. ```
  30. 2. Download `SKILL.md` and `scripts/download.sh` from this repository
  31. 3. Place them in the created directory
  32. ## Usage
  33. Simply tell Cursor what you want to download:
  34. | Command | Example |
  35. |---------|---------|
  36. | Download video | "Download this video https://youtube.com/watch?v=xxx" |
  37. | Extract audio | "Extract audio from https://youtube.com/watch?v=xxx" |
  38. | Download with subtitles | "Download with subtitles https://youtube.com/watch?v=xxx" |
  39. | Specific quality | "Download in 720p https://youtube.com/watch?v=xxx" |
  40. ### Example Conversations
  41. **You:** Download this video https://www.youtube.com/watch?v=xxx
  42. **Cursor:**
  43. ```bash
  44. yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"
  45. ```
  46. ## Supported Sites
  47. yt-dlp supports thousands of sites including:
  48. - YouTube / YouTube Music
  49. - Bilibili (B站)
  50. - Twitter / X
  51. - TikTok / Douyin (抖音)
  52. - Vimeo
  53. - Twitch
  54. - And [many more...](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)
  55. ## Troubleshooting
  56. | Error | Solution |
  57. |-------|----------|
  58. | HTTP 403 Forbidden (YouTube) | Use `--cookies-from-browser chrome` |
  59. | yt-dlp not found | Run `pip install yt-dlp` |
  60. | ffmpeg not found | Run `brew install ffmpeg` |
  61. | Download fails | Run `pip install -U yt-dlp` to update |
  62. ## File Structure
  63. ```
  64. yt-dlp-downloader/
  65. ├── SKILL.md # Main skill instructions
  66. └── scripts/
  67. └── download.sh # Helper script
  68. ```
  69. ## License
  70. MIT
  71. ## Credits
  72. - [yt-dlp](https://github.com/yt-dlp/yt-dlp) - The powerful video downloader
  73. - [Cursor](https://cursor.sh) - AI-powered code editor

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.