This repository contains Python scripts for interacting with music databases like Rate Your Music, MusicBrainz, and Last.fm. The tools allow you to search for artists, albums, and retrieve ratings and metadata.
- MusicBrainz Integration: Search for artists and albums using the MusicBrainz database
- Last.fm Integration: Fetch album information and metadata
- RYM Data Collection: Gather ratings and reviews from Rate Your Music
- Configuration Support: Easily configure API keys and settings
- Python 3.7+
- Required Python packages (install using
pip install -r requirements.txt):- requests
- musicbrainzngs
- python-dotenv
-
Clone the repository:
git clone https://github.com/engomaressam/rym.git cd rym -
Install the required dependencies:
pip install -r requirements.txt
-
Set up your configuration:
- Copy
.env.exampleto.env(if available) - Add your API keys to the configuration files:
lastfm_config.pyfor Last.fm APIspotify_config.pyfor Spotify API (if needed)
- Copy
python search_band.py "Artist Name"python 01.get.rating.py "Artist Name"python musicbrainz_search.py "Search Query"01.get.rating.py: Fetches album ratings for a given artistmusicbrainz_search.py: Searches for artists and albums in MusicBrainzsearch_band.py: Searches for band informationlastfm_config.py: Configuration for Last.fm APIspotify_config.py: Configuration for Spotify API
- Get an API key from Last.fm
- Update
lastfm_config.pywith your API key
No API key is required for basic usage, but consider setting a custom user agent as shown in the scripts.
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
Omar Essam