Library Cleanup

Five sessions that build on each other. Follow them in order — each one depends on the last.

Before you start, consider running a Library Health scan to catch broken links, orphan files, and duplicates. Fixing structural issues first saves you from redoing work later.

Caution

Session 1 writes directly to your audio files. Sessions 3-5 stage changes as XML — your Rekordbox database only updates after you import the XML yourself. Complete each checkpoint before moving on. Session 2 is a terminal command, not an agent session.

Why order matters

Clean metadata > accurate enrichment > label data > genre signals

Enrichment matches on artist and title — typos cause missed matches. Genre classification uses enrichment and audio analysis as evidence. If you skip ahead, you’ll get worse results and end up re-running things.

Sessions

Session 1: Collection Audit

Requires reklawdbox connected

Paste into your agent:

Audit my collection for naming and tagging issues.

This fixes artist names, track titles, and file naming conventions. Getting these right first means better enrichment match rates in Session 2.

Collection Audit details

Checkpoint

No XML needed here — Collection Audit writes directly to files. Spot-check a few corrected tracks in Rekordbox, then start a fresh session for Session 2.

---

Session 2: Enrichment

Requires Session 1 complete

Run this in your terminal (not through the agent):

reklawdbox hydrate --cpu overnight -y

This fetches metadata from Discogs, Beatport, MusicBrainz, and Bandcamp, plus runs audio analysis on every track. --cpu overnight uses most of your cores; -y skips the confirmation prompt.

When it finishes, run reklawdbox hydrate again — it’ll report any remaining gaps. All providers should be at 100% before moving on.

---

Session 3: Metadata Backfill

Requires Session 2 complete (all providers at 100%)

Paste into your agent:

Find tracks missing labels and years in my collection and fill them from enrichment data.

Labels are the strongest genre signal for electronic music. Years give era context. The agent fills in what’s missing from enrichment data and shows you any conflicts for review.

Metadata Backfill details

Checkpoint

The agent will ask to export to XML. Approve, then import into Rekordbox:

1. Add XML to Rekordbox — Open Preferences → Advanced → rekordbox xml → Imported Library → Browse → select the exported XML file.

2. Verify in the XML view — In the sidebar, click the “Display rekordbox xml” icon. Browse the imported tracks under “All Tracks” and check that the metadata looks correct before importing.

3. Import into collection — Once satisfied, select all tracks (Cmd+A), right-click → Import To Collection. When prompted “Do you want to load information in the tag of the library being imported?”, click Yes (tick “Don’t ask me again” for bulk imports).

Start a fresh session for Session 4.

---

Session 4: Genre Classification

Requires Session 3 XML imported

Paste into your agent:

Classify genres for my ungenred tracks.

The agent normalizes any genre aliases first, then classifies tracks in batches. You review results grouped by confidence — high and medium confidence can usually be approved in bulk, while low confidence needs a closer look.

Genre Classification details

Checkpoint

Export to XML, import into Rekordbox. Verify a few genres look right, then start a fresh session for Session 5.

1. Add XML to Rekordbox — Open Preferences → Advanced → rekordbox xml → Imported Library → Browse → select the exported XML file.

2. Verify in the XML view — In the sidebar, click the “Display rekordbox xml” icon. Browse the imported tracks under “All Tracks” and check that the metadata looks correct before importing.

3. Import into collection — Once satisfied, select all tracks (Cmd+A), right-click → Import To Collection. When prompted “Do you want to load information in the tag of the library being imported?”, click Yes (tick “Don’t ask me again” for bulk imports).

---

Session 5: Genre Audit

Requires Session 4 XML imported

Paste into your agent:

Audit my existing genre tags.

This checks your existing genre tags against enrichment and audio evidence. It only shows you conflicts and things that need a second look — confirmed genres are skipped.

Genre Audit details

Checkpoint

Export to XML, import into Rekordbox. Spot-check the corrections.

1. Add XML to Rekordbox — Open Preferences → Advanced → rekordbox xml → Imported Library → Browse → select the exported XML file.

2. Verify in the XML view — In the sidebar, click the “Display rekordbox xml” icon. Browse the imported tracks under “All Tracks” and check that the metadata looks correct before importing.

3. Import into collection — Once satisfied, select all tracks (Cmd+A), right-click → Import To Collection. When prompted “Do you want to load information in the tag of the library being imported?”, click Yes (tick “Don’t ask me again” for bulk imports).

---

Skipping sessions

• Metadata already clean? Start at Session 2.
• Already enriched? Re-run reklawdbox hydrate — if all providers are at 100%, jump to Session 3.
• Labels and years present? Skip Session 3.
• No ungenred tracks? Skip Session 4.
• No existing genre tags? Skip Session 5.

What’s next

With your library clean, enriched, and genre-tagged, you’re ready for the good stuff:

Set Building

Build transition-scored DJ sequences with energy curve shaping. Build a set

Pool Building

Find compatible track pools for live improvisation. Build a pool

DJ Prompts

Gig prep, collection analysis, practice sessions, and more. Browse prompts