Installing |
To compile the software you need certain development tools. These are
First download the latest package from the FTP server and unzip it in its own directory.
To compile the source, you need to know certain things of your operating system. You need to know where the meta-object compiler for Qt4 is located (this can be moc or moc-qt4). Yoiu need to know where the qt libraries are located and where the headers are located and these three pieces of information need to be comptaible. For instance the meta-object compiler (moc) needs to match the QT library you will use.
This can be checked with 'moc -v'. If it reports something like
then it belongs to Qt 3 and it is the wrong version. If you get something like
it should work. If your standard moc points to moc-qt3 then, just change the MOC line in the defines file to be moc-qt4
In a similar fashion: the qt header files need also to match the library you will use. In general it is very difficult to create a script that detects these things fully automatically. Therefore I've left these configuration things to the person who compiles the software.
The locations of different programs, libraries and headers must be place in a file called 'defines'. Examples of defines file are provided. (defines.debian and defines.gentoo)
Andreas Böhler reports that on SoL-Linux FFTW 3.0 needs to be compiled from scratch. When compiling fftw3 from source, only the static library is built. Since BpmDJ relies on the shared one, --enable-shared has to be passed to ./configure to build the shared library.
Once all this information is correctly entered in the defines file, the programs can be compiled using the make command.
From version 2.1 on, there are different sound drivers. You can select which one to compile by using -D COMPILE_OSS or using -D COMPILE_ALSA. If you did not install the headers for OSS, the don't try to compile the OSS driver. Likewise; if you didn't install the jack headers, then don't try to compile it in. If you want to use the alsa driver, please include the correct headers and libraries (-lasound). Currently the supported defines are
After compiling the software, you can install it system wide by copying bpmdj, bpmplay and bpmdj-raw to /usr/bin. If you choose not to 'install' it make sure to extend your PATH environment variable with the directory that contains bpmplay and bpmdj-raw. If you only did a make, then you might need to enter
export PATH=.:$PATH
before you start the program.
In the past, we had a provision for CMake files, direct gentoo packages (up to version 4.1), debian was also once supported. And Suse (also up to version 4.1). However, providing continuity in package releases is rather difficult. And it appears that often a specific distribution becomes supported through multiple different people. At the moment there is no official release of version 4.2 for any particular platform. Only the source code above is availble. If you feel that you are able to package the software or beta test the installation, please go to the packagers/beta testers page.