VDJTools repairs your VirtualDJ library by working through a simple, careful cycle: export → review → validate → import. It never rewrites your VirtualDJ files directly on a whim — every change passes through a workbook you can see, edit, and approve first.
What it works on #
VirtualDJ keeps track of your music in a few different places, and each can drift out of sync when files move, get renamed, or change drives:
- Database — the master record of every track VirtualDJ knows about
- Folders — your virtual folders and favourite folders
- Playlists — saved playlists that reference specific tracks
- History — your play history, which also references tracks by path
When a file moves, any of these can end up pointing at a location that no longer exists.
How a repair works #
Every repair follows the same shape:
- Export — VDJTools scans for broken references and lists them in a workbook
- Review — you look over what it found, and can let AutoFix propose matches
- Validate — VDJTools checks the workbook is sound before anything is written
- Import — the reviewed, validated changes are written back to VirtualDJ
Nothing is written to your library until you reach import — and even then, a backup means you’re never stuck with a bad result.
Designed to be careful, not fast-and-loose #
VDJTools is built so you stay in control. It won’t force changes through automatically: it proposes, you review, and only confirmed changes get written. If something looks wrong at any stage, you can stop, fix it in the workbook, and carry on.
Where to start #
If this is your first time using VDJTools, the normal order is: take a backup, run a Healthcheck to see the full picture, then start with a Database repair.
- Healthcheck
- Backup
- Database Repair
- Understanding the Workbook
