1libechonest 2=========== 3 4libechonest is a collection of C++/Qt classes designed to make a developer's life 5easy when trying to use the APIs provided by The Echo Nest. More information about 6the APIs can be found here: 7 8http://developer.echonest.com/docs/v4/ 9 10libechonest is developed by Leo Franchi (lfranchi@kde.org), and is available at KDE's projects page, 11 https://projects.kde.org/projects/playground/libs/libechonest . 12 Review request are accepted at http://git.reviewboard.kde.org under the compenent libechonest, and 13 API comments, and more are appreciated. 14 15Dependencies 16============ 17 18 * Qt, only the QtCore, QtNetwork and QtTest modules (www.qtsoftware.com) 19 * CMake, Kitware's open source build system (http://cmake.org) 20 * QJson (http://qjson.sourceforge.net/). 21 22Installing 23========== 24 25mkdir build 26cd build 27cmake -DCMAKE_INSTALL_PREFIX=/path/to/desired/install .. 28make 29make install 30 31Using libechonest 32=============== 33The c++ API is meant to be as close to the Echo Nest API as possible. All Echo Nest 34API functions have been copied into their respective c++ equivalents, and string values 35converted to enums where reasonable. 36 37See the unit tests in tests/ for examples on how to use the classes. 38 39You need an API key from http://developer.echonest.com to use this library. Set your API key 40 with Echonest::Config::instance()->setAPIKey(). 41 42You can also set your own custom QNetworkAccessManager-derived class with Config::setNetworkAccessManager(); 43 44Your link line needs to include the following: 45 46 -lechonest -lQtCore -lQtNetwork 47 48Thank you for tuning in! 49 50leo 51 52------- 53This README, and libechonest in general, is inspired by Max Howell's liblastfm, 54 at http://www.github.com/mxcl/liblastfm. 55