Foobar2000:Title Formatting Introduction - Revision history

Beardgoggles: Added sidebar template.

2022-06-12T21:00:54Z

Added sidebar template.

← Older revision		Revision as of 21:00, 12 June 2022
Line 1:		Line 1:
	{{~~fb2k~~}}		{{sidebar foobar2000 title formatting}}
	[[foobar2000]] uses '''title formatting''' scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples\|Titleformat Examples]].		[[foobar2000]] uses '''title formatting''' scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples\|Titleformat Examples]].

Line 49:		Line 49:
	* [[foobar2000:Title Formatting Reference\|Title Formatting Reference]]		* [[foobar2000:Title Formatting Reference\|Title Formatting Reference]]
	* [[foobar2000:Titleformat Examples\|Titleformat Examples]]		* [[foobar2000:Titleformat Examples\|Titleformat Examples]]

	~~[[Category:foobar2000 Guides\|Title Formatting Introduction]]~~

Beardgoggles: /* See also */ Added link to Titleformat Examples page

2019-12-02T17:31:09Z

See also: Added link to Titleformat Examples page

← Older revision		Revision as of 17:31, 2 December 2019
Line 48:		Line 48:
	==See also==		==See also==
	* [[foobar2000:Title Formatting Reference\|Title Formatting Reference]]		* [[foobar2000:Title Formatting Reference\|Title Formatting Reference]]
			* [[foobar2000:Titleformat Examples\|Titleformat Examples]]

	[[Category:foobar2000 Guides\|Title Formatting Introduction]]		[[Category:foobar2000 Guides\|Title Formatting Introduction]]

C3POwen: /* Syntax */ Updated with "code" template to distinguish in-line code snippets.

2018-10-14T19:55:41Z

Syntax: Updated with "code" template to distinguish in-line code snippets.

← Older revision		Revision as of 19:55, 14 October 2018
Line 1:		Line 1:
	foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples\|Titleformat Examples]].		{{fb2k}}
			[[foobar2000]] uses '''title formatting''' scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples\|Titleformat Examples]].

	== Just text ==		==Just text==

	For example, you can customize the format of the playlist or the statusbar. The simplest thing you can do, is display some static text:		For example, you can customize the format of the playlist or the statusbar. The simplest thing you can do, is display some static text:

	This text will be displayed as-is.		This text will be displayed as-is.

	Admittedly, this is pretty boring and you probably will not want to use this on its own. There is one more thing worth noting before we move on to more interesting things. Title formatting code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:		Admittedly, this is pretty boring and you probably will not want to use this on its own. There is one more thing worth noting before we move on to more interesting things. Title formatting code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:

	'These characters normally have special meaning: ( ) , [ ] $ %'		'These characters normally have special meaning: ( ) , [ ] $ %'

	Single quotes, percent signs and ampersand can be included in the output, by doubling them outside single quotes.		Single quotes, percent signs and ampersand can be included in the output, by doubling them outside single quotes.
