Skip to content
tvk edited this page Jun 3, 2012 · 10 revisions

This guide is designed to get soundcloud running in a few minutes. The shell commands are desinged for debian based operating systems (like Ubuntu, Mint etc.). On other operating systems you'll probably need to adapt the commands.

Check if java is installed

java -version

Oracle Java and the openJDK are supported. You need at least version 6.0. If no java is installed yet, you can install it using this command:

sudo apt-get install openjdk-7-jdk

Install necessary packages

Make sure you have these packages installed:

sudo apt-get install git mongodb libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev gstreamer0.10-ffmpeg sudo apt-get install maven2 --no-install-recommends

mongodb and maven2 are in some cases part of the "universe" apt-sources. Check that these sources are enabled in your /etc/apt/sources.list if you encounter problems.

mongodb often causes trouble while installing. Check the mongodb documentation for help. Anyway the mongodb storage layer should be replaced soon in this project.

Checkout and build the project:

Enter this command to checkout the project from github:

git clone git://github.com/tvk/Soundcloud.git

Build the project:

cd Soundcloud ; mvn clean install

Run the project:

Enter the correct location of your music library and run the following command:

cd soundcloud-web ; mvn -Dsoundcloud.library=/home<USER>/Music jetty:run

Navigate to http://localhost:8080/soundcloud-web

.. and you should see the running application!