beaTunes does not start, shows JDBCException

After an unintended shutdown, a power outage or an application crash, beaTunes may not start up properly anymore.
If beaTunes displays an error message mentioning a GenericJDBCException the internal database may have gotten corrupted.

To recover the database, please see Database Corruption Recovery. If recovery does not work, deleting the database may be the only option.

Deleting beaTunes' internal database does not harm iTunes/Music.app or its database or your songs in any way.
To do so, you need to first shut down beaTunes. Then

  • Windows Delete the folder C:\Users\<username>\AppData\Local\tagtraum industries\beaTunes\database
  • macOS/OS X Delete the folder ~/Library/Application Support/beaTunes/Database
  • Windows XP Delete the folder C:\Documents and Settings\<username>\Local Settings\Application Data\tagtraum industries\beaTunes\database

On macOS/OS X the directory denoted as [your_home] or ~ is not your harddrive, but your home directory. You can get to it by opening a Finder window and clicking on the little house icon.

Also, starting with version 10.7 (Lion), OS X hides the Library folder from you. To get to it, use the Go menu in Finder.

Note that on Windows the Windows Explorer may hide the folder AppData from you. To navigate to it, you can simply type it into the Explorer navigation bar or tell Explorer to show hidden files.

These paths are valid for beaTunes 2.1 or later.

Important

By deleting the internal beaTunes database, you lose all data that isn't stored in iTunes or the audio files themselves.
Usually that's color, key, decimal fractions of the BPM, language, PUIDs and tags.
To embed color, language etc. into the audio files themselves, check the corresponding option in beaTunes' general preferences.
If you are using a folder-based library, you will also loose all playlist information.