Metadata-Version: 2.5
Name: beets-artistcountry
Version: 1.0.0
Summary: Beets plugin to retrieve the country of an artist from musicbrainz
Project-URL: Repository, https://github.com/agrausem/beets-artistcountry
Author-email: Arnaud Grausem <arnaud.grausem@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: artist,beets,collection,country,music,musicbrainz
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.8
Requires-Dist: beets>=1.6.0
Requires-Dist: musicbrainzngs
Description-Content-Type: text/x-rst

beets-artistcountry
===================

Beets plugin to retrieve the country of an artist from Musicbrainz

Install
-------

To install, use `pip` ::

    $> pip install beets-artistcountry

To activate it, add `artistcountry` to the list of you plugins in your
configuration file (config.yaml) ::

    plugins: [...] artistcountry [...]


How to use it
-------------

The plugin stores the field `artist_country` on each item when you import it.
It is the country of the album artist, so all tracks of an album share it and
stay in the same folder. To skip the lookup on import, add this to your configuration file ::

    artistcountry:
        auto: no

To fill in items you have already imported, run ::

    $> beet artistcountry [QUERY]

Items that already have a country are skipped. Use `-f` to fetch them again.

You can use the field `artist_country` to build your path in your audio
library. Here is an example to do this in your configuration file ::

    paths:
        defaults:
            $albumartist ($artist_country)/[$year] $album%aunique{}/$track $title

Now the path for a track looks like ::

    Metallica (us)/[1984] Ride The Lightning/04 Fade To Black.mp3
