Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mBaratta96/musicScraper
CLI tool for scraping information from musical websites (Rateyourmusic, Metal Archives), with nice album ASCII art
https://github.com/mBaratta96/musicScraper
cli go golang metalarchives metalarchives-parser metallum rateyourmusic rym tui webscraping
Last synced: about 2 months ago
JSON representation
CLI tool for scraping information from musical websites (Rateyourmusic, Metal Archives), with nice album ASCII art
- Host: GitHub
- URL: https://github.com/mBaratta96/musicScraper
- Owner: mBaratta96
- License: mit
- Created: 2023-02-23T17:01:49.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-08-21T21:41:20.000Z (10 months ago)
- Last Synced: 2024-01-26T17:03:35.885Z (5 months ago)
- Topics: cli, go, golang, metalarchives, metalarchives-parser, metallum, rateyourmusic, rym, tui, webscraping
- Language: Go
- Homepage:
- Size: 11.7 MB
- Stars: 14
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Lists
- cli-apps - musicScraper - CLI tool for scraping information from musical websites (Rateyourmusic, Metal Archives), with nice album ASCII art. (<a name="music"></a>Sound and music)
- awesome-cli-apps - musicScraper - CLI tool for scraping information from musical websites (Rateyourmusic, Metal Archives), with nice album ASCII art. (<a name="music"></a>Sound and music)
README
# 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:
```json
{
"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` at `true` 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 time
`authenticate` is `true`.
```shell
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](https://github.com/gocolly/colly) and [Bubbletea](https://github.com/charmbracelet/bubbletea).
## Screenshots
