Organize your
rekordbox library.

LOCAL ACCESS:

Confirm that you can read my local files, run commands on my computer, and look up track information online. If you cannot access my music and rekordbox library from this session, stop and help me open this prompt in an AI agent with a local workspace, such as Codex or Claude Code. Do not claim to have inspected or changed files you cannot access. Explain any missing permissions and wait for me to grant them before continuing.

PREFLIGHT:

Before touching anything, run a quick setup check and walk me through fixes one at a time:

• - Confirm you can see my music folder and my rekordbox library folder. If macOS or Windows asks for file access, Full Disk Access, or accessibility permission, tell me exactly what to approve and wait until I have.
• - Confirm rekordbox is fully quit, find my master.db, and open a copy of it read-only to make sure you can read the library.
• - Confirm Python is available and you can create a venv and install packages into it.

If any check fails, stop and help me fix it first. Do not move on until every check passes.

FIRST, ask me:

• - My OS, rekordbox version, and where my music files are stored
• - Whether to write genre/year into the audio files' tags too, or only inside rekordbox

SAFETY:

Make sure rekordbox is quit. Back up master.db (and its -wal and -shm files if present) with a timestamp before any write. Use pyrekordbox (+ sqlcipher3-wheels on Mac) in a Python venv. Dry-run every step and show me a summary before applying.

1. GENRE + YEAR:

Scan the collection for tracks missing genre or year. Look them up (MusicBrainz, Discogs, Bandcamp, web). For a remix or edit, use that version's year. Show me a table of proposed fixes, then apply after I approve. Leave samples/loops/FX alone and give them the genre "Samples".

2. SMART PLAYLISTS:

Group my existing genres into ~10-20 main genres. Show me the grouping and let me edit it. Then build rekordbox Intelligent Playlists:

• - "Genres" folder: one per main genre. Each one ORs exact genre names plus "contains" matches for spelling variants and subgenres (e.g. Hip Hop/Hip-Hop/HipHop/Rap; Drum & Bass/DnB/Jungle).
• - "Decades" folder: one per decade, using a Year range.

Then confirm that every track lands in at least one playlist and list any that don't.

3. HOT CUES (OPTIONAL):

STOP and ask me if I want this, and warn me it writes hot cues to my tracks. If I say yes: read rekordbox's phrase analysis (PSSI in the ANLZ files; tracks must be analyzed first) and set up to 8 hot cues at section changes, labeled Intro/Build/Drop/Breakdown/Outro, or Intro/Verse/Chorus/Bridge/Outro for songs. NEVER touch tracks that already have hot cues. Test on 3 tracks first so I can check them in rekordbox before running the rest.