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
- macOS/OS X Delete the folder
- 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
~ 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.
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.