Upgrading

If you are upgrading from an older version of MusicMiner and would like to keep your database with song descriptions, audio features, and maps. please delete everything but the db folder and use the same installation path as last time.

Windows

1. Install a current Java runtime. We recommend version 1.5 but it should also work with 1.4.x.
2. Download the *.jar installer. If it does not start directly, try double clicking the file. If it still does not start open a Command Prompt and enter the command: java -jar musicminer-*-installer.jar
3. Follow the instructions in the installer.
4. Start the Databionic MusicMiner from the start menu.

Linux

1. Install a current Java runtime. We recommend version 1.5 but it should also work with 1.4.x.
2. Install sox and one or more of mplayer, lame, and mpg123. These tools are included in in most Linux distributions, for Debian Sarge enter the following commands as root:

   echo "deb ftp://ftp.nerim.net/debian-marillat/ sarge main" >> /etc/apt/sources.list
   apt-get update
   apt-get install sox mplayer-586 lame mpg123
   

3. Download the *.jar installer and execute with the command: java -jar musicminer-*-installer.jar
4. Follow the instructions in the installer.
5. Add the path to the bin folder of the installation directory to the PATH environment variable.
6. Start the Databionic MusicMiner with the mminer command.

Mac OS X

1. MusicMiner should work with Java 1.4.x (already installed on OS X 10.4.2), however version 1.5 is recommended. After installation add the following lines to your ~/.bash_profile:

   JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
   export JAVA_HOME
   

2. Install the following via the Fink project (comprehensive documentation is to be found at the Fink website. Please ensure that you enable the unstable branch of Fink and compile the latest packages from source where necessary): sox, mpg123, mplayer and xmms (please check the Fink F.A.Q. for help with setting up xmms).
3. The above step will take some time. On a 1.33Ghz PowerBook, it is recommended to leave Fink running overnight to finish the compilation (an installer containing the above binaries and libraries is under development).
4. Please install lame from the package found here.
5. Download the *.jar installer and double-click to launch.
6. Follow the instructions in the installer.
7. After installation add the following lines to your ~/.bash_profile:

   PATH=$PATH:/Applications/MusicMiner/bin
   export PATH
   

8. Launch X11.
9. Open a new terminal window and start the Databionic MusicMiner with the mminer command.