/install bootleg-link
Bootleg-Link Skill
DJ music downloader - Downloads music from YouTube channels/playlists and converts to high-quality MP3.
What It Does
Download music from YouTube channels or playlists, convert to 320kbps MP3 with metadata, and manage batch downloads with resume capability.
Features
- Batch Download: Process multiple channels/playlists from a text file
- Resume Support: Skip already downloaded videos using
--download-archive - High Quality: Convert to 320kbps MP3 with thumbnail embedding
- Smart Deduplication: Automatically skip previously downloaded content
- Concurrent Download: Utilize multiple CPU cores for parallel downloads
Usage
Single Channel/Playlist
bootleg-link "https://www.youtube.com/@VeryHouseMusic"
Batch Mode
bootleg-link --batch /path/to/channels.txt
Resume Interrupted Download
bootleg-link --batch /path/to/output/directory
Custom Output Directory
bootleg-link "https://www.youtube.com/@ChannelName" -o /path/to/output
Configuration
Environment Variables
| Variable | Default | Description |
|---|---|---|
BOOTLEG_OUTPUT_DIR |
/mnt/e/bootleg-link-downloader/output |
Default output directory |
BOOTLEG_QUALITY |
320 |
MP3 bitrate (128, 192, 256, 320) |
BOOTLEG_CONCURRENCY |
8 |
Number of concurrent downloads |
BOOTLEG_ARCHIVE_FILE |
download-archive.txt |
File to track downloaded videos |
Link File Format (.bootleg-link.txt)
https://www.youtube.com/@Channel1
https://www.youtube.com/playlist?list=PLxxx
https://www.youtube.com/@Channel2
Advanced Options
CPU-Based Concurrency
Automatically adjusts based on CPU cores:
| CPU Cores | Videos | Fragments per Video |
|---|---|---|
| 4 | 2 | 2 |
| 8 | 4 | 4 |
| 16 | 8 | 4 |
| 32+ | 16 | 8 |
Use -N for concurrent videos and --concurrent-fragments for per-video parallelism.
Custom Filename Template
--output-template "%(title)s.%(ext)s"
Audio Format Options
--format bestaudio --extractor-args "youtube:player_client=android"
Troubleshooting
JS Challenge Error
If YouTube JS challenge decryption fails, it falls back to format 251 (opus 128kbps) - still good quality.
Network Timeout
Auto-retries on timeout. For persistent issues, increase --socket-timeout.
Rate Limiting
Add --sleep-interval between downloads:
bootleg-link --batch . --sleep-interval 5
Dependencies
- yt-dlp: YouTube downloader
- ffmpeg: Audio conversion
- mutagen (optional): For metadata embedding
Installation
# Install dependencies
pip install yt-dlp mutagen
# Make executable (if provided as script)
chmod +x bootleg-link
Example Output
[download] Downloading channel: VeryHouseMusic
[download] Channel has 9926 videos
[download] Already downloaded: 388 / 9926 (3.9%)
[download] Starting download of remaining 9538 videos...
[download] Output: /mnt/e/bootleg-link-downloader/output/house(VeryHouseMusic Dump)/
Notes
- Uses
--download-archiveto track downloaded videos - Automatically creates playlist-named subdirectories
- Embeds thumbnail as album art in MP3 files
- Run again with same output dir to resume seamlessly
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install bootleg-link - 安装完成后,直接呼叫该 Skill 的名称或使用
/bootleg-link触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Bootleg Link 是什么?
Download music from YouTube channels/playlists and convert to 320kbps MP3. Supports batch processing, resume interrupted downloads, and concurrent downloading. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 116 次。
如何安装 Bootleg Link?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install bootleg-link」即可一键安装,无需额外配置。
Bootleg Link 是免费的吗?
是的,Bootleg Link 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Bootleg Link 支持哪些平台?
Bootleg Link 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux, macos)。
谁开发了 Bootleg Link?
由 esanle(@esanle)开发并维护,当前版本 v1.0.1。