Thanks to visit codestin.com
Credit goes to github.com

Skip to content

engomaressam/rym

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rate Your Music (RYM) Tools

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.

Features

  • 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

Requirements

  • Python 3.7+
  • Required Python packages (install using pip install -r requirements.txt):
    • requests
    • musicbrainzngs
    • python-dotenv

Installation

  1. Clone the repository:

    git clone https://github.com/engomaressam/rym.git
    cd rym
  2. Install the required dependencies:

    pip install -r requirements.txt
  3. Set up your configuration:

    • Copy .env.example to .env (if available)
    • Add your API keys to the configuration files:
      • lastfm_config.py for Last.fm API
      • spotify_config.py for Spotify API (if needed)

Usage

Search for an Artist

python search_band.py "Artist Name"

Get Album Ratings

python 01.get.rating.py "Artist Name"

MusicBrainz Search

python musicbrainz_search.py "Search Query"

Scripts

  • 01.get.rating.py: Fetches album ratings for a given artist
  • musicbrainz_search.py: Searches for artists and albums in MusicBrainz
  • search_band.py: Searches for band information
  • lastfm_config.py: Configuration for Last.fm API
  • spotify_config.py: Configuration for Spotify API

Configuration

Last.fm API

  1. Get an API key from Last.fm
  2. Update lastfm_config.py with your API key

MusicBrainz API

No API key is required for basic usage, but consider setting a custom user agent as shown in the scripts.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Omar Essam

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages