Skip to content

VDJTools Community & Support

Supporting Your Media

  • Documentation

Start Here

6
  • What is VDJTools?
  • Why Backups Matter
  • Understanding the Workbook
  • Understanding Status
  • Healthcheck
  • Typical First Repair Flow

Stages

5
  • Export
  • CrossRef
  • Autofix
  • Validate
  • Import

Feature Guide

3
  • Command Options
  • Chained repairs and /repair:all
  • Working through a large repair

Repair

5
  • Healthcheck
  • Database Repair
  • Folders Repair
  • Playlists Repair
  • History Repair

Backup & Restore

2
  • Backup
  • Restore

Advanced

1
  • Verify

Optimisations

1
  • Playcount

Troubleshooting

9
  • Close VirtualDJ before importing or restoring
  • The file is open in another application
  • Databases couldn’t be read, so nothing was changed
  • Validate skipped some of my rows
  • Rows are waiting for /stage:validate
  • Import skipped my Delete rows
  • Rows are still Not Found after AutoFix
  • Export asks before replacing a worksheet
  • The export left songs out
  • Home
  • Documentation
  • Feature Guide
  • Repair
  • Database Repair
View Categories

Database Repair

< 1 min read

0:00 / 1:00
  • View as Markdown Open this page as plain Markdown (opens in a new tab)
  • Open in ChatGPT Ask questions about this page (opens in a new tab)
  • Open in Claude Ask questions about this page (opens in a new tab)
  • Open in Google AI Studio Ask questions about this page (Google account required) (opens in a new tab)

Database Repair fixes missing or broken file references in VirtualDJ’s database — the master record every other part of your library refers back to. It’s almost always the right place to start a repair session.

The full repair #

Same shape as every repair, run against database:

  1. Export — vdjtools /repair:database /stage:export
  2. Autofix — vdjtools /repair:database /stage:autofix
  3. Manually update whatever’s left in the workbook
  4. Validate — vdjtools /repair:database /stage:validate
  5. Import — vdjtools /repair:database /stage:import
  6. Healthcheck — confirm it landed

Each stage is explained in full — arguments, what it actually does, example output — on its own page, linked above. This page is just the walkthrough for the database specifically.

Common scenario #

A drive letter changes, or a drive gets reconnected under a new label, and hundreds of database entries suddenly show as missing — even though the music’s all still there, just at a different path.

Safety notes #

Take a Backup first. Once the database’s fixed and imported, run CrossRef against your other repairs — database is always the source of a CrossRef fix, never the target.

Related pages #

  • Understanding the Workbook
  • CrossRef
autofix, database, drive-change, rename, validate

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Updated on 26 September 2026
HealthcheckFolders Repair
Table of Contents
  • The full repair
  • Common scenario
  • Safety notes
  • Related pages
© Quick Apps (UK)
VDJTools home Glossary FAQ Privacy policy

VDJTools is an independent product built for the VirtualDJ community. It is not affiliated with, endorsed by, or sponsored by Atomix Productions or VirtualDJ.