← 返回 Skills 市场
esanle

Bootleg Link

作者 esanle · GitHub ↗ · v1.0.1 · MIT-0
linuxmacos ⚠ suspicious
116
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install bootleg-link
功能描述
Download music from YouTube channels/playlists and convert to 320kbps MP3. Supports batch processing, resume interrupted downloads, and concurrent downloading.
使用说明 (SKILL.md)

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-archive to 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
安全使用建议
The core downloader instructions look coherent and proportional for a yt-dlp + ffmpeg-based tool. However, the included scripts/bootleg-ssh.sh is unrelated to downloading and provides multiple tunneling options (websocket bridge, DNS tunnel, HTTP proxy, SSH-over-443). Before installing or running this skill: 1) Verify the skill's origin — the source/homepage is unknown. 2) Inspect or remove scripts/bootleg-ssh.sh if you don't need it; do not run it unless you understand the networking implications. 3) Avoid running the script with sudo; it references tools (websocat, iodine, nc) that may need separate review. 4) Consider running the skill in a sandbox/VM or container and review where the default output directory points (the default /mnt/e/... may be unintended). 5) Remember downloading YouTube content can violate service terms or copyright law — ensure you have the right to download the media. If you cannot confirm why the SSH tunneling script is included, treat the package as untrusted.
能力评估
Purpose & Capability
The skill's name, description, and instructions all describe downloading and converting YouTube audio and only require yt-dlp and ffmpeg. However, the bundle includes scripts/bootleg-ssh.sh which implements multiple SSH tunneling methods (websocket bridging, DNS tunnel via iodine, HTTP CONNECT proxy, SSH-over-443). An SSH tunneling utility is not required or explained by the downloader's purpose and is therefore an incoherent and disproportionate inclusion.
Instruction Scope
The SKILL.md instructions themselves are focused on downloading and conversion and only reference yt-dlp, ffmpeg, and optional mutagen. They declare a few BOOTLEG_* environment variables for output and concurrency. The README does not instruct the agent to run the SSH tunneling script, but the script is bundled in the package and expands what a user/agent could run — enabling covert/proxy network channels and requiring additional binaries (websocat, iodine, nc). This increases scope beyond what the documentation states.
Install Mechanism
This is an instruction-only skill (no install spec). That minimizes automatic disk changes at install time. The SKILL.md recommends pip-installing yt-dlp and mutagen, which is proportional for the stated functionality.
Credentials
The skill declares no required credentials and only a few benign configuration env vars (output dir, quality, concurrency, archive file). One minor oddity: the default BOOTLEG_OUTPUT_DIR is /mnt/e/..., which looks like a Windows-mounted drive path and may be inappropriate on many Linux/macOS hosts (could lead to unexpected write locations). No secret or cloud credentials are requested.
Persistence & Privilege
The skill is not forced-always and does not request elevated platform privileges. It does not attempt to modify other skills or system-wide agent configs. The included shell script may suggest commands that need sudo (iodine), but the skill metadata does not request persistence or elevated privileges by itself.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install bootleg-link
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /bootleg-link 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
bootleg-link v1.0.1 - Improved documentation in SKILL.md, detailing features, configuration, usage, and troubleshooting. - Clarified support for batch processing, resuming downloads, and concurrent downloads. - Added environment variable options and advanced CPU concurrency documentation. - Outlined dependency requirements and installation steps. - Provided example output and practical notes for a smoother user experience.
v1.0.0
- Initial release of the bootleg-link skill. - Enables creating unofficial or alternative links between systems to bypass blocked or unavailable protocols. - Provides practical examples for SSH tunneling, WebSocket-to-SSH bridging, HTTP tunneling, port switching, and DNS tunneling. - Includes usage scenarios for corporate firewalls, cloud services, and IoT devices. - Lists required tools (curl, ssh, nc/netcat, optional: websocat, socat). - Offers troubleshooting tips, security guidelines, and advanced connection techniques.
元数据
Slug bootleg-link
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

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。

💬 留言讨论