The bucket plugin groups your files into buckets folders representing ranges. This kind of organization can classify your music by periods of time (e.g,. 1960s, 1970s, etc.), or divide overwhelmingly large folders into smaller subfolders by grouping albums or artists alphabetically (e.g. A-F, G-M, N-Z).
To use the bucket plugin, first enable it in your configuration (see Using Plugins). The plugin provides a template function called %bucket for use in path format expressions:
paths:
default: /%bucket{$year}/%bucket{$artist}/$albumartist-$album-$year
Then, define your ranges in the bucket: section of the config file:
bucket:
bucket_alpha: ['A-F', 'G-M', 'N-Z']
bucket_year: ['1980s', '1990s', '2000s']
The bucket_year parameter is used for all substitutions occuring on the $year field, while bucket_alpha takes care of textual fields.
The definition of a range is somewhat loose, and multiple formats are allowed:
To configure the plugin, make a bucket: section in your configuration file. The available options are:
Here’s an example:
bucket:
bucket_year: ['2000-05']
extrapolate: true
bucket_alpha: ['A - D', 'E - L', 'M - R', 'S - Z']
bucket_alpha_regex:
'A - D': ^[0-9a-dA-D…äÄ]
This configuration creates five-year ranges for any input year. The A - D bucket now matches also all artists starting with ä or Ä and 0 to 9 and … (ellipsis). The other alpha buckets work as ranges.