Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Music Player App, C++/Qt

This branch is 1 commit ahead, 9818 commits behind tomahawk-player:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
CMakeModules
admin
data
include/tomahawk
src
thirdparty
.gitignore
.gitmodules
CMakeLists.txt
ChangeLog
LICENSE.txt
README
gen_resources.sh
resources.qrc

README

Quickstart on Ubuntu
--------------------

    $ sudo apt-get install build-essential cmake libtag1c2a libtag1-dev liblastfm-dev libqt4-dev \
                           libqt4-sql-sqlite 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: http://camaya.net/glooxdownload
 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: http://sourceforge.net/projects/qjson/files/ (developed using version 0.7.1)

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

libEchonest 1.1.1
---------------
 See: http://projects.kde.org/projects/playground/libs/libechonest/

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

CLucene 0.9.23
---------------
 See: http://clucene.sourceforge.net/download.shtml

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


Quickstart on OS X
------------------

 Install homebrew
    $ ruby -e "$(curl -fsSL https://gist.github.com/raw/323731/install_homebrew.rb)"
    $ brew install cmake qt qjson gloox 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 https://github.com/davidsansome/liblastfm/tarball/0.3.1
    $ 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


Dependencies
------------

  CMake 2.8.0 http://www.cmake.org/
  Qt 4.7.0 http://qt.nokia.com/
  QJson 0.7.1 http://qjson.sourceforge.net/
  Gloox 1.0 (0.9.x will fail) http://camaya.net/gloox/
  SQLite 3.6.22 http://www.sqlite.org/
  TagLib 1.6.2 http://developer.kde.org/~wheeler/taglib.html
  Boost 1.3x http://www.boost.org/
  CLucene 0.9.23 (0.9.21 will fail) http://clucene.sourceforge.net/download.shtml
  liblastfm 0.3.3 http://github.com/mxcl/liblastfm/
  libechonest 1.1.1 http://projects.kde.org/projects/playground/libs/libechonest/

 Third party libraries that we ship with our source:

  MiniUPnP http://miniupnp.free.fr/


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 tomahawk.app

Enjoy!
Something went wrong with that request. Please try again.