joshuaboniface/c3dbdl
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Adjust default structure again

Browse Source
This commit is contained in:
Joshua Boniface
2023-04-06 19:47:11 -04:00
parent a766f2a61f
commit 9ab0f0a1ec
2 changed files with 12 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -112,18 +112,24 @@ which are mapped at download file. The available fields are:
* `title`: The title of the song.
* `year`: The year of the album/song.
* `author`: The author of the file on C3DB.
* `orig_file`: The original filename that would be downloaded by e.g. a browser.
* `orig_name`: The original filename that would be downloaded by e.g. a browser.
The default structure leverages all of these options to create an archive-ready structure as follows:
The default structure leverages most of these options to create an archive-ready structure as follows:
```
{genre}/{author}/{artist}/{album}/{title} [{year}].{orig_file}
{artist}/{album}/{title}.{author}.{orig_name}
```
The genre is excluded because in my experience it is a fairly useless metric and is often incorrectly set,
so it gets in the way more often than not. You are free of course to add it in to your own custom structure.
The date is excluded for similar reasons and because if you know the album, you know the date.
If any field is missing during download, it is replaced with "None".
As an example:
```
Prog/Rush/Vapor Trails [Remixed]/Sweet Miracle [2002] (ejthedj).sweetMiracle
Rush/Vapor Trails [Remixed]/Sweet Miracle.ejthedj.sweetMiracle
```
Note that any parent director(ies) will be automatically created down the whole tree until the final filename.

4
c3dbdl/c3dbdl.py
View File

@ -436,7 +436,7 @@ def database():
"--file-structure",
"_file_structure",
envvar="C3DBDL_DL_FILE_STRUCTURE",
default="{genre}/{author}/{artist}/{album}/{title} [{year}].{orig_name}",
default="{artist}/{album}/{title}.{author}.{orig_name}",
help="Specify the output file/directory stucture.",
)
@click.option(
@ -490,7 +490,7 @@ def download(_filters, _id, _desc, _limit, _file_structure):
\b
The default output file structure is:
"{genre}/{author}/{artist}/{album}/{title} [{year}].{orig_name}"
"{artist}/{album}/{title}.{author}.{orig_name}"
Filters allow granular selection of the song(s) to download. Multiple filters can be
specified, and a song is selected only if ALL filters match (logical AND). Each filter