Database Corruption Recovery
Starting with beaTunes 4.0.2, you can initiate database recovery
(repair) from the
Tools menu of beaTunes. The process
is pretty much self-explanatory. Just note that repair
differs from recreation in that repair attempts to save
all data that's in your database, while recreation just re-builds
the database from scratch using your media files.
Should you use an older version of beaTunes or cannot access the
Tools menu, please follow the steps outlined
beaTunes 3.5.5 and later supports a mechanism for database
If you are experiencing database related errors (task queue frozen, new songs don't show up,
JDBCExceptions, ...), please
follow these steps:
- Shut down beaTunes, if it is running.
- Place a file named
recover(no file extension, content does not matter) into the database folder (for location, please see below).
- Then start beaTunes.
beaTunes will now attempt to rebuild the database. It will let you know, if it succeeded or not.
Oftentimes, database corruption is the result of memory problems. Please also see OutOfMemoryError to avoid problems in the future.
- Windows Vista/7/8/8.1/10:
- Windows XP:
C:\Documents and Settings\<username>\Local Settings\Application Data\tagtraum industries\beaTunes\database
- OS X:
On 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 user
Library folder from you (while you can still see the
Library). To get to the user
Go menu in Finder.
On Windows the Windows Explorer may hide the folder
AppData from you. To navigate to it, you can simply
type the path into the Explorer navigation bar or tell Explorer to
show hidden files.