Within RPMS, you can check the integrity of all the flac-files in your collection and search for corrupted flacs. A repair-script is created during the check; (most of) these faults can be repaired by running the script.

Note. Corruption can occur during ripping or copying; in theory, disk rot can also lead to corrupted flac-files. Either way, checking your collection regularly is recommended.

Steps to run the check

• On the Music-page, under Flac Health, click on either:
  • Check New: This check will only handle new folders since the last check, so this can be very fast. Note that this check is also run automatically at nigth, so the method is seldom needed
  • Check All: Runs a check on all folders, which may take a while. It is recommended to run this check regurarely.
• Under Status, you can see the analysis (in realtime)
• Under Log, you can see the progress; when finished, it shows a summary
• Under Report, you can see a detailed report where all folders are mentioned which contain corrupt files; also the actual errors or warnings are shown

Wait until the number of folders in Status matches the number of albums shown above in Collection, Info. Note that the number of folders can exceed the number of albums, due to different storage organisations, so they can be different! Processing is taken place at approximately 2 folders per minute (on a Raspberry Pi 4).

Repair

In each folder where corruption has been detected during the check, a script repair.sh is created. On top of that, a script repair-all.sh is created in de root-folder of your flac-files. You can execute them by a button, or manually to repair the corrupted files.

• Repair using the web-interface:
  • On the Music-page, under Flac Health
  • click on 'Repair'
• Manual repair:
  • in the terminal, login by ssh:
    • ssh pi@rpms
    • password: rpms
  • to repair all folders at once, using a script:
    • sudo flac-health-repair
  • to repair all folders at once, manual:
    • change directory to the root of your music collection:
      • cd /media/usbdata/user/music/flac
    • execute the script
      • ./repair-all.sh
  • to repair an individual folder:
    • change directory to the specific folder:
      • cd /media/usbdata/user/music/flac + name of the folder
    • execute the script
      • ./repair.sh

Notes

• It is recommended to create a backup before the repair b/c the files are actually modified by the repair.
• For all (manual) repair-methods, you can also copy the files over to your desktop, do the repair locally and then copy them back; this gives you more control but it is quite lumbersome, time consuming and error prone due to the number of actions. Note that the repair-script only works om Linux-PC's.
• After repair, it is recommended to run the check again, to validate the repair. Note: when the repair is done through the web-interface, this is automatically done.

Top