# Send DJ set ripper to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dj-set-ripper",
    "name": "DJ set ripper",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Robinnnnn/dj-set-ripper",
    "canonicalUrl": "https://clawhub.ai/Robinnnnn/dj-set-ripper",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/dj-set-ripper",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-set-ripper",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/normalize-filenames.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "dj-set-ripper",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T08:25:54.569Z",
      "expiresAt": "2026-05-09T08:25:54.569Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-set-ripper",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dj-set-ripper",
        "contentDisposition": "attachment; filename=\"dj-set-ripper-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "dj-set-ripper"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/dj-set-ripper"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dj-set-ripper",
    "downloadUrl": "https://openagent3.xyz/downloads/dj-set-ripper",
    "agentUrl": "https://openagent3.xyz/skills/dj-set-ripper/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dj-set-ripper/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dj-set-ripper/agent.md"
  }
}
```
## Documentation

### DJ Set Ripper

Extract tracklists from DJ sets and download each track individually.

⚠️ Legal Notice: This skill is intended for downloading music you have the right to access — purchases, free releases, creative commons, etc. Respect copyright laws in your jurisdiction. The author is not responsible for misuse.

### Dependencies

Same as dj-mp3-sourcer (yt-dlp, ffmpeg/ffprobe, spotdl). No additional dependencies.

### 1. Extract Page Content

Fetch the set URL and extract raw text (description, metadata, comments):

YouTube:

yt-dlp --dump-json "<url>" | jq -r '.description'

SoundCloud / Mixcloud:
Use web_fetch to grab the page content in markdown mode.

1001Tracklists:
Use web_fetch — this source has the most structured data. Prefer it when available.

### 2. Parse the Tracklist (LLM-Powered)

Feed the raw page content to the model with this prompt structure:

Extract all tracks from this DJ set description. Return a JSON array of objects:
[{"number": 1, "timestamp": "0:00", "artist": "Artist Name", "title": "Track Title (Mix Name)"}]

Rules:
- Preserve remix/mix names in the title (e.g. "Original Mix", "Extended Mix", "Remix")
- If a track is listed as "ID - ID" or "ID", set artist and title both to "ID"
- If only a timestamp exists with no track info, skip it
- Normalize artist names (fix ALL CAPS, etc.)
- If no timestamps exist, set timestamp to null
- Number tracks sequentially starting from 1

Raw content:
"""
{description_text}
"""

If parsing returns zero tracks, inform the user the tracklist couldn't be extracted and suggest:

Checking 1001Tracklists manually
Pasting the tracklist directly

### 3. Download Each Track

For each parsed track (skipping any with artist AND title = "ID"):

Use the dj-mp3-sourcer workflow: search sources in priority order, prefer extended mixes, download or surface purchase links
Use sessions_spawn to parallelize downloads (batch of 3-5 at a time to avoid rate limits)
Save files to: ~/Downloads/{set-name}/

Set name is derived from the mix title (sanitized for filesystem).

### 4. Optionally Download the Full Mix

Ask the user if they also want the full mix downloaded. If yes:

yt-dlp -x --audio-format mp3 --audio-quality 0 \\
  --embed-thumbnail --add-metadata \\
  -o "~/Downloads/{set-name}/{set-name} [Full Mix].%(ext)s" "<url>"

### 5. Normalize Filenames

After all downloads complete (not per-batch — wait for every sub-agent to finish), run the normalization script once:

# 1. Write the parsed tracklist as JSON
cat > /tmp/tracklist.json << 'EOF'
[{"artist": "Artist", "title": "Title"}, ...]
EOF

# 2. Run normalize
scripts/normalize-filenames.sh ~/Downloads/{set-name} /tmp/tracklist.json

This fuzzy-matches each mp3 to a tracklist entry and renames to clean Artist - Title.mp3. Handles NA - prefixes, (Official Video) junk, wrong artist credits, label names, etc.

Critical: Run this in the parent agent after all batches return — do NOT rely on sub-agents to rename. The parsed tracklist is the source of truth for filenames.

### 6. Generate the Log File

Create ~/Downloads/{set-name}/{timestamp}.log with format:

DJ Set Ripper Log
=================
Set: {set title}
URL: {original url}
Date: {ISO timestamp}
Tracks found: {total}

#   | Artist              | Title                          | Status         | Source   | Bitrate | Size  | File/Link
----|---------------------|--------------------------------|----------------|----------|---------|-------|----------
01  | Argy                | Aria (Original Mix)            | ✅ downloaded   | spotdl   | 320k    | 8.2MB | Argy - Aria (Original Mix).mp3
02  | ID                  | ID                             | ⬛ unidentified | —        | —       | —     | —
03  | Massano             | Odyssey                        | ✅ downloaded   | youtube  | 271k    | 6.5MB | Massano - Odyssey.mp3
04  | Boris Brejcha       | Gravity (Extended Mix)         | 🛒 purchase     | beatport | —       | —     | https://...
05  | Some Bootleg        | Unreleased VIP                 | ❌ not found    | —        | —       | —     | —

Summary: 3 downloaded, 1 purchase link, 1 not found, 1 unidentified
Total size: ~XXM (individual tracks) + XXM (full mix)
Full mix: ✅ downloaded → {set-name} [Full Mix].mp3

Notes:
- Bitrate via \`ffprobe -v quiet -show_entries format=bit_rate -of csv=p=0 "<file>"\`
- File size via \`ls -lh\`

### Edge Cases

No tracklist in description — check 1001Tracklists via web_search: "{set title}" site:1001tracklists.com
"ID - ID" tracks — log as unidentified, don't attempt download
Bootlegs / mashups — search anyway, but expect failures. log as not found with note
B2B sets — multiple artists in set title, handle gracefully
Duplicate tracks — deduplicate by artist+title before downloading
Very long sets (50+ tracks) — batch in groups of 5, report progress as batches complete

### Configuration

SettingDefaultNotesOutput directory~/Downloads/{set-name}/Per-set subfolderFormatmp3 320kVia dj-mp3-sourcerDownload full mixask userCan be set to always/neverFree only modetruePassed through to dj-mp3-sourcer (skip paid sources, use spotdl/yt-dlp only)Parallel downloads5Max concurrent track downloads
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Robinnnnn
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T08:25:54.569Z
- Expires at: 2026-05-09T08:25:54.569Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/dj-set-ripper)
- [Send to Agent page](https://openagent3.xyz/skills/dj-set-ripper/agent)
- [JSON manifest](https://openagent3.xyz/skills/dj-set-ripper/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/dj-set-ripper/agent.md)
- [Download page](https://openagent3.xyz/downloads/dj-set-ripper)