Holzhaus / beets-extrafiles

A plugin for beets that copies additional files and directories during the import process.
MIT License
45 stars 10 forks source link

Improve documentation on path format #18

Open FichteFoll opened 4 years ago

FichteFoll commented 4 years ago

The README does not mention which variables are replaced in the path format interpreted by this plugin. From reading the source code, I have determined this to be the following:

As well as all functions provided by beets by default.

I was especially interested in filename and basename, because the readme wasn't clear enough (to me) on whether the matched files will be copied into a directory specfied in the paths setting or whether that will be the path for each individual file. Especially considering that the file extension is specifically not considered for the template and merely appended.

Also a mention of the default pattern would be useful. That should be $albumpath/$filename.

alfureu commented 4 years ago

I second this. Is there any way to put the extra files inside of a custom made folder defined by inline and path? All the extra files land where the albumpath is, but it does not take insto consideration the full albumpath, just the first part of it.

daniellwdb commented 2 years ago

I second this. Is there any way to put the extra files inside of a custom made folder defined by inline and path? All the extra files land where the albumpath is, but it does not take insto consideration the full albumpath, just the first part of it.

Been a while but +1 for this, this plugin does not respect full album paths so it's not possible to create subdirectories when using buckets

KingDuckZ commented 6 months ago

Trying this plugin for the first time, I also had to resort looking at the source code to figure things out. Specifically, I was interested in renaming cover art files and came up with this config:

patterns:
  cover: ['[cC]over.*', '[fF]older.*', '[fF]ront.*']
  my_extensions: ['*.pdf', '*.png', '*.jpg', '*.jpeg']
paths:
  cover: $albumpath/cover

it somehow works (I'm not sure how the globs in cover don't clash with those in my_extensions but on a quick test it looks fine), and it does rename for example Folder.jpg to cover.jpg, however I also wanted to change .jpeg extensions into just .jpg for cover files, ie I always want my covers to be called either cover.jpg or cover.png. Is there a way to achieve that?