Basic instructions - Basic syntax

[simbun]

(17-02-2021 13:50)Alandbush Wrote:  @simbun
Excellent summary.

Thank you for your kind words!

(18-02-2021 02:51)mbussolo Wrote:  Please send the unfinished unpolished "summary of sorts", I will really appreciate it!

I'll try and get something up tomorrow but I do need to clean it up a bit, and it's in markdown so I'll need to remove that.

(18-02-2021 02:51)mbussolo Wrote:  This is great, I almost get it... but not fully. This is where an example would really help. I know it is tedious request, but it will clarify things for sure. Imagine having two songs (two audio files) with tags that identify the albums, the artists, the composers, and then just play around with a couple of examples of indexTags and itemTags and show what the output should look like.

itemTags doesn't affect the output directly, it just tells MinimServer to make those tags available for use in the configuration so it doesn't waste time and resources reading in all the tags, many of which we won't have any intention of using.

Let's continue with your existing setup:

indexTags ---> Artist, Date, Genre, All Artists, Composer, #AudioFormat: MP3orFLAC
itemTags --->
tagOptions ---> Album.sortTags={Album, Artist}

...and assume you populated ComposerSort with the relevant values e.g. 'Vivaldi, Antonio' for the composer 'Antonio Vivaldi'.

Typically, one would want to use the ComposerSort value in the index, where you'd also want it to be sorted by ComposerSort, but when in Album View, or on a 'Now Playing' screen you'd want to see the name in the format 'firstname surname'.
To achieve this you'd add:
tagValue: Composer.value.sort.index={ComposerSort}

You don't want to also index by ComposerSort (as you'd have two essentially identical indexes that would only differ once you got to Album View), but you do need to tell MinimServer that you want to use it, so you'd need to add:
itemTags: ComposerSort

Let's consider another example. I use the tag Subtitle to hold information related to the track (but which isn't a part of the track title) such as whether it's Live, Radio Edit, Extended Version, Remix etc.
I want to include this information whenever I look at a track listing, so I use:
tagFormat: Title.displayFormat={$title^$subtitle^ (^)}

Again, I don't want to include Subtitle as it's own index, but I do need to tell MinimServer to make that tag available for use, so I add it to itemTags.

So we'd end up with:

Code:

indexTags ---> Artist, Date, Genre, All Artists, Composer, #AudioFormat: MP3orFLAC
itemTags ---> ComposerSort, Subtitle

tagOptions ---> Album.sortTags={Album, Artist}
tagValue ---> Composer.value.sort.index={ComposerSort}
tagFormat ---> Title.displayFormat={$title^$subtitle^ (^)}

Hope that makes it clearer.