https://github.com/fortes/beets-pitchfork
Plugin for beets music manager that adds album reviews from Pitchfork
https://github.com/fortes/beets-pitchfork
beets beets-plugin pitchfork
Last synced: 24 days ago
JSON representation
Plugin for beets music manager that adds album reviews from Pitchfork
- Host: GitHub
- URL: https://github.com/fortes/beets-pitchfork
- Owner: fortes
- License: mit
- Archived: true
- Created: 2018-08-17T14:06:14.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-02-07T14:17:47.000Z (over 3 years ago)
- Last Synced: 2025-04-30T09:12:52.996Z (24 days ago)
- Topics: beets, beets-plugin, pitchfork
- Language: Python
- Size: 17.6 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pitchfork Plugin for Beets
Plugin for [Beets](http://beets.io/) that adds ratings from [Pitchfork](https://pitchfork.com/).
## Installation
```bash
pip install beets-pitchfork
```
To install bleeding edge instead, use:
```bash
pip install git+git://github.com/fortes/beets-pitchfork.git@master
```
## Configuration
Make sure to add `pitchfork` to your `plugins` setting in `config.yaml`. In the unlikely event you don't have any other plugins, just add a new line like:
```yaml
plugins: pitchfork
```
If you'd like to automatically fetch reviews on import, add the following (default is `False`):
```yaml
pitchfork:
auto: true
```
### Use
Fetch album ratings via:
```bash
beet pitchfork [options] [QUERY...]
```
* `-f`/`--force`: Force updating even if review already exists
Use `pitchfork_score` in your queries. You can find this year's highly rated albums in your library like so:
```bash
beet ls -a pitchfork_score:8..10 year:2018
```
The following fields are available via this plugin:
* `pitchfork_bnm`: Whether the album was designated [Best New Music](https://pitchfork.com/reviews/best/albums/)
* `pitchfork_description`: Review summary
* `pitchfork_score`: Numeric score
* `pitchfork_url`: Link to the actual review
## Changelog
* `0.0.6`: Don't crash on server errors
* `0.0.5`: Upload to pypi as [`beets-pitchfork`](https://pypi.org/project/beets-pitchfork/)
* `0.0.4`: Enable auto-fetching review on import
* `0.0.3`: Add `pitchfork_bnm`, move back to `pitchfork` library
* `0.0.2`: Use `pitchfork_api` dependency
* `0.0.1`: First release
## Possible future work
* Allow manual specification for artist / album query in order to alleviate failures
* Consider some method of re-trying search if no result found
* Use [pre-scraped database](https://github.com/nolanbconaway/pitchfork-data) to avoid spamming Pitchfork servers
## License
MIT