BpmDj for Windows, Mac Os or Linux

We are currently working to create a version of BpmDj for Desktop. The current version is in beta stage, but as it stands now it should be a completely functionally mix-suite.

To test it you will need the java 1.8 runtime installed on your computer.

  1. Create a directory 'BpmDj'
  2. Save the file
    to that directory.
  3. Go to the testing directory and start the jar file. Either by double-clicking it, waving your hands or typing the command
    java -jar bpmdj.jar
  4. If everything went fine, it will ask you were your secret stash of mp3s is. Be honest and point it to a good location.
  5. BpmDj now happily works its way through all your lovely music.
  6. Start a mix by... well read the manual or watch the tutorial at http://bpmdj.yellowcouch.org/speaking-tutorial.html

Error messages

When you start 'java -jar bpmdj.jar' and you receive an error that java is not found, then install java properly.

If you receive an error about a lock file that is still present, then first make sure all java processes are indeed dead, and then remove the lock file and start again. BpmDj has no problem with sudden crashes, it does however have a serious problem with concurrent processes accessing the same database. So, please make sure there is no competing install running before removing the lock file.

When you get a class file format error, you are very likely not using java 1.8. You can find this out by typing java -version

Notes for Linux

Ocassionaly it happens that the audiostream 'stutters' while the playpointer skips quickly forward. This has to do with a badly implemented audiodriver. In particular pulseaudio is to blame. To solve this, disable pulseaudio and restart BpmDj. To disable pulseaudio in such a manner that Java/ALSA will not restart it automatically add the following line to your ~/.pulse/client.conf

  autospawn = no

Then kill pulseaudio and restart BpmDj.


On Ubuntu, the video codec does not work, so there is no tutorial video present.


On suse, openjdk does not come with JavaFX installed. The only solution is the java version as provided by Oracle.


If you want to support us, you can make a donation.