Foobar2000 Talk:Title Formatting Reference: Difference between revisions

Latest revision as of 15:35, 25 January 2013

Editing guidelines

Do not document redundant fields such as %playlist_number%. When there is more than one way to do something, only document the way that is described in the official manual; the other ones may be old version leftovers or temporary for some other reason.
Remember: less information is better if it still satisfies 99.99% of the people reading this.

Metadata

In my opinion the metadata description needs to be expanded. For instance, I have no idea what the following means, or what the function does based on that argument: Example: $meta(artist) → "He, She, It" At least put a proper artist title in the quotations to give us an adequate description of the function. 68.80.11.34 07:59, 2 October 2012 (CEST)

@@ Line 1: / Line 1: @@
-is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
+== Editing guidelines ==
+* Do not document redundant fields such as %playlist_number%. When there is more than one way to do something, only document the way that is described in the official manual; the other ones may be old version leftovers or temporary for some other reason.
+* Remember: less information is better if it still satisfies 99.99% of the people reading this.
-IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
+== Metadata ==
+In my opinion the metadata description needs to be expanded.
+For instance, I have no idea what the following means, or what the function does based on that argument:
-{| border=1 cellspacing=0 cellpadding=2 style=""
+Example: $meta(artist) → "He, She, It"
-! colspan="2" style="font-size:larger" | Metadata
+At least put a proper artist title in the quotations to give us an adequate description of the function. [[Special:Contributions/68.80.11.34|68.80.11.34]] 07:59, 2 October 2012 (CEST)
-|-
-! %album artist%
-| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
-|-
-! %album%
-| Defined as ''$if3($meta(album),$meta(venue))''.
-|-
-! %artist%
-| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
-|-
-! %disc%
-%discnumber%
-| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
-|-
-! %track artist%
-| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
-|-
-! %title%
-| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
-|-
-! %track%
-%tracknumber%
-| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
-|}
-{| border=1 cellspacing=0 cellpadding=2 style=""
-! colspan="2" style="font-size:larger" | Technical information
-|-
-! %bitrate%
-| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
-|-
-! %channels%
-| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
-|-
-! %filesize%
-| Defined as ''%_filesize%''. Returns the filesize in bytes.
-|-
-! %samplerate%
-| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
-|-
-! %codec%
-| Defined as ''$codec()''.
-|}
-{| border=1 cellspacing=0 cellpadding=2 style=""
-! colspan="2" style="font-size:larger" | Special fields
-|-
-! %playlist_number%
-| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns the position of the track as index into the playlist. The first track has index 1. The index is padded from the left with zeroes to the same number of digits as the last track.
-|}