Skip to content
Tomahawk, the multi-source music player
C++ CMake JavaScript C Objective-C++ CSS Other
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Quickstart on Ubuntu

    $ sudo apt-get install build-essential cmake libtag1c2a libtag1-dev liblastfm-dev libqt4-dev \
                           libqt4-sql-sqlite libvorbis-dev libmad0-dev libflac++-dev libasound2-dev \
                           libboost-dev zlib1g-dev libgnutls-dev pkg-config

Gloox 1.0 (XMPP library)
 On Ubuntu 10.10 (and higher):
    $ sudo apt-get install libgloox-dev

 Otherwise see:
 You need to build gloox 1.0 from source, Ubuntu 10.04 only packages version 0.9.

 Download and unpack tarball:
    $ ./configure --without-openssl --with-gnutls --without-libidn --with-zlib --without-examples --without-tests
    $ CXXFLAGS=-fPIC make
    $ sudo make install

QJson (Qt JSON library)
 On Ubuntu 10.04 (and higher):
    $ sudo apt-get install libqjson-dev

 Otherwise see: (developed using version 0.7.1)

 Download and unpack tarball:
    $ ./configure && make
    $ sudo make install

libEchonest 1.1.1

 Download and unpack tarball:
    $ mkdir build && cd build
    $ cmake ..
    $ make
    $ sudo make install

CLucene 0.9.23

 Clone from git and build CLucene:
    $ git clone git://
    $ cd clucene && mkdir build && cd build
    $ cmake ..
    $ make
    $ sudo make install

Quickstart on OS X

 Install homebrew
    $ ruby -e "$(curl -fsSL"
    $ brew install cmake qt qjson gloox libmad libvorbis flac taglib boost liblastfm

 Install libEchnoest & CLucene as per the above instructions.

 If liblastfm gives problems, do the below:
    $ brew edit liblastfm
 Change the url to
    $ brew install liblastfm
 Copy the md5 hash it returns.
    $ brew edit liblastfm
 Replace the md5 hash with the new one you copied.
    $ brew install liblastfm

Now compile Tomahawk
    $ mkdir build && cd build
    $ cmake ..
    $ make
    $ ./tomahawk


  CMake 2.8.0
  Qt 4.7.0
  QJson 0.7.1
  Gloox 1.0 (0.9.x will fail)
  SQLite 3.6.22
  TagLib 1.6.2
  Boost 1.3x
  CLucene 0.9.23 (0.9.21 will fail)
  libmad 0.15.1b
  libvorbis 1.2.3
  libogg 1.1.4
  libflac++ 1.2.0
  liblastfm 0.3.3
  libechonest 1.1.1

 Third party libraries that we ship with our source:

  RtAudio 4.0.7

To build the app:
    $ mkdir build && cd build

 Pick one of the following two choices. If uncertain pick the second one, you probably want a GUI.
    $ cmake -Dgui=no ..     # enables headless mode, build without GUI
    $ cmake ..              # normal build including GUI

    $ make

To run the app:
 Only run the next two commands if you installed any of the dependencies from source on Linux.
    $ export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
    $ sudo ldconfig -v

 Start the application on Linux:
    $ ./tomahawk

 Start the application on OS X:
    $ open

Something went wrong with that request. Please try again.