This document explains how to install Amarok 2 from git in your home directory - in an easy way :)
==================================================================================================

A detailed blog post on how to make a local build can be found here: http://blogs.fsfe.org/myriam/2009/09/26/compiling-amarok-from-git-locally-full-summary/

* If you already have Amarok installed from your distro, uninstall it to prevent setting conflicts and similar.

* Install git, the compiler and KDE 4 development packages:

  In Kubuntu, Debian, and all their derivatives:
    sudo aptitude install git-core build-essential kdesdk kdelibs5-dev libkonq5-dev kdebase-workspace-dev 

  In Archlinux:
    sudo pacman -Sy git base-devel kdelibs kdebase-runtime

  In Gentoo:
    sudo emerge -av dev-util/git kdelibs plasma-workspace

  In OpenSuSE:
    sudo zypper install git

  In Fedora:
    sudo yum install git kdelibs-devel


*  Install ccache to speed up compilation
    ccache -M 2G

* Append the following to $HOME/.bashrc:
    export PATH=$HOME/kde/bin:$PATH
    export KDEDIR=$HOME/kde
    export KDEDIRS=$KDEDIR

* Reload your edited .bashrc:
    source $HOME/.bashrc

    NOTE: if you are not using the bash shell, edit your proper shell config file (~/.zshrc or ~/.tcshrc or whatever it may be)

* Make KDE aware of Amarok's plugin location:
    echo 'export KDEDIR=$HOME/kde' >> $HOME/.kde/env/myenv.sh
    echo 'export KDEDIRS=$KDEDIR' >> $HOME/.kde/env/myenv.sh

  Some distributions call the above folder $HOME/.kde4/... (OpenSuSE in particular).

* Create folders:
    mkdir $HOME/kde
    mkdir $HOME/kde/src
    mkdir -p $HOME/kde/build/amarok

* Make sure you have all necessary dependencies
    See the README file for the complete list of necessary dependencies. Make sure you have the development files of these packages.
    For distribution specific requirements refer to http://community.kde.org/Amarok/Development/Development_HowTo
    
* Check out Amarok:
    cd $HOME/kde/src
    git clone git://anongit.kde.org/amarok

* Building:
    cd $HOME/kde/build/amarok
    cmake -DCMAKE_INSTALL_PREFIX=$HOME/kde -DCMAKE_BUILD_TYPE=debugfull $HOME/kde/src/amarok
    make install

* Enabling unit tests:

  If you are a regular Amarok contributor, please build with tests enabled. 
  
  Install gmock from https://github.com/google/googlemock

  Once compiled, just run the tests with 'make test'
  
  For more information about the test infrastructure, read the Qtestlib Manual: http://doc.qt.io/qt-5/qtest-overview.html

* Updating KDE Config:
    kbuildsycoca4 --noincremental


Now you are ready to run Amarok 2, by typing "amarok" in the shell :)

Please also refer to the following wiki page
    http://techbase.kde.org/Getting_Started/Sources/KDE_git-tutorial

NOTE:
If you have installed MySQL Embedded in non-default location (i.e. $HOME/usr),
Amarok may fail to start with error regarding libmysqlclient library. In this
case, add the following string to your ~/.bashrc:
    export LD_LIBRARY_PATH=$HOME/usr/lib/mysql:$LD_LIBRARY_PATH

where $HOME/usr is the path you've used in --prefix option.


Have fun :)
