Updated doc
This commit is contained in:
@@ -51,7 +51,7 @@ __Note__: You can use the `lms-metadata` tool to get an idea of the tags parsed
|
|||||||
_LMS_ works best when using the default [Picard](https://picard.musicbrainz.org/) settings, where the `artist` tag contains a single display-friendly value, and the `artists` tag holds the actual artist names. This ensures a cleaner, more organized representation of artist names, when multiple artists are involved.
|
_LMS_ works best when using the default [Picard](https://picard.musicbrainz.org/) settings, where the `artist` tag contains a single display-friendly value, and the `artists` tag holds the actual artist names. This ensures a cleaner, more organized representation of artist names, when multiple artists are involved.
|
||||||
|
|
||||||
### Multiple album artists
|
### Multiple album artists
|
||||||
While LMS can manage multiple album artists using the `albumartist` tag, it works better when using the custom `albumartists` and `albumartistssort` tags, similar to how it handles regular artist tags.
|
While _LMS_ can manage multiple album artists using the `albumartist` tag, it works better when using the custom `albumartists` and `albumartistssort` tags, similar to how it handles regular artist tags.
|
||||||
|
|
||||||
__Note__: if you use Picard, add the following script to include these tags:
|
__Note__: if you use Picard, add the following script to include these tags:
|
||||||
```
|
```
|
||||||
@@ -59,6 +59,31 @@ $setmulti(albumartists,%_albumartists%)
|
|||||||
$setmulti(albumartistssort,%_albumartists_sort%)
|
$setmulti(albumartistssort,%_albumartists_sort%)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Album track grouping
|
||||||
|
The recommended way to group tracks within an album is to use the `MUSICBRAINZ_ALBUMID` tag.
|
||||||
|
|
||||||
|
When this tag is not present, _LMS_ will attempt to group them as best as possible:
|
||||||
|
|
||||||
|
If the analyzed file contains a disc number and the total number of discs is greater than 1, sibling directories are also scanned to find a matching album.
|
||||||
|
Otherwise, _LMS_ will only consider albums within the current directory.
|
||||||
|
|
||||||
|
For an album to be considered a match, the following conditions must be met:
|
||||||
|
* Same name
|
||||||
|
* Same sort name
|
||||||
|
* Same total number of discs
|
||||||
|
* Identical 'compilation' flag value
|
||||||
|
* Same record labels
|
||||||
|
* Same barcode
|
||||||
|
|
||||||
|
## Artist image lookup
|
||||||
|
The recommended method is to name the file using the artist's MusicBrainz ArtistID. This file can be placed anywhere within one of the scanned libraries.
|
||||||
|
|
||||||
|
If no file with the MusicBrainz ArtistID is found, _LMS_ will look for a file named `artist` (or another name configured in `lms.conf`) in the artist's directories. Here's how it works:
|
||||||
|
|
||||||
|
1. Identify the artist's directory: _LMS_ selects all albums by the artist using the "AlbumArtist" link and determines the longest common path among them.
|
||||||
|
2. Scan for the image: the directory is scanned starting from this common path, moving upwards if needed, until the cover art file is found.
|
||||||
|
3. Fallback search: if no image is found, _LMS_ will then search within each individual album folder.
|
||||||
|
|
||||||
## Playlist support
|
## Playlist support
|
||||||
_LMS_ supports playlist files in `m3u` and `m3u8` formats. These playlists are synced during the scan process and are available as public shared playlists.
|
_LMS_ supports playlist files in `m3u` and `m3u8` formats. These playlists are synced during the scan process and are available as public shared playlists.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user