CLI tool for scraping information from musical website (Rateyourmusic, Metal Archives), with nice album ASCII art.
-
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.
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_delay
allows 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. -
autheticate
attrue
will make the app ask you for RYM username and password, you will be able to see and set your album ratings. -
save_cookies
will save a copy of your RYM cookies in the~/.cache/musicScraper
folder. If disabled, the app will always ask for username and password each timeauthenticate
istrue
.
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')