JamendoR is a R wrapper for pulling track audio features and other information from Jamendo’s Web API. You can pull song and playlist information for a given Jamendo user (including yourself!) or enter an artist’s -, album’s -, or track’s name and retrieve the available information in seconds.
CRAN Version 0.1.0 (recommended)
install.packages('JamendoR')
Development version
::install_github('MaxGreil/JamendoR') devtools
First, set up an account with Jamendo to access their Web API here. This will give you
your Client ID
and Client Secret
. Once you
have those, you can pull your access token into R with
jamendoOAuth(app_name)
.
The easiest way to authenticate is to set your credentials to the
System Environment variables JAMENDO_CLIENT_ID
and
JAMENDO_CLIENT_SECRET
. The default arguments to
jamendoOAuth(app_name)
(and all other functions in this
package) will refer to those. Alternatively, you can set them manually
and make sure to explicitly refer to your access token in each
subsequent function call.
Sys.setenv(JAMENDO_CLIENT_ID = 'xxxxxxxxxxxxxxxxxxxxx')
Sys.setenv(JAMENDO_CLIENT_SECRET = 'xxxxxxxxxxxxxxxxxxxxx')
<- jamendoOAuth(app_name="xxxx")
token <- tempdir()
filedir save(token, file=file.path(filedir, "token"))
For certain functions and applications, you’ll need to be logged in.
To do this, your Jamendo application needs to have a callback url. You
can set this to whatever you want, but a good default option is
http://localhost:1410/
(see image below). For more
information on authorization, visit the offical Jamendo
Developer Guide.
<- getUserProfile(user_name = "claudod")
user # id dispname lang creationdate
#1 972174 claudod it 2010-10-17
<- getArtistsLocation("GRC", limit=3)
artists # id name website joindate shorturl
#1 1510 Judas Priestley http://myspace.com/judaspriestley 2006-03-21 http://jamen.do/a/1510
#2 338873 nasos 2008-03-25 http://jamen.do/a/338873
#3 348714 e.k.m. http://epithesikatametopo.blogspot.com 2009-03-16 http://jamen.do/a/348714
# shareurl
#1 http://www.jamendo.com/artist/1510
#2 http://www.jamendo.com/artist/338873
#3 http://www.jamendo.com/artist/348714
<- getArtist(artist_id = "1510")
artist # id name website joindate shorturl
#1 1510 Judas Priestley http://myspace.com/judaspriestley 2006-03-21 http://jamen.do/a/1510
# shareurl
#1 http://www.jamendo.com/artist/1510
<- getArtistMusicinfo(artist_name = "Judas Priestley")
info # tags
#1 glitch
#2 electronic
#3 ambient
<- getArtistAlbums(artist_id = "1510")
albums # id name releasedate image
#1 14866 Deuteranopia Utopia 2007-12-04 https://imgjam1.jamendo.com/albums/s14/14866/covers/1.200.jpg
<- getAlbumTracks(album_id = "14866")
tracks # id position name duration license_ccurl
#1 114069 1 Deuteranopia 0 19 http://creativecommons.org/licenses/by-nc-sa/3.0/
#2 113885 2 Deuteranopia 1 402 http://creativecommons.org/licenses/by-nc-sa/3.0/
#3 114063 3 Deuteranopia 2 416 http://creativecommons.org/licenses/by-nc-sa/3.0/
#4 113926 4 Deuteranopia 3 277 http://creativecommons.org/licenses/by-nc-sa/3.0/
#5 113953 5 Deuteranopia 4 387 http://creativecommons.org/licenses/by-nc-sa/3.0/
#6 114050 6 Deuteranopia 6 323 http://creativecommons.org/licenses/by-nc-sa/3.0/
#7 114067 7 Deuteranopia 7 384 http://creativecommons.org/licenses/by-nc-sa/3.0/
#8 114052 8 Deuteranopia 8 93 http://creativecommons.org/licenses/by-nc-sa/3.0/
# audio
#1 https://mp3l.jamendo.com/?trackid=114069&format=mp31&from=app-77b5b682
#2 https://mp3l.jamendo.com/?trackid=113885&format=mp31&from=app-77b5b682
#3 https://mp3l.jamendo.com/?trackid=114063&format=mp31&from=app-77b5b682
#4 https://mp3l.jamendo.com/?trackid=113926&format=mp31&from=app-77b5b682
#5 https://mp3l.jamendo.com/?trackid=113953&format=mp31&from=app-77b5b682
#6 https://mp3l.jamendo.com/?trackid=114050&format=mp31&from=app-77b5b682
#7 https://mp3l.jamendo.com/?trackid=114067&format=mp31&from=app-77b5b682
#8 https://mp3l.jamendo.com/?trackid=114052&format=mp31&from=app-77b5b682
# audiodownload
#1 https://mp3d.jamendo.com/download/track/114069/mp32/
#2 https://mp3d.jamendo.com/download/track/113885/mp32/
#3 https://mp3d.jamendo.com/download/track/114063/mp32/
#4 https://mp3d.jamendo.com/download/track/113926/mp32/
#5 https://mp3d.jamendo.com/download/track/113953/mp32/
#6 https://mp3d.jamendo.com/download/track/114050/mp32/
#7 https://mp3d.jamendo.com/download/track/114067/mp32/
#8 https://mp3d.jamendo.com/download/track/114052/mp32/
<- getAlbumMusicinfo(album_id = "14866")
info # tags
#1 glitch
#2 ambient
#3 triphop
#4 peaceful
<- tracks$id
ids <- getReviewsTracks(ids)
reviews # NULL
<- getTrack(track_name = "Deuteranopia 0")
track # id name duration artist_id artist_name album_name album_id
#1 114069 Deuteranopia 0 19 1510 Judas Priestley Deuteranopia Utopia 14866
# license_ccurl position releasedate
#1 http://creativecommons.org/licenses/by-nc-sa/3.0/ 1 2007-12-04
# audio
#1 https://mp3l.jamendo.com/?trackid=114069&format=mp31&from=app-77b5b682
# audiodownload prourl shorturl
#1 https://mp3d.jamendo.com/download/track/114069/mp32/ http://jamen.do/t/114069
# shareurl
#1 http://www.jamendo.com/track/114069
<- getPlaylistsNamesearch("chill", limit = 3)
playlists # id name creationdate user_id user_name
#1 100086550 Ambiente, Lunge, Chillout 2014-12-03 4014817 mundofascinante.viajes@gmail.com
#2 100268 Chillin 2009-01-19 555416 jdhall75
#3 100276 chillout 2009-01-19 69982 sleeva
# zip shorturl
#1 https://mp3d.jamendo.com/download/p100086550/mp32/ http://jamen.do/l/p100086550
#2 https://mp3d.jamendo.com/download/p100268/mp32/ http://jamen.do/l/p100268
#3 https://mp3d.jamendo.com/download/p100276/mp32/ http://jamen.do/l/p100276
# shareurl
#1 http://www.jamendo.com/list/p100086550
#2 http://www.jamendo.com/list/p100268
#3 http://www.jamendo.com/list/p100276