repair - Repair Database Entries

This command checks the database and finds inconsistent information.

Until now, only a singe part of this tool comes with a command line GUI. The following things get checked by the GUI part:

  1. Do all artist, album and song files have an database entry

  2. Do all artist, album and song database entries have a file

The result gets presented in two lists. The left list lists all files without a database entry, the right list all database entries without a file. To switch between those lists use tab key. The key commands listed above the lists work on the selected entries. The key commands listed below are independent of the data.

The update command u will merge the file selected in the left list with the database entry selected in the right list

Press q key, or Ctrl-D to exit the tool.

Warning

Currently, only songs can be removed.

Beside the GUI part, there are two more features that must be enabled via command line option:

  • -l/--lyrics: Search for lyrics in all files. If there are lyrics in a file, that are not in the database, they will be added. But only if the lyrics state is Empty. If the user already changed something, the changes will not be overwritten.

  • -c/--checksums: Updates all checksum entries in the songs table.

These features will not be applied when the GUI mode is used.

Lyrics Check

When using the lyrics-check, there may appear lots off error messaged. This is a result of bad meta data and can be ignored. Most common are errors regarding the BOM (Byte Order Mark), because there are far too many tools out there that cannot handle Unicode correct.

This process is very Disk I/O intensive!

Checksum update

Applying this process updates all checksums.

This process is very CPU intensive!

Examples

Example

Starting repair in the GUI mode:

musicdb repair

Checking for lyrics and update checksums (no GUI will be shown)

musicdb repair --lyrics --checksums