Metadata-Version: 2.1
Name: beets-pitchfork
Version: 0.0.6
Summary: Pitchfork rating plugin for beets
Home-page: https://github.com/fortes/beets-pitchfork
Author: Filipe Fortes
Author-email: accounts@fortes.com
License: MIT
Description: # Pitchfork Plugin for Beets
        
        ![build status](https://travis-ci.org/fortes/beets-pitchfork.svg?branch=master)
        
        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
        
Platform: ALL
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
Classifier: Environment :: Console
Description-Content-Type: text/markdown
