musicScraper
musicScraper copied to clipboard
CLI tool for scraping information from musical websites (Rateyourmusic, Metal Archives), with nice album ASCII art
musicScraper
CLI tool for scraping information from musical website (Rateyourmusic, Metal Archives), with nice album ASCII art.
Features
-
Search for your favorite artists on Metallum and RateYourMusic (so far)
-
Show discography and album tracklist
-
Show album credits
-
Show user reviews.
-
RYM feature: Login and rate an album.
-
Metallum feature: Check similar artists.
Usage
Clone the repo and build the package with go build, with Go version >= 1.21.
Put the binary file in ~/.local/bin.
Optionally, create a config.json file in ~/.config/musicScraper and write:
{
"request_delay": 1,
"authenticate": true,
"save_cookies": true
}
-
request_delayallows you to slow down the web scraper, by setting the random delay interval (in seconds) between calls. It is highly recommended to set it between 1 and 5, since RateYourMusic may block your IP address if the calls are too fast. However, you can set it at 0 to disable it. -
autheticateattruewill make the app ask you for RYM username and password, you will be able to see and set your album ratings. -
save_cookieswill save a copy of your RYM cookies in the~/.cache/musicScraperfolder. If disabled, the app will always ask for username and password each timeauthenticateistrue.
IMPORTANT: Cloudflare in Metal Archives
Since Metal Archives has implemented Cloudflare protection, you must export
MetalArchives cookies in a ~/.cache/musicScraper/metallumCookie.json file.
You have many options to export your cookies, one of them might be
Cookie-Editor
musicScraper [OPTIONS] "name_of_artist"
-credits
Display RYM credits
-expand
Expand RYM albums (Equivalent of pressing "show all")
-website string
Desired Website ('metallum' or 'rym')
Credits
Made with Colly and Bubbletea.
Screenshots

