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.