libechonest is a collection of C++/Qt classes designed to make a developer's life easy when trying to use the APIs provided by The Echo Nest. More information about the APIs can be found here:

http://developer.echonest.com/docs/v4/

libechonest is developed by Leo Franchi (lfranchi@kde.org), and is available at KDE's projects page, https://projects.kde.org/projects/playground/libs/libechonest . Review request are accepted at http://git.reviewboard.kde.org under the compenent libechonest, and API comments, and more are appreciated.

* Qt, only the QtCore, QtNetwork and QtTest modules (www.qtsoftware.com)
* CMake, Kitware's open source build system (http://cmake.org)
* QJson (http://qjson.sourceforge.net/).

mkdir build cd build cmake -DCMAKE_INSTALL_PREFIX=/path/to/desired/install .. make make install

The c++ API is meant to be as close to the Echo Nest API as possible. All Echo Nest API functions have been copied into their respective c++ equivalents, and string values converted to enums where reasonable.

See the unit tests in tests/ for examples on how to use the classes.

You need an API key from http://developer.echonest.com to use this library. Set your API key with Echonest::Config::instance()->setAPIKey().

You can also set your own custom QNetworkAccessManager-derived class with Config::setNetworkAccessManager();

Your link line needs to include the following:

-lechonest -lQtCore -lQtNetwork

Thank you for tuning in!

leo

This README, and libechonest in general, is inspired by Max Howell's liblastfm, at http://www.github.com/mxcl/liblastfm.