WWW::TheEchoNest::Song - Wrapper for The Echo Nest API of music intelligence song calls
version 1.1
The Echo Nest song API calls are provided with this module.
song/identify is used to indentify a song based on an echoprint (aka codegen) or ENMPF segment.
WWW::TheEchoNest::Song
song/identify requires you install echoprint-codegen
https://github.com/echonest/echoprint-codegen
To keep this method simple you can generally call it with the custom parameter of file_location. When that is the only parameter passed in most of the heavy lifting is done under the hood.
$song->identify( file_location => '/the/path/to/the/mp3', );
If you are not getting good results try setting the start offset and length of encoded audio to send as outlined in the WWW::TheEchoNest::Codegen module.
Currently Over The Air (OTA) recordings are not well supported by song/identify so be sure the audio source file is as distortion free as possible.
You can also call this using all of the API parameters, but you will need to create a valid codegen JSON block for the 'query' parameter.
$song->identify( query => '[ ..json from codegen .. ]' );
profile();
search();
Aaron Johnson <aaronjjohnson@gmail.com>
This software is copyright (c) 2014 by Aaron Johnson.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install WWW::TheEchoNest, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::TheEchoNest
CPAN shell
perl -MCPAN -e shell install WWW::TheEchoNest
For more information on module installation, please visit the detailed CPAN module installation guide.