Check if given variabels are null

Description

controlInputVariables checks if given variabels id and name are null. Returns an error if both variables id and name are null. Returns warning if both variables id and name are not null.

Usage

controlInputVariables(id, name)

Arguments

Check if given limit is smaller than 200

Description

controlLimit checks if given limit is smaller than 200. Returns warning if limit is greater than 200 and sets limit to 200.

Usage

controlLimit(limit)

Arguments

Value

Returns integer limit

Search Jamendo database for an album

Description

Search Jamendo database for an album. You can search for either an album ID or an album name.

Usage

getAlbum(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about an album. See https://developer.jamendo.com/v3.0/albums for more information.

Examples

##Example
 albumID <- getAlbum(album_id = "14866")
 albumName <- getAlbum(album_name = "Deuteranopia Utopia")

Get tag list of an album

Description

Get tag list of an album. You can search for either an album ID or an album name.

Usage

getAlbumMusicinfo(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains tag list of an album. See https://developer.jamendo.com/v3.0/albums/musicinfo for more information.

Examples

##Example
 tagsFromID <- getAlbumMusicinfo(album_id = "14866")
 tagsFromName <- getAlbumMusicinfo(album_name = "Deuteranopia Utopia")

Get tracks from an album

Description

Get tracks from an album. You can search for either an album ID or an album name.

Usage

getAlbumTracks(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about tracks from an album. See https://developer.jamendo.com/v3.0/albums/tracks for more information.

Examples

##Example
 tracksFromID <- getAlbumTracks(album_id = "14866")
 tracksFromName <- getAlbumTracks(album_name = "Deuteranopia Utopia")

Search Jamendo database for several albums

Description

Search Jamendo database for several albums

Usage

getAlbums(album_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about several albums. See https://developer.jamendo.com/v3.0/albums for more information.

Examples

##Example
 IDs <- c(104336,124067)
 albums <- getAlbums(IDs)

Search Jamendo database for an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtist(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about an artist. See https://developer.jamendo.com/v3.0/artists for more information.

Examples

##Example
 artistID <- getArtist(artist_id="1510")
 artistName <- getArtist(artist_name="Judas Priestley")

Get albums from an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtistAlbums(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about albums from an artist. See https://developer.jamendo.com/v3.0/artists/albums for more information.

Examples

##Example
 albumsFromID <- getArtistAlbums(artist_id="1510",limit=3)
 albumsFromName <- getArtistAlbums(artist_name="Judas Priestley",limit=3)

Get tag list of an artist

Description

Get tag list of an artist. You can search for either an artist ID or an artist name.

Usage

getArtistMusicinfo(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains tag list of an artist. See https://developer.jamendo.com/v3.0/artists/musicinfo for more information.

Examples

##Example
 tagsFromID <- getArtistMusicinfo(artist_id="1510")
 tagsFromName <- getArtistMusicinfo(artist_name="Judas Priestley")

Get tracks from an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtistTracks(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about tracks from an artist. See https://developer.jamendo.com/v3.0/artists/tracks for more information.

Examples

##Example
 tracksFromID <- getArtistTracks(artist_id="1510",limit=3)
 tracksFromName <- getArtistTracks(artist_name="Judas Priestley",limit=3)

Search Jamendo database for several artists

Description

Search Jamendo database for several artists

Usage

getArtists(artist_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about several albums. See https://developer.jamendo.com/v3.0/artists for more information.

Examples

##Example
 IDs <- c(1510,338873)
 artists <- getArtists(IDs)

This method let you select and filter geographical locations which artists have declared as reference for themselves

Description

This method let you select and filter geographical locations which artists have declared as reference for themselves

Usage

getArtistsLocation(
  location,
  city = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about artist from a certain location. See https://developer.jamendo.com/v3.0/artists/locations for more information.

Examples

##Example
 artists <- getArtistsLocation("GRC", limit=3)

Search Jamendo database for a string

Description

Search Jamendo database for a string

Usage

getAutocompleteSearch(
  prefix,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains found tracks, artists, albums and tags for a given string. See https://developer.jamendo.com/v3.0/autocomplete for more information.

Examples

##Example
 result <- getAutocompleteSearch("Chill", limit=3)

This method returns the editorial feeds that you can find also on the Jamendo homepage.

Description

This method returns the editorial feeds that you can find also on the Jamendo homepage.

Usage

getFeed(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about feeds from the Jamendo homepage. See https://developer.jamendo.com/v3.0/feeds for more information.

Examples

##Example
 feed <- getFeed(limit=3)

Get your own playlists

Description

Get your own playlists

Usage

getMyPlaylists(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about your playlists. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples

##Example
 app_name=""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  playlists <- getMyPlaylists(token)
 }

Get information about your user profile

Description

Get information about your user profile

Usage

getMyUserProfile(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about your user profile. See https://developer.jamendo.com/v3.0/users for more information.

Examples

##Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  user <- getUserProfile(token)
 }

Search Jamendo database for a playlist

Description

Search Jamendo database for a playlist. You can search for either a playlist ID or a playlist name.

Usage

getPlaylist(
  playlist_id = NULL,
  playlist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a playlist. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples

##Example
 playlistID <- getPlaylist(playlist_id="100268")
 playlistName <- getPlaylist(playlist_name="Chillin")

Get all tracks from a playlist

Description

Get all tracks from a playlist. You can search for either a playlist ID or a playlist name.

Usage

getPlaylistTracks(
  playlist_id = NULL,
  playlist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about all tracks from a playlist. See https://developer.jamendo.com/v3.0/playlists/tracks for more information.

Examples

##Example
 tracksFromID <- getPlaylistTracks(playlist_id="100268")
 tracksFromName <- getPlaylistTracks(playlist_name="Chillin")

Search Jamendo database for playlists with certain name

Description

Search Jamendo database for playlists with certain name

Usage

getPlaylistsNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about playlists with certain name. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples

##Example
 playlists <- getPlaylistsNamesearch("chill", limit = 3)

This method returns information about a jamendo radio

Description

This method returns information about a jamendo radio. You can search for either a radio ID or a radio name.

Usage

getRadio(
  radio_id = NULL,
  radio_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a radio. See https://developer.jamendo.com/v3.0/radios for more information.

Examples

##Example
 radioID <- getRadio(radio_id="1")
 radioName <- getRadio(radio_name="bestof")

This method returns the list of existing jamendo radios

Description

This method returns the list of existing jamendo radios

Usage

getRadios(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about a radio. See https://developer.jamendo.com/v3.0/radios for more information.

Examples

##Example
 radios <- getRadios(limit=3)

This method lets you filter and browse album reviews

Description

This method lets you filter and browse album reviews

Usage

getReviewsAlbums(
  album_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains reviews of the searched albums. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples

##Example
 IDs <- c(104336,124067)
 reviews <- getReviewsAlbums(IDs,limit=3)

This method lets you filter and browse album reviews from a specific user

Description

This method lets you filter and browse album reviews from a specific user

Usage

getReviewsAlbumsUser(
  user_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains reviews of the searched albums from a specific user. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples

##Example
 reviews <- getReviewsAlbumsUser(972174,limit=3)

This method lets you filter and browse album reviews for a specific artist

Description

This method lets you filter and browse album reviews for a specific artist

Usage

getReviewsArtistAlbums(
  artist_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains reviews of the searched albums for a specific artist. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples

##Example
 reviews <- getReviewsArtistAlbums(1510,limit=3)

This method lets you filter and browse track reviews

Description

This method lets you filter and browse track reviews

Usage

getReviewsTracks(
  track_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains track reviews of the searched albums. See https://developer.jamendo.com/v3.0/reviews/tracks for more information.

Examples

##Example
 IDs <- c(114069,113885)
 reviews <- getReviewsTracks(IDs,limit=3)

Search Jamendo database for a track

Description

Search Jamendo database for a track. You can search for either a track ID or a track name.

Usage

getTrack(
  track_id = NULL,
  track_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples

##Examples
 trackID <- getTrack(track_id="114069")
 trackName <- getTrack(track_name="Deuteranopia 0")

Search Jamendo database for several tracks

Description

Search Jamendo database for several tracks

Usage

getTracks(track_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about several tracks. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples

##Examples
 IDs <- c(114069,113885)
 tracks <- getTracks(IDs)

Search Jamendo database for a track

Description

Search Jamendo database for a track by name with namesearch.

Usage

getTracksNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples

##Examples
 tracks <- getTracksNamesearch("ambient",limit=3)

Search Jamendo database for a track

Description

Given the id of a Jamendo track, this function lets you find other similar Jamendo tracks.

Usage

getTracksSimilar(
  track_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples

##Examples
 tracks <- getTracksSimilar("114069",limit=3)

Search Jamendo database for a track

Description

Search by one or more tags (genre, instrument, theme and nc tags).

Usage

getTracksTags(tags, limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples

##Examples
 tags <- c("chill","ambient")
 tracks <- getTracksTags(tags,limit=3)

Search Jamendo database for a user

Description

Search Jamendo database for a user. You can search for either a user ID or a user name.

Usage

getUserProfile(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains information about a user. See https://developer.jamendo.com/v3.0/users for more information.

Examples

## Example
 userName <- getUserProfile(user_name = "claudod")
 userID <- getUserProfile(user_id = "972174")

Get albums a user added to myalbums

Description

Get albums added to myalbums. You can search for either a user ID or a user name.

Usage

getUserProfileAlbums(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains albums a user added to myalbums. See https://developer.jamendo.com/v3.0/users/albums for more information.

Examples

## Example
 albumsFromName <- getUserProfileAlbums(user_name = "claudod")
 albumsFromID <- getUserProfileAlbums(user_id = "972174")

Get artists a user is a fan of

Description

Get artists a user is a fan of. You can search for either a user ID or a user name.

Usage

getUserProfileArtists(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

Value

Returns a data frame which contains artists a user is a fan of. See https://developer.jamendo.com/v3.0/users/artists for more information.

Examples

## Example
 artistsFromName <- getUserProfileArtists(user_name = "claudod")
 artistsFromID <- getUserProfileArtists(user_id = "972174")

Get tracks a user has liked, added to favorite or reviewed

Description

Get tracks a user has liked, added to favorite or reviewed

Usage

getUserProfileTracks(user_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Value

Returns a data frame which contains tracks a user has liked, added to favorite or reviewed. See https://developer.jamendo.com/v3.0/users/tracks for more information.

Examples

## Example
 tracks <- getUserProfileTracks("972174")

Create OAuth token to access jamendo web API

Description

jamendoOAuth creates a long-lived OAuth access token that enables R to make authenticated calls to the Jamendo API. The token can be saved as a file in disk to be re-used in future sessions. This function relies on the httr package to create the OAuth token

Usage

jamendoOAuth(
  app_name,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)

Arguments

Value

Returns an OAuth access token as environment

Examples

## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }

jamendoR package

Description

A Quick and Easy Wrapper for Pulling Track Audio Features from Jamendo's Web API

Parse response from POST request for setUser functions

Description

parse parses response from POST request for setUser functions.

Usage

parseResponse(res)

Arguments

Value

Returns string with response message

Refresh expired OAuth token to access jamendo web API

Description

refreshToken refreshes an OAuth access token that enables R to make authenticated calls to the Jamendo API. The refreshed token can be saved as a file in disk to be re-used in future sessions. This function relies on the httr package to refresh the OAuth token

Usage

resfreshToken(
  token,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)

Arguments

Value

Returns an OAuth access token as environment

Examples

## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
  my_oauth <- resfreshToken(my_oauth)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }

Dislike the track given by Track ID

Description

Dislike the track given by Track ID

Usage

setUserDislike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Examples

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserDislike(token, "114069")
 }

Become a fan of an artist

Description

Become a fan of an artist

Usage

setUserFan(token, artist_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Examples

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFan(token, "1510")
 }

Add a given track to your preferites

Description

Add a given track to your preferites

Usage

setUserFavorite(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Examples

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFavorite(token, "114069")
 }

Like the track given by Track ID

Description

Like the track given by Track ID

Usage

setUserLike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Examples

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserLike(token, "114069")
 }

Add album to your list of favorite albums myalbums

Description

Add album to your list of favorite albums myalbums

Usage

setUserMyalbum(token, album_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

Examples

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserMyalbum(token, "14866")
 }