{"id":32207412,"url":"https://github.com/ewenme/geniusr","last_synced_at":"2025-10-22T05:52:56.505Z","repository":{"id":26972757,"uuid":"111335688","full_name":"ewenme/geniusr","owner":"ewenme","description":"work with data \u0026 lyrics from Genius","archived":false,"fork":false,"pushed_at":"2024-05-10T16:41:51.000Z","size":4171,"stargazers_count":51,"open_issues_count":5,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-10-22T05:52:49.786Z","etag":null,"topics":["genius","genius-api","lyrics","r","rstats"],"latest_commit_sha":null,"homepage":"https://ewenme.github.io/geniusr/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ewenme.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-19T22:02:33.000Z","updated_at":"2025-07-29T03:39:48.000Z","dependencies_parsed_at":"2022-08-07T12:01:22.274Z","dependency_job_id":null,"html_url":"https://github.com/ewenme/geniusr","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ewenme/geniusr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewenme%2Fgeniusr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewenme%2Fgeniusr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewenme%2Fgeniusr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewenme%2Fgeniusr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ewenme","download_url":"https://codeload.github.com/ewenme/geniusr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewenme%2Fgeniusr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280389298,"owners_count":26322507,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["genius","genius-api","lyrics","r","rstats"],"created_at":"2025-10-22T05:52:53.070Z","updated_at":"2025-10-22T05:52:56.497Z","avatar_url":"https://github.com/ewenme.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n```{r setup, include=FALSE}\nknitr::opts_chunk$set(\n  echo = TRUE, warning = FALSE, message = FALSE, collapse = TRUE, \n  comment = \"#\u003e\", fig.path = \"man/figures/README-\"\n  )\n```\n\n# geniusr \u003cimg src=\"man/figures/logo.png\" width=\"160px\" align=\"right\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![Lifecycle: maturing](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing)\n[![CRAN status](https://www.r-pkg.org/badges/version/geniusr)](https://cran.r-project.org/package=geniusr)\n[![DLs](http://cranlogs.r-pkg.org/badges/geniusr)](http://cran.rstudio.com/web/packages/geniusr/index.html)\n[![Travis build Status](https://travis-ci.org/ewenme/geniusr.png)](https://travis-ci.org/ewenme/geniusr)\n[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/ewenme/geniusr?branch=master\u0026svg=true)](https://ci.appveyor.com/project/ewenme/geniusr)\n[![Codecov test coverage](https://codecov.io/gh/ewenme/geniusr/branch/master/graph/badge.svg)](https://codecov.io/gh/ewenme/geniusr?branch=master)\n\u003c!-- badges: end --\u003e\n\n## Overview\n\nTools for working with the *Genius* (FKA *Rap Genius*) API.\n\n- Genius Developers Site: [https://genius.com/developers](https://genius.com/developers)\n- Genius API Docs: [https://docs.genius.com/](https://docs.genius.com/)\n\n## Install\n\nGet the latest stable version from CRAN...\n\n```{r, eval = FALSE}\ninstall.packages(\"geniusr\")\n```\n\n...or install the development version from Github (recommended).\n\n```{r install_dev, eval=FALSE}\nremotes::install_github(\"ewenme/geniusr\")\n```\n\n## Authenticate\n\n1. [Create a Genius API client](https://genius.com/api-clients/new)\n2. Generate a client access token from your [API Clients page](https://genius.com/api-clients)\n3. Set your credentials in the System Environment variable `GENIUS_API_TOKEN` by calling the `genius_token()` function and entering your Genius Client Access Token when prompted.\n\n## Use\n\nStart with [the basics!](https://ewenme.github.io/geniusr/articles/geniusr.html)\n\n### How many times did 'Ye say \"good morning\", on the track \"Good Morning\"?\n\n```{r good_morning_count}\n\nlibrary(geniusr)\nlibrary(dplyr)\nlibrary(tidytext)\n\n# get lyrics\nget_lyrics_search(artist_name = \"Kanye West\",\n                  song_title = \"Good Morning\") %\u003e% \n  # get lyric bigrams\n  unnest_tokens(bigram, line, token = \"ngrams\", n = 2) %\u003e%\n  # look for good morning\n  filter(bigram == \"good morning\") %\u003e% \n  # count bigram frequency\n  nrow()\n```\n\n## Other\n\n- Get citation information for geniusr in R with `citation(package = 'geniusr')`\n- Please note that the geniusr project is released with a [Contributor Code of Conduct](https://ewenme.github.io/geniusr//CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.\n\n## Related work\n\n- the [genius](https://github.com/JosiahParry/genius) package specialises in lyrics retrieval from Genius.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fewenme%2Fgeniusr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fewenme%2Fgeniusr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fewenme%2Fgeniusr/lists"}