Skip to content

Plugin for beets music manager that adds album reviews from Pitchfork

License

Notifications You must be signed in to change notification settings

fortes/beets-pitchfork

Repository files navigation

Pitchfork Plugin for Beets

build status

Plugin for Beets that adds ratings from Pitchfork.

Installation

pip install beets-pitchfork

To install bleeding edge instead, use:

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:

plugins: pitchfork

If you'd like to automatically fetch reviews on import, add the following (default is False):

pitchfork:
  auto: true

Use

Fetch album ratings via:

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:

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
  • 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
  • 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 to avoid spamming Pitchfork servers

License

MIT

About

Plugin for beets music manager that adds album reviews from Pitchfork

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages