{"Package":"spotifyr","Title":"R Wrapper for the 'Spotify' Web API","Version":"2.2.1","Date":"2021-06-09","Authors@R":"c(\nperson(\ngiven = \"Charlie\",\nfamily = \"Thompson\",\nemail = \"chuck@rcharlie.com\",\nrole = c(\"aut\")\n),\nperson(\ngiven = \"Daniel\",\nfamily = \"Antal\",\nemail = \"daniel.antal@ceemid.eu\",\nrole = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0001-7513-6760\")\n),\nperson(\ngiven = \"Josiah\",\nfamily = \"Parry\",\nemail = \"josiah.parry@yahoo.com\",\nrole = \"aut\",\ncomment = c(ORCID = \"0000-0001-9910-865X\")\n),\nperson(\ngiven = \"Donal\",\nfamily = \"Phipps\",\nemail = \"donal.phipps@gmail.com\",\nrole = \"aut\"\n),\nperson(\ngiven = \"Tom\",\nfamily = \"Wolff\",\nemail = \"tom.wolff@duke.edu\",\nrole = \"aut\"\n)\n)","Description":"An R wrapper for pulling data from the 'Spotify' Web API\n in bulk, or post items on a\n'Spotify' user's playlist.","Maintainer":"Daniel Antal ","Depends":"R (>= 3.3.0)","Imports":"dplyr, purrr, tidyr, httr, lubridate, jsonlite, readr, rvest,\nstringr, tibble, janitor, rlang, ggridges, magrittr, genius,\nassertthat, xml2","License":"MIT + file LICENSE","Encoding":"UTF-8","RoxygenNote":"7.1.1","Suggests":"testthat (>= 3.0.0)","URL":"https://github.com/charlie86/spotifyr","BugReports":"https://github.com/charlie86/spotifyr/issues","Config/testthat/edition":"3","NeedsCompilation":"no","Packaged":"2021-06-14 18:44:26 UTC; Daniel Antal","Author":"Charlie Thompson [aut],\nDaniel Antal [aut, cre] (),\nJosiah Parry [aut] (),\nDonal Phipps [aut],\nTom Wolff [aut]","Repository":"CRAN","Date/Publication":"2021-06-17 05:50:06 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/spotifyr_2.2.1.tar.gz","jsonAuthors":[{"name":"Charlie Thompson","email":"chuck@rcharlie.com","maintainer":false},{"name":"Daniel Antal","email":"daniel.antal@ceemid.eu","maintainer":true},{"name":"Josiah Parry","email":"josiah.parry@yahoo.com","maintainer":false},{"name":"Donal Phipps","email":"donal.phipps@gmail.com","maintainer":false},{"name":"Tom Wolff","email":"tom.wolff@duke.edu","maintainer":false}],"readme":"\n\n\n# spotifyr\n\n\n\n[![CRAN\\_Status\\_Badge](http://www.r-pkg.org/badges/version/spotifyr?color=brightgreen)](https://cran.r-project.org/package=spotifyr)\n![](http://cranlogs.r-pkg.org/badges/spotifyr?color=brightgreen)\n[![CRAN\\_time\\_from\\_release](https://www.r-pkg.org/badges/ago/spotifyr)](https://cran.r-project.org/package=spotifyr)\n[![metacran\ndownloads](https://cranlogs.r-pkg.org/badges/spotifyr)](https://cran.r-project.org/package=spotifyr)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4946780.svg)](https://doi.org/10.5281/zenodo.4946780)\n\n\n## Overview\n\nspotifyr is an R wrapper for pulling track audio features and other\ninformation from Spotify’s Web API in bulk. By automatically batching\nAPI requests, it allows you to enter an artist’s name and retrieve their\nentire discography in seconds, along with Spotify’s audio features and\ntrack/album popularity metrics. You can also pull song and playlist\ninformation for a given Spotify User (including yourself!).\n\n## Installation\n\nCRAN version 2.1.1 (recommended)\n\n``` r\ninstall.packages('spotifyr')\n```\n\nDevelopment version\n\n``` r\ndevtools::install_github('charlie86/spotifyr')\n```\n\n## Authentication\n\nFirst, set up a Dev account with Spotify to access their Web API\n[here](https://developer.spotify.com/my-applications/#!/applications).\nThis will give you your `Client ID` and `Client Secret`. Once you have\nthose, you can pull your access token into R with\n`get_spotify_access_token()`.\n\nThe easiest way to authenticate is to set your credentials to the System\nEnvironment variables `SPOTIFY_CLIENT_ID` and `SPOTIFY_CLIENT_SECRET`.\nThe default arguments to `get_spotify_access_token()` (and all other\nfunctions in this package) will refer to those. Alternatively, you can\nset them manually and make sure to explicitly refer to your access token\nin each subsequent function call.\n\n``` r\nSys.setenv(SPOTIFY_CLIENT_ID = 'xxxxxxxxxxxxxxxxxxxxx')\nSys.setenv(SPOTIFY_CLIENT_SECRET = 'xxxxxxxxxxxxxxxxxxxxx')\n\naccess_token <- get_spotify_access_token()\n```\n\n#### Authorization Code Flow\n\nFor certain functions and applications, you’ll need to log in as a\nSpotify user. To do this, your Spotify Developer application needs to\nhave a callback url. You can set this to whatever you want that will\nwork with your application, but a good default option is\n`http://localhost:1410/` (see image below). For more information on\nauthorization, visit the offical [Spotify Developer\nGuide](https://developer.spotify.com/documentation/general/guides/authorization-guide/).\n\n

\n\n## Usage\n\n### What Was the Beatles’ Favorite Key?\n\n``` r\nlibrary(spotifyr)\nbeatles <- get_artist_audio_features('the beatles')\n```\n\n``` r\nlibrary(dplyr)\nlibrary(purrr)\nlibrary(knitr)\n\nbeatles %>% \n count(key_mode, sort = TRUE) %>% \n head(5) %>% \n kable()\n```\n\n| key\\_mode | n |\n|:----------|----:|\n| C major | 104 |\n| D major | 98 |\n| G major | 82 |\n| A major | 76 |\n| E major | 62 |\n\n### Get your most recently played tracks\n\n``` r\nlibrary(lubridate)\n\nget_my_recently_played(limit = 5) %>% \n mutate(\n artist.name = map_chr(track.artists, function(x) x$name[1]),\n played_at = as_datetime(played_at)\n ) %>% \n select(\n all_of(c(\"track.name\", \"artist.name\", \"track.album.name\", \"played_at\"))\n ) %>% \n kable()\n```\n\n| track.name | artist.name | track.album.name | played\\_at |\n|:---------------------|:------------|:---------------------|:--------------------|\n| A Case of You | Tristen | A Case of You | 2021-06-14 09:54:44 |\n| Paper Cup | Real Estate | Paper Cup | 2021-06-10 20:20:11 |\n| Wrong with You | Tristen | Wrong with You | 2021-06-10 20:17:24 |\n| Animal - Edit | LUMP | Animal | 2021-06-10 20:13:21 |\n| Streets Of Your Town | DOPE LEMON | Streets Of Your Town | 2021-06-10 18:23:00 |\n\n### Find Your All Time Favorite Artists\n\n``` r\nget_my_top_artists_or_tracks(type = 'artists', \n time_range = 'long_term', \n limit = 5) %>% \n select(.data$name, .data$genres) %>% \n rowwise %>% \n mutate(genres = paste(.data$genres, collapse = ', ')) %>% \n ungroup %>% \n kable()\n```\n\n| name | genres |\n|:--------------------|:-------------------------------------------------------------------------|\n| Japanese Breakfast | art pop, bubblegrunge, eugene indie, indie pop, indie rock, philly indie |\n| Haley Bonar | melancholia, stomp and holler |\n| Balthazar | belgian indie, belgian rock, dutch indie, dutch rock, ghent indie |\n| Buildings Breeding | indie fuzzpop |\n| Angus & Julia Stone | australian indie folk, indie folk, stomp and holler |\n\n### Find your favorite tracks at the moment\n\n``` r\nget_my_top_artists_or_tracks(type = 'tracks', \n time_range = 'short_term', \n limit = 5) %>% \n mutate(\n artist.name = map_chr(artists, function(x) x$name[1])\n ) %>% \n select(name, artist.name, album.name) %>% \n kable()\n```\n\n| name | artist.name | album.name |\n|:--------------|:--------------|:------------|\n| Hot & Heavy | Lucy Dacus | Hot & Heavy |\n| Sea Urchin | Mystic Braves | Sea Urchin |\n| Human | Freedom Fry | Human |\n| Hot Motion | Temples | Hot Motion |\n| Animal - Edit | LUMP | Animal |\n\n### What’s the most joyful Joy Division song?\n\nMy favorite audio feature has to be “valence,” a measure of musical\npositivity.\n\n``` r\njoy <- get_artist_audio_features('joy division')\n```\n\n``` r\njoy %>% \n arrange(-valence) %>% \n select(.data$track_name, .data$valence) %>% \n head(5) %>% \n kable()\n```\n\n| track\\_name | valence |\n|:------------------------------------------|--------:|\n| Passover - 2020 Digital Master | 0.946 |\n| Passover - 2007 Remaster | 0.941 |\n| Colony - 2020 Digital Master | 0.829 |\n| Colony - 2007 Remaster | 0.808 |\n| Atrocity Exhibition - 2020 Digital Master | 0.790 |\n\nNow if only there was some way to plot joy…\n\n### Joyplot of the emotional rollercoasters that are Joy Division’s albums\n\n``` r\nlibrary(ggplot2)\nlibrary(ggridges)\n\nggplot(\n joy, \n aes(x = valence, y = album_name)\n ) + \ngeom_density_ridges() + \ntheme_ridges() +\nlabs(title = \"Joyplot of Joy Division's joy distributions\", \n subtitle = \"Based on valence pulled from Spotify's Web API with spotifyr\")\n```\n\n

\n\n## Sentify: A Shiny app\n\nThis [app](http://rcharlie.net/sentify/), powered by spotifyr, allows\nyou to visualize the energy and valence (musical positivity) of all of\nSpotify’s artists and playlists.\n\n## Dope Stuff Other People Have Done with spotifyr\n\nThe coolest thing about making this package has definitely been seeing\nall the awesome stuff other people have done with it. Here are a few\nexamples:\n\n[Exploring the Spotify API with R: A tutorial for beginners, by a\nbeginner](https://msmith7161.github.io/what-is-speechiness/), Mia Smith\n\n[Blue Christmas: A data-driven search for the most depressing Christmas\nsong](https://caitlinhudon.com/2017/12/22/blue-christmas/), Caitlin\nHudon\n\n[Sente-se triste quando ouve “Amar pelos dois”? Não é o único (Do you\nfeel sad when you hear “Love for both?” You’re not\nalone)](https://rr.sapo.pt/especial/112355/sente-se-triste-quando-ouve-amar-pelos-dois-nao-e-o-unico),\nRui Barros, Rádio Renascença\n\n[Using Data to Find the Angriest Death Grips\nSong](https://towardsdatascience.com/angriest-death-grips-data-anger-502168c1c2f0),\nEvan Oppenheimer\n\n[Hierarchical clustering of David Bowie\nrecords](https://twitter.com/WireMonkey/status/1009915034246565891?s=19),\nAlyssa Goldberg\n\n[tayloR](https://medium.com/@simranvatsa5/taylor-f656e2a09cc3), Simran\nVatsa\n\n## Code of Conduct\n\nPlease note that the spotifyr project is released with a [Contributor\nCode of\nConduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html).\nBy contributing to this project, you agree to abide by its terms.","jobInfo":{"package":"spotifyr","version":"2.2.1","parsingStatus":"success","parserVersion":1,"parsedAt":"2021-11-02T19:30:35+0000"}}

Description

Usage

Arguments