Commit 303eff12 authored by Bart van der Velden's avatar Bart van der Velden

Update INSTALL for Linux, an update for Windows is needed (#53)

parent 4a6ba842
How to build MusicCollection
This file contains the steps that are needed to build MusicCollection from source.
These steps will certainly not cover every system that exists, so additional steps
may be necessary.
- Have boost installed >= 1.55
- Have cmake >= 2.8.12 installed
- Have taglib installed >= 1.9.1
- Have Qt installed >= 5.0
Buildin on Linux:
The following steps were obtained from getting MusicCollection to work on Kubuntu
13.10 (my home system, as well as one running within VirtualBox) and Linux Mint 16
Cinnamon. All these systems are Debian/Ubuntu based, so you need to adjust for other
Install CMake
- Install: sudo apt-get install cmake
Install Boost
- Install: sudo apt-get install libbz2-dev
- Install: sudo apt-get install python-dev
- wget
- mv download boost.tar.bz2
- tar xvfj boost_1_xx_x.tar.bz2
- check for patches and install these
- cd boost_1_xx
- ./bootstrap
- ./b2 -j4 link=shared threading=multi runtime-link=shared stage
- sudo ./b2 install
Install taglib
- wget
- tar xfvz taglib-1.9.1.tar.gz
- cd taglib-1.9.1/
- make
- sudo make install
Install Qt Creator
- Download the "Qt Online Installer for Linux 64-bit" from
- chmod +x the run file
- sudo ./ to start installation but do not "Launch Qt Creator" at the end of
the installation process, otherwise we get permission problems as a normal user
- When running from VirtualBox Disable 3D acceleration in VirtualBox because the Qml
welcome screen misbehaves
- make the correct Qt libraries available, in my case I added the following line to
export CMAKE_PREFIX_PATH=/opt/Qt/5.2.1/gcc_64/lib/cmake/Qt5Widgets/
On my Jenkins server, without X, I needed to install qt5-default. This gives Qt 5.02
versions, which suffices for now.
Install git
- sudo apt-get install git
Clone the MusicCollection source
To clone my MusicCollection repository go to:
and find out what to use.
For example:
git clone
This will create a directory called musiccollection in the current directory.
However, you cannot push changes back to the repository, so you may want to fork my
repository, clone that and change it to your hearts content. If you then want to
inflict your changes on me, just create a pull request, and I will have a look.
Build MusicCollection and run unit tests
The software must be built in a different directory than where the source is
(assuming you are in the directory musiccollection):
- cd ..
- mkdir buildmusiccollection
- cd buildmusiccollection
- cmake -DCMAKE_BUILD_TYPE=Debug ../musiccollection
- make
- make test
For a release build use -DCMAKE_BUILD_TYPE=Release
If all went well, the software is now built and the unit tests were performed without
As a more convenient alternative, you can also build from Qt Creator:
- Start Qt Creator
- Click Open Project and select the file MusicCollection/CMakeLists.txt
- Accept the suggested Build Location
- Enter -DCMAKE_BUILD_TYPE=Debug at Arguments and check that a Desktop Generator is
- Click Run CMake
- Click Finish
- The project is now opened
- Ctrl-Shift-B to build all
Of course, you can also use KDevelop and any other IDE that supports CMake.
Linux trivia
To enable debugging (when you get the error "ptrace: operation not permitted")
- sudo nano /etc/sysctl.d/10-ptrace.conf
- change the line to read: kernel.yama.ptrace_scope = 0
Building on Windows
- Have boost installed >= 1.55
- Have cmake >= 2.8.11 installed
- Have taglib installed >= 1.9
- Have Qt installed >= 5.0
These steps were obtained from getting MusicCollection to work on two systems, one a 64
bit Windows 7 Enterprise and one 64 bit Windows 7 Home Premium.
For Qt: set CMAKE_PREFIX_PATH to the path where Qt is installed, i.e. C:\Qt\5.1.1\msvc2010 on my
Windows machine.
......@@ -19,16 +145,13 @@ Install TagLib:
- make
- sudo make install
On openSUSE:
- sudo zypper install taglib-devel
- Create a build directory on the same level as MusicCollection: mkdir build
- cd build
- Configure cmake: cmake ../MusicCollection
- Build the software: make
- Run the software: ./musiccollection
- To build a debug version: cmake -DCMAKE_BUILD_TYPE:STRING=Debug ../MusicCollection
- To build a debug version: cmake -DCMAKE_BUILD_TYPE=Debug ../MusicCollection
- After that: gdb musiccollection
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment