Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wjakethompson/taylor

A comprehensive resource for data on Taylor Swift songs, and ggplot2 helper functions
https://github.com/wjakethompson/taylor

color-palettes data genius-lyrics ggplot2-themes lyrics r spotify spotify-api taylor-swift

Last synced: 28 days ago
JSON representation

A comprehensive resource for data on Taylor Swift songs, and ggplot2 helper functions

Host: GitHub
URL: https://github.com/wjakethompson/taylor
Owner: wjakethompson
License: other
Created: 2021-06-25T19:12:45.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-08-21T00:05:06.000Z (3 months ago)
Last Synced: 2024-09-30T03:56:04.793Z (about 1 month ago)
Topics: color-palettes, data, genius-lyrics, ggplot2-themes, lyrics, r, spotify, spotify-api, taylor-swift
Language: R
Homepage: https://taylor.wjakethompson.com
Size: 63.6 MB
Stars: 42
Watchers: 2
Forks: 12
Open Issues: 0
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ---

output: github_document

---

```{r setup, include = FALSE}

library(tidyverse)

library(taylor)

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# taylor

[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

[![lifecycle](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html)

[![R package version](https://www.r-pkg.org/badges/version/taylor)](https://CRAN.R-project.org/package=taylor)

[![Package downloads](https://cranlogs.r-pkg.org/badges/grand-total/taylor)](https://cran.r-project.org/package=measr)

[![R-CMD-check](https://github.com/wjakethompson/taylor/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/wjakethompson/taylor/actions/workflows/R-CMD-check.yaml)

[![codecov](https://codecov.io/gh/wjakethompson/taylor/branch/main/graph/badge.svg?token=TECvfoOYHh)](https://app.codecov.io/gh/wjakethompson/taylor)

[![Netlify Status](https://api.netlify.com/api/v1/badges/b80199c9-57a9-4d08-87e9-4887a67d01e4/deploy-status)](https://app.netlify.com/sites/r-taylor/deploys)

[![Signed by](https://img.shields.io/badge/Keybase-Verified-brightgreen.svg)](https://keybase.io/wjakethompson)

![License](https://img.shields.io/badge/License-MIT-blue.svg)

## Overview 

The goal of taylor is to provide easy access to a curated data set of Taylor Swift songs, including lyrics and audio characteristics. Data comes [Genius](https://genius.com/artists/Taylor-swift) and the [Spotify API](https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02).

![GIF of Taylor saying "yes"](https://media.giphy.com/media/2tg4k9pXNcGi7kZ9Pz/giphy.gif)

## Installation

You can install the released version of taylor from [CRAN](https://cran.r-project.org/) with:

``` r

install.packages("taylor")

```

To install the development version from [GitHub](https://github.com/) use:

``` r

# install.packages("remotes")

remotes::install_github("wjakethompson/taylor")

```

## Example

There are three main data sets. The first is `taylor_album_songs`, which includes lyrics and audio features from the Spotify API for all songs on Taylor's official studio albums. Notably this excludes singles released separately from an album (e.g., *Only the Young*, *Christmas Tree Farm*, etc.), and non-Taylor-owned albums that have a Taylor-owned alternative (e.g., *Fearless* is excluded in favor of *Fearless (Taylor's Version)*). We support artists owning their work.

```{r album-songs}

taylor_album_songs

```

You can access Taylor's entire discography with `taylor_all_songs`. This includes all of the songs in `taylor_album_songs` plus EPs, individual singles, and the original versions of albums that have been re-released as *Taylor's Version*.

```{r all-songs}

taylor_all_songs

```

Finally, there is a small data set, `taylor_albums`, summarizing Taylor's album release history.

```{r albums}

taylor_albums

```

## Code of Conduct

Contributions are welcome.

To ensure a smooth process, please review the [Contributing Guide](https://taylor.wjakethompson.com/CONTRIBUTING.html).

Please note that the taylor project is released with a [Contributor Code of Conduct](https://taylor.wjakethompson.com/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.