Healthcheck is a read-only scan of your VirtualDJ library. It doesn’t change anything — it just tells you what’s going on: how many broken paths are in your database, folders, playlists and history, and what to run next. If the answer’s zero, you’re done: go and play a gig.
It’s free, along with Backup and Restore, so run it early and often: before you start a repair, and again afterwards to confirm it worked.
When to use it #
Run it before the start of any repair workflow, after you’ve imported changes, and every so often as routine maintenance. It’s the natural first thing to do with VDJTools, and it’s completely safe to run at any time — nothing gets written to your library.
What it does #
It reports what needs attention across your database, folders, playlists, and history, so you can see the shape of the problem before deciding where to start. It doesn’t apply any fixes itself — for that, you’d move on to the relevant repair page.
Example commands #
vdjtools /healthcheck
vdjtools /healthcheck /verboseExample output #
Virtual DJ Tools (vBeta)
Copyright© 2024-2026 Quick Apps UK. All rights reserved
Build: 1.0.38.0
healthcheck: true
Database loaded: 11 songs from C:UsersDJOneDriveVirtualDJdatabase.xml
Database loaded: 1 songs from D:VirtualDJdatabase.xml
Database loaded: 33755 songs from E:VirtualDJdatabase.xml
Database loaded: 3133 songs from F:VirtualDJdatabase.xml
Database loaded: 0 songs from H:VirtualDJdatabase.xml
Folders loaded: 469 folders from C:UsersDJOneDriveVirtualDJFolders
Folders loaded: 3 folders from D:VirtualDJFolders
Folders loaded: 1618 folders from E:VirtualDJFolders
Folders loaded: 2213 folders from F:VirtualDJFolders
Folders loaded: 3 folders from H:VirtualDJFolders
Playlists loaded: 1128 playlists from C:UsersDJOneDriveVirtualDJPlaylists
Histories loaded: 1023 histories from C:UsersDJOneDriveVirtualDJHistory
[Scan] Database: databases=5, scanned=36900, issues=0
[Scan] Folders: virtualFolders=3468, favoriteFolders=154, scanned=10628, issues=4106
[Scan] Playlists: playlists=1128, scanned=11223, issues=7317
[Scan] History: histories=1023, scanned=62112, issues=1169
════════════════════════════════════════
VDJTools Health Check Report
════════════════════════════════════════
Overall status : ISSUES FOUND
Items scanned : 649463
Issues found : 139792
────────────────────────────────────────
Database | Scanned: 36900 | Issues: 1257 | Sources: databases=5 | NEEDS REPAIR
Folders | Scanned: 106028 | Issues: 41306 | Sources: virtualFolders=3468, favoriteFolders=154 | NEEDS REPAIR
Playlists | Scanned: 112223 | Issues: 97317 | Sources: playlists=1128 | NEEDS REPAIR
History | Scanned: 62112 | Issues: 1169 | Sources: histories=1023 | NEEDS REPAIR
────────────────────────────────────────
Next Steps:
Run the following command to repair your library:
vdjtools /repair:playlists,folders,history /stage:export
════════════════════════════════════════Why it’s a good habit #
Running it again after a repair confirms the fix actually landed and the library is clear — a much better feeling than just hoping it worked.
Common scenario #
You’ve noticed a few tracks are missing and want to know whether that’s an isolated blip or a sign of a wider problem, before you touch anything.
