Skip to content

🗂️ File Health

Keep your music library clean and consistent with Music Tagger's automated file health tools.

Missing File Scanner

Identifies tracks in the database whose audio files can no longer be found on disk — typically after moving, renaming, or deleting files outside of Music Tagger.

How to Run

  1. Navigate to Library → File Health.
  2. Click Scan for Missing Files.
  3. Review the results list. Each row shows the database record and the last-known path.

Actions Available

ActionDescription
RelocateManually point the record to the new file path
Auto-MatchLet the system search by filename or fingerprint
Remove RecordDelete the orphaned database entry

File Health

Duplicate Detector

Finds exact and near-duplicate files using two detection methods:

MethodHow it works
Metadata SimilarityMatches tracks with identical title + artist combinations
Audio FingerprintUses acoustic fingerprinting to detect same audio, regardless of format or bitrate

Duplicate Actions

  • Keep Highest Quality — Auto-select the highest bitrate/format file and mark others for deletion.
  • Manual Review — Compare side-by-side and choose which copy to keep.
  • Merge Tags — Combine the best metadata from both copies into the keeper.

📸 [Duplicate detector screenshot — coming soon]

Path Repair

After reorganising your music directory structure, use Path Repair to update all database records at once.

  1. Click Library → Path Repair.
  2. Enter the old path prefix and the new path prefix.
  3. Preview the affected records.
  4. Confirm to bulk-apply the path update.

📸 [Path repair screenshot — coming soon]

WARNING

Path Repair performs a bulk database update. Always verify the preview before confirming.

Released under the MIT License.