Updated artwork section in the readme

This commit is contained in:
chme 2014-12-14 08:37:30 +01:00
parent 9b7a22ab0a
commit 6ceb3ebb43

26
README
View File

@ -281,31 +281,29 @@ forked-daapd scales down (never up) the artwork on-the-fly to match the
constraints given by the client. Note, however, that the bigger the picture, constraints given by the client. Note, however, that the bigger the picture,
the more time and resources it takes to perform the scaling operation. the more time and resources it takes to perform the scaling operation.
As for the naming convention, it is quite simple; consider your foo.mp3 song, The naming convention for album and artist artwork (group artwork) is as
residing at /bar/foo.mp3: follows:
- if it has embedded artwork, this will be used as the artwork for this file;
- failing that, if /bar/foo.{png,jpg} exists, it is used;
- failing that, if /bar/{artwork,cover,Folder}.{png,jpg} exists, it is used;
- failing that, if /bar/bar.{png,jpg} exists, it is used
For "groups" (same album name and album artist), the situation is a bit
different:
- if a file {artwork,cover,Folder}.{png,jpg} is found in one of the directories - if a file {artwork,cover,Folder}.{png,jpg} is found in one of the directories
containing files that are part of the group, it is used as the artwork. The containing files that are part of the group, it is used as the artwork. The
first file found is used, ordering is not guaranteed; first file found is used, ordering is not guaranteed;
- failing that, if [directory name].{png,jpg} is found in one of the - failing that, if [directory name].{png,jpg} is found in one of the
directories containing files that are part of the group, it is used as the directories containing files that are part of the group, it is used as the
artwork. The first file found is used, ordering is not guaranteed; artwork. The first file found is used, ordering is not guaranteed;
- failing that, individual files are examined and the first artwork found - failing that, individual files are examined and the first file found
(embedded or in the same dir and named the same as the file) is used. Here with an embedded artwork is used. Here again, ordering is not guaranteed.
again, ordering is not guaranteed.
Artwork for individual songs is not supported, artwork for individual songs is
found by resolving to the group artwork.
{artwork,cover,Folder} are the default, you can add other base names in the {artwork,cover,Folder} are the default, you can add other base names in the
configuration file. configuration file.
You can use symlinks for the artwork files; the artwork is not scanned/indexed You can use symlinks for the artwork files; the artwork is not scanned/indexed.
in any way in the database and there is no caching on forked-daapd's side.
forked-daapd caches artwork in a separate cache file. The default path is
/var/cache/forked-daapd/cache.db and can be configured in the configuration
file. The cache.db file can be deleted without losing the library and pairing
informations.
Library Library
------- -------