DJ set ripper

Download individual songs from a DJ set or mix. Given a link from YouTube, SoundCloud, Mixcloud, or 1001Tracklists, extract the tracklist from the page descr...

Security Scan

The skill appears to do what it claims (extract a DJ set tracklist and download individual tracks) and its instructions are proportionate, with a small documentation mismatch about required binaries.

Purpose & Capability

The name/description match the behavior: extracting tracklists and sourcing/downloading tracks. However, the registry metadata lists no required binaries while SKILL.md explicitly depends on external tools (yt-dlp, ffmpeg/ffprobe, spotdl) and another skill (dj-mp3-sourcer). This is a documentation/inventory gap but not necessarily malicious.

Instruction Scope

SKILL.md stays on task: fetch page content, parse tracklist, call the dj-mp3-sourcer workflow, download files, normalize filenames, and write a log. It does not ask for unrelated file reads, extra credentials, or transmit data to unexpected endpoints. It does use web_fetch/web_search, sessions_spawn, and runs shell commands (yt-dlp, ffprobe, mv), which are expected for this use case.

Install Mechanism

Instruction-only skill with one small helper script; no install spec or remote downloads. The included bash script is transparent and operates on local files. No high-risk install behavior observed.

Credentials

The skill does not request environment variables, credentials, or privileged config paths. Its external needs (command-line tools and the dj-mp3-sourcer skill) are reasonable for downloading audio.

Persistence & Privilege

always:false and the skill does not request persistent or system-wide changes. It writes output to ~/Downloads and /tmp as expected for a downloader; no modification of other skills or global agent configuration is present.

Assessment

This skill appears functionally coherent but check a few things before installing: (1) ensure you have the required tools (yt-dlp, ffmpeg/ffprobe, jq, spotdl) and that the registry metadata accurately lists them—SKILL.md names these but the metadata shows none; (2) review the referenced dj-mp3-sourcer skill (it performs the actual sourcing/downloading) to confirm you trust its behavior; (3) be aware it will run shell commands and write files to ~/Downloads and /tmp and may download data from user-supplied URLs—avoid running on untrusted links; (4) copyright risk: the skill warns about legality—only download content you are permitted to. If you want higher assurance, ask the author to update the metadata to declare the required binaries and provide the dj-mp3-sourcer dependency link/source for review.

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.

Workflow

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"):

1. Use the dj-mp3-sourcer workflow: search sources in priority order, prefer extended mixes, download or surface purchase links
2. Use sessions_spawn to parallelize downloads (batch of 3-5 at a time to avoid rate limits)
3. 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

Setting	Default	Notes
Output directory	~/Downloads/{set-name}/	Per-set subfolder
Format	mp3 320k	Via dj-mp3-sourcer
Download full mix	ask user	Can be set to always/never
Free only mode	true	Passed through to dj-mp3-sourcer (skip paid sources, use spotdl/yt-dlp only)
Parallel downloads	5	Max concurrent track downloads