Line 15:		Line 16:
	Note that linebreaks will not appear in the output, unless they occur within single quotes:		Note that linebreaks will not appear in the output, unless they occur within single quotes:

	This is the		This is the
	first line.		first line.
	'This will stretch		'This will stretch
	to the second line.'		to the second line.'

	Note that multiline scripts cannot be used everywhere; in the default components, they can be used for the text on the icon in the system notification area ("systray") and in the copy command script. The playlist and other singleline displays will truncate strings with line breaks, and would display the above example like this:		Note that multiline scripts cannot be used everywhere; in the default components, they can be used for the text on the icon in the system notification area ("systray") and in the copy command script. The playlist and other singleline displays will truncate strings with line breaks, and would display the above example like this:

	This is the first line. This will stretch (...)		This is the first line. This will stretch (...)

	Comments are achieved by placing '//' at the start of a new line of code. That entire line will be commented out, eg.		Comments are achieved by placing {{code\|//}} at the start of a new line of code. That entire line will be commented out, e.g.
	~~//This is commented and will not appear// this is also commented due to the '//' at the start of the line~~
	~~This is not commented and will appear// this and the '//' preceding it will also appear, because there is no '//' at the start of the line~~

	== Song information ==		//This is commented and will not appear// this is also commented due to the '//' at the start of the line
			This is not commented and will appear// this and the '//' preceding it will also appear, because there is no '//' at the start of the line

			==Song information==

	Title formatting scripts would be quite useless, if you could not display information about songs. To access the value of the "title" tag, you would write "title" in percent signs:		Title formatting scripts would be quite useless, if you could not display information about songs. To access the value of the "title" tag, you would write "title" in percent signs:

	%title%		%title%

	Actually, the above is a little smarter than just using: looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are <code>%artist%~~</code>~~, <code>%tracknumber%~~</code>~~, <code>%list_index%~~</code>~~ and of course <code>%title%~~</code>~~.		Actually, the above is a little smarter than just using: looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are {{code\|%artist%}}, {{code\|%tracknumber%}}, {{code\|%list_index%}} and of course {{code\|%title%}}.

	A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:		A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:

	$meta(title)		$meta(title)

	~~== Technical information ==~~

	Technical information can be accessed in similar way as tags, either using <code>%__name%</code> or <code>$info(name)</code> where the name is one of those that can be seen in the "Other info" part of the properties window in foobar2000. There are some field remappings for technical information as well, for example <code>%bitrate%</code> gives you the average bitrate of a song or the current dynamic bitrate, if the song is playing, provided that the format supports reporting the dynamic bitrate.

			==Technical information==

	~~==Additional Reading==~~		Technical information can be accessed in similar way as tags, either using {{code\|%__name%}} or {{code\|$info(name)}} where the name is one of those that can be seen in the "Other info" part of the properties window in foobar2000. There are some field remappings for technical information as well, for example {{code\|%bitrate%}} gives you the average bitrate of a song or the current dynamic bitrate, if the song is playing, provided that the format supports reporting the dynamic bitrate.

	* [[foobar2000:~~Titleformat~~ Reference\|Title Formatting Reference ~~page~~]]		==See also==
			* [[foobar2000:Title Formatting Reference\|Title Formatting Reference]]

	[[Category:foobar2000 Guides\|~~Titleformat~~ Introduction]]		[[Category:foobar2000 Guides\|Title Formatting Introduction]]

Db1989 at 13:06, 22 July 2011

2011-07-22T13:06:12Z

← Older revision		Revision as of 13:06, 22 July 2011
Line 1:		Line 1:
	foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples]].		foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples\|Titleformat Examples]].

	== Just text ==		== Just text ==

Db1989 at 13:02, 22 July 2011

2011-07-22T13:02:44Z

← Older revision		Revision as of 13:02, 22 July 2011
Line 1:		Line 1:
	foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns.		foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns. A full list of available title formatting commands is maintained at [[foobar2000:Title Formatting Reference\|Title Formatting Reference]], and users can view examples from others and submit their own at [[foobar2000:Titleformat Examples]].

	== Just text ==		== Just text ==

Aomlives: /* Song information */

2009-04-06T18:27:01Z

Song information

← Older revision		Revision as of 18:27, 6 April 2009
Line 34:		Line 34:
	%title%		%title%

	Actually, the above is a little smarter than just using looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are <code>%artist%</code>, <code>%tracknumber%</code>, <code>%list_index%</code> and of course <code>%title%</code>.		Actually, the above is a little smarter than just using: looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are <code>%artist%</code>, <code>%tracknumber%</code>, <code>%list_index%</code> and of course <code>%title%</code>.

	A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:		A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:

	$meta(title)		$meta(title)


	== Technical information ==		== Technical information ==

MuncherOfSpleens: Fixed a minor spelling error

2008-08-08T23:45:43Z

Fixed a minor spelling error

← Older revision		Revision as of 23:45, 8 August 2008
Line 7:		Line 7:
	This text will be displayed as-is.		This text will be displayed as-is.

	Admittedly, this is pretty boring and you probably will not want to use this on its on. There is one more thing worth noting before we move on to more interesting things. Title formatting code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:		Admittedly, this is pretty boring and you probably will not want to use this on its own. There is one more thing worth noting before we move on to more interesting things. Title formatting code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:

	'These characters normally have special meaning: ( ) , [ ] $ %'		'These characters normally have special meaning: ( ) , [ ] $ %'

DEATH: Foobar2000:Titleformat Introduction moved to Foobar2000:Title Formatting Introduction

2008-05-24T18:32:47Z

Foobar2000:Titleformat Introduction moved to Foobar2000:Title Formatting Introduction

← Older revision	Revision as of 18:32, 24 May 2008
(No difference)

DEATH: Fixed various misnomers, removed outdated/confusing information no longer relevant to current foobar2000 versions.

2008-05-24T18:32:19Z

Fixed various misnomers, removed outdated/confusing information no longer relevant to current foobar2000 versions.

