Bandcamp autotagger source for beets (http://beets.io).
Project description
Plug-in for beets to use Bandcamp as an autotagger source.
This is an up-to-date fork of unrblt/beets-bandcamp
Installation
Navigate to your beets
virtual environment, install the plug-in with
pip install --user beetcamp
and add bandcamp
to the plugins
list to your beets configuration file.
Configuration
preferred_media
- Default:
Digital
- available:
Vinyl
,CD
,Cassette
,Digital
.
A comma-separated list of media to prioritise when
fetching albums. For example: preferred_media: Vinyl,Cassette
will ignore CD
, check for a Vinyl
, and then for a Cassette
, in the end
defaulting to Digital
(always available) if none of the two are found.
search_max
- Default:
10
.
Maximum number of items to fetch through search queries. Depending on the specificity of queries and whether a suitable match is found, it could fetch 50+ results which may take a minute, so it'd make sense to bound this to some sort of sensible number. Usually, a match is found among the first 5 items.
lyrics
- Default:
false
.
Add lyrics to the tracks if they are available.
art
- Default:
false
.
Add a source to the FetchArt
plug-in to download album art for Bandcamp albums (requires FetchArt
plug-in enabled).
Usage
This plug-in uses the Bandcamp URL as id (for both albums and songs). If no matching
release is found when importing you can select enter Id
and paste the Bandcamp URL.
Currently supported / returned data
field | singleton track | album track | album |
---|---|---|---|
album |
✔ | ||
album_id |
✔ | ||
albumartist |
✔ | ✔ | ✔ |
albumstatus |
✔ | ||
albumtype |
✔ | ||
artist |
✔ | ✔ | ✔ |
artist_id |
✔ | ✔ | |
catalognum |
✔ | ||
country |
✔ | ||
day |
✔ | ||
disctitle |
✔ | ||
image |
✔ | ✔ | |
index |
✔ | ||
label |
✔ | ✔ | |
length |
✔ | ✔ | |
lyrics |
✔ | ||
media |
✔ | ✔ | |
medium |
✔ | ||
mediums |
✔ | ||
* medium_index |
✔ | ||
* medium_total |
✔ | ||
month |
✔ | ||
title |
✔ | ✔ | |
track_alt |
✔ | ✔ | |
va |
✔ | ||
year |
✔ |
- * are likely to be inaccurate, since Bandcamp does not provide this data, therefore they depend on artists providing some clues in the descriptions of their releases.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.