When upgrading from a pre3.0 version of BpmDj to version 3.0, certain steps should be followed, otherwise it will not be possible to get the program working. Two important changes have been made to BpmDj v3.0.
1) .kbpmdj file format difference
Some previous kBpmDj versions could 'upgrade' the .kbpmdj file wrongly, resulting in playercommands that did not work or even made the program crash. Therefore it became necessary to force a reset of the configuration file. To achieve this, remove the .kbpmdj configuration file in the home directory or in the directory where you start kbpm-dj from.
rm .kbpm-dj
2) No .bib file support anymore, different .idx file format
In a previous version we introduced the .bib files as a means to quickly load an entire database of songs. This however turned out rather complicated to maintain and does not scale up anyway. Therefore, we removed the concept of .bib files. Along with this process we also changed the original textual index file format to a better suitable binary format. The process to convert your old index files to the new format is described as follows.
1. Backup your old index directory. To do so, go to the place where it is located. Type
tar -cvzf index-pre30-backup.tgz index
2. Once this is done, we will use the explode-bib program to convert both the .bib files and the .idx files to the new file format. The epxlode-bib program will create a new directory, called new-index. Therefore make sure that such a directory does not exist. Then, start
explode-bib
This process can take some time (10 minutes is no unexpected) and will typically expand a bib file of 60 Mb to 330 Mb. (There is a good reason I called it 'explode' :)
This process will also automatically merge index files that refer to the same song. The extra tag 'Merged' will be added in the merged index file.
3. If everything went well it should be possible to test the new index by removing the old indices and replacing it with the new
rm -r index
mv new-index index
Now you should be able to start kbpm-dj.