Search for songs by lyrics.
LyricallyChallenged is a lyric-based Rails app and iOS app to search for songs. Each song can be played via a Spotify widget and is presented with full lyrics and details on why that song was chosen.
Recent research indicates that lyric-based recommendation systems are 12.6 times more effective than random recommendations, and may offer better recommendations than collaborative filtering, especially, "within small musical niches".
The site is available live on Heroku
To clone the repo for localhost:
0. Clone the repo
In your terminal, navigate to where you want to place the file:
git clone https://github.com/FridaSjoholm/lyrically-challenged.git
1. Get (and hide) your API keys
https://github.com/bkeepers/dotenv for instructions)2. Include dotenv gem in your gem file (look at
You'll need to get API keys from:
This is what our .env file looks like, with the empty strings replaced with API keys.
SPOTIFY_API_OAUTH_KEY = "" SPOTIFY_CLIENT_ID = "" SPOTIFY_CLIENT_SECRET = "" MUSIC_GRAPH_API_KEY = "" GOOGLE_APPLICATION_CREDENTIALS = "".json
- The GOOGLE_APPLICATION_CREDENTIALS will be a path file to a json file in the root of your app.
3. Navigate to the project
- Navigate to the project
- Run bundle to install gems
- Start the rails server
cd lyricallychallenged bundle rails s
🎉 🎉 Yay! Your site will be live at http://localhost:3000/
About Lyrically Challenged
If you are interested in improving or adding new awesome features to LyricallyChallenged, please feel free to submit an issue or a pull request!