1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
libechonest
===========
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.
Dependencies
============
* 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/).
Installing
==========
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/desired/install ..
make
make install
Using libechonest
===============
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 from Max Howell's liblastfm,
at http://www.github.com/mxcl/liblastfm.
|
