https://github.com/obriain/LyricizeMe

An application that provides random song lyrics and annotations for a chosen artist, powered by the Genius API.
https://github.com/obriain/LyricizeMe

Last synced: 7 days ago
JSON representation

An application that provides random song lyrics and annotations for a chosen artist, powered by the Genius API.

• Host: GitHub
• URL: https://github.com/obriain/LyricizeMe
• Owner: dtobrien23
• Created: 2023-10-27T16:31:08.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-10-30T18:16:26.000Z (over 1 year ago)
• Last Synced: 2024-08-01T22:02:59.981Z (9 months ago)
• Language: Jupyter Notebook
• Homepage:
• Size: 16.3 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# LyricizeMe

LyricizeMe simplifies the process of exploring an artist's songs. Users simply need to enter the artist's name, and are presented with random song lyrics, annotations, and artist insights, powered by the massive library of song data provided by Genius (https://docs.genius.com/).

![Application UI](Images/lm.png)

![Application UI](Images/wu-tang.png)

## Data Processing

A comprehensive data set of Genius song data gathered by CarlosGDCJ (https://www.kaggle.com/datasets/carlosgdcj/genius-song-lyrics-with-language-information) was processed to just contain columns with Genius song IDs for each song, and the corresponding artist name - information essential to the functioning of LyricizeMe. An additional column was then added to contain processed artist names, which allows for common user errors or variations in input. This processing included converting to lowercase, replacing '&' with 'and', '$' with 's', removing 'the', and eliminating spaces and punctuation. This data was then stored in a database.

## How It Works

### Frontend (React)

1. Users input the name of an artist in the search bar.

2. The frontend processes the input by transforming it to lowercase, removing special characters, and spaces.

3. It then sends a request to the backend server to retrieve a random lyric and annotation from a random song of the artist.

4. A skeleton screen is displayed while waiting for the backend response.

5. When the response is received, the frontend displays the song title, artist name, lyrics, and annotation. If the artist is not found or there are no annotations for any of the artist's songs, it provides an error message.

### Backend (Python - Flask)

1. The backend receives the artist's name from the frontend as a JSON request.

2. It connects to the database to retrieve a list of songs by the specified artist.

3. If songs are found, it attempts to retrieve lyrics and annotations for a randomly selected song by passing the song ID to the Genius API.

4. It filters out annotations with low votes and provides the song title, artist name, lyrics, and annotation as a JSON response.

5. If no suitable song is found or the artist is not in the database, it returns an error message.

## Contact

If you have any questions or need further information, feel free to contact me via the repository.