← Older revision		Revision as of 18:32, 24 May 2008
Line 1:		Line 1:
	foobar2000 uses ~~titleformat~~ scripts ~~(a.k.a. '''TAGZ''')~~ in several places. This article will give you a basic introduction to ~~Tagz script~~.		foobar2000 uses title formatting scripts in several places. This article will give you a basic introduction to title formatting patterns.

	== Just text ==		== Just text ==
Line 7:		Line 7:
	This text will be displayed as-is.		This text will be displayed as-is.

	Admittedly, this is pretty boring and you probably will not want to use this on its on. There is one more thing worth noting before we move on to more interesting things. ~~Titleformat~~ code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:		Admittedly, this is pretty boring and you probably will not want to use this on its on. There is one more thing worth noting before we move on to more interesting things. Title formatting code uses some special characters which cannot be used in plain text, but you can use them inside single quotes:

	'These characters normally have special meaning: ( ) , [ ] $ %'		'These characters normally have special meaning: ( ) , [ ] $ %'
Line 30:		Line 30:
	== Song information ==		== Song information ==

	~~Titleformat~~ scripts would be quite useless, if you could not display information about songs. To access the value of the "title" tag, you would write "title" in percent signs:		Title formatting scripts would be quite useless, if you could not display information about songs. To access the value of the "title" tag, you would write "title" in percent signs:

	%title%		%title%

	Actually, the above is a little smarter than just using looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are <code>%artist%</code>, <code>%tracknumber%</code>, <code>%~~playlist_number~~%</code> and of course <code>%title%</code>.		Actually, the above is a little smarter than just using looking at the "title" tag. If the title tag is missing, it will use the filename instead. There are several of this field remappings that are intended to make your life a little easier; among them are <code>%artist%</code>, <code>%tracknumber%</code>, <code>%list_index%</code> and of course <code>%title%</code>.

	A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:		A name written inside percent signs will generally try to look up the tag of the same name, unless it is one of the aforementioned remapped fields. Even in this case you can use the unaltered value of the tag:
Line 40:		Line 40:
	$meta(title)		$meta(title)


	~~== A simple playlist script ==~~

	~~Let's look at a simple script for the playlist:~~

	~~%playlist_number%. %artist% - %title%~~

	This is nothing fancy. It displays the index of the track in the playlist, padded with zeros to make it the same length for all playlist entries. After that comes the artist and the title of the track. However, if there is no artist tag, this will just display a question mark, as it happens with all fields that cannot be found. To avoid this, we can put the part of the script that displays the artist tag in brackets. That way, it will only be displayed, if the tag is found.

	~~%playlist_number%. [%artist% - ]%title%~~

	It would be nice, if we could show the length of a track in the playlist. No problem, the <code>%length%</code> field gives us the song length nicely formatted as minutes and seconds. It will even show hours, if the song really is that long. To make things a little nicer, we will make the length displayed on the far right of the playlist. All we have to do is to include a tabulator character before <code>%length%</code>. The <code>$tab()</code> function will do this for us.

	~~%playlist_number%. [%artist% - ]%title%~~
	~~$tab()~~
	~~%length%~~

	If the song length happens to be unknown, this will display a question mark. That might happen with web streams, and to make this a little clearer, we will display "unknown length" instead. To test if the length field exists, we can use the <code>$if2</code> function. This function takes two parameters. If the first parameter contains at least one valid field, it will return the value of that parameter. Otherwise, it will return the value of the second parameter.

	~~%playlist_number%. [%artist% - ]%title%~~
	~~$tab()~~
	~~$if2(%length%,unknown length)~~

	== Technical information ==		== Technical information ==
Line 69:		Line 47:

	==Additional Reading==		==Additional Reading==
	* [[foobar2000:Titleformat Reference\|Titleformat Reference page]]

			* [[foobar2000:Titleformat Reference\|Title Formatting Reference page]]

	[[Category:foobar2000 Guides\|Titleformat Introduction]]		[[Category:foobar2000 Guides\|Titleformat Introduction]]

Eboomer: Added info about how to add comments (//) to code

2006-12-07T19:34:42Z

Added info about how to add comments (//) to code

← Older revision		Revision as of 19:34, 7 December 2006
Line 23:		Line 23:

	This is the first line. This will stretch (...)		This is the first line. This will stretch (...)

			Comments are achieved by placing '//' at the start of a new line of code. That entire line will be commented out, eg.
			//This is commented and will not appear// this is also commented due to the '//' at the start of the line
			This is not commented and will appear// this and the '//' preceding it will also appear, because there is no '//' at the start of the line

	== Song information ==		== Song information ==