User:Canar:Titleformat syntax guide - Revision history

Canar: User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: Testing kjoonlee's claim

2006-09-27T14:22:15Z

User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: Testing kjoonlee's claim

← Older revision	Revision as of 14:22, 27 September 2006
(No difference)

Elliottmobile: User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide: Sorry, but what you made was a page for a user named "Canar:Titleformat syntax guide". I could do the same by saying that this is bold and you will not change it

2006-09-25T07:17:37Z

User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide: Sorry, but what you made was a page for a user named "Canar:Titleformat syntax guide". I could do the same by saying that **this is bold and you will not change it**

← Older revision	Revision as of 07:17, 25 September 2006
(No difference)

Canar: User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: There is no reason for you to be changing my methods of namespacing, elliottmobile. Stop meddling.

2006-09-25T00:36:02Z

User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: There is no reason for you to be changing my methods of namespacing, elliottmobile. Stop meddling.

← Older revision	Revision as of 00:36, 25 September 2006
(No difference)

Elliottmobile: User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide

2006-09-24T12:37:34Z

User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide

← Older revision	Revision as of 12:37, 24 September 2006
(No difference)

Canar at 13:34, 28 July 2006

2006-07-28T13:34:06Z

Show changes

Canar: /* Novice Level */

2006-07-28T01:31:55Z

Novice Level

← Older revision		Revision as of 01:31, 28 July 2006
Line 83:		Line 83:
	==Novice Level==		==Novice Level==

	~~So DISCID isn~~'t ~~a common tag~~. ~~Therefore~~, it'd be nice if we can just drop it altogether without leaving an ugly question mark in its place. So, if you'd like to have text displayed only if a field is present, there are ways to do that.		Sometimes, fields don't have contents. In these situations, it'd be nice if we can just drop the field altogether without leaving an ugly question mark in its place. So, if you'd like to have text displayed only if a field is present, there are ways to do that.

	Enter the string:		Enter the string:

	''%artist%[ - %~~discid~~%] - %title''. This will return entries formatted like ''Aphex Twin - ~~1e05c304~~ - Donkey Rhubarb'' if ~~DISCID~~ is present and ''Aphex Twin - Donkey Rhubarb'' if it's not.		''%artist%[ - %tracknumber%] - %title''. This will return entries formatted like ''Aphex Twin - 01 - Donkey Rhubarb'' if TRACKNUMBER is present and ''Aphex Twin - Donkey Rhubarb'' if it's not.

	The little square brackets look inside themselves for a %field%. If that field contains text, their contents will be printed. If that field is empty, everything between the brackets will be omitted. They can be nested for complex scripts, but watch out! Things can get complex very quickly. Be sure you test as you go to make sure things behave as you expect them to.		The little square brackets look inside themselves for a %field%. If that field contains text, their contents will be printed. If that field is empty, everything between the brackets will be omitted. They can be nested for complex scripts, but watch out! Things can get complex very quickly. Be sure you test as you go to make sure things behave as you expect them to.

	~~(insert information about tech fields and non-standard fields here)~~

	==Intermediate Level==		==Intermediate Level==

Canar: /* Beginner Level */

2006-07-28T01:30:16Z

Beginner Level

← Older revision		Revision as of 01:30, 28 July 2006
Line 75:		Line 75:
	Go to the [[Foobar2000:Preferences:Display#Title_Formatting\|Title Formatting page in the Display section]] and select the Playlist tab. This will allow you to change what shows up in the playlist of the Default User Interface.		Go to the [[Foobar2000:Preferences:Display#Title_Formatting\|Title Formatting page in the Display section]] and select the Playlist tab. This will allow you to change what shows up in the playlist of the Default User Interface.

	Enter the string: ''%artist% - %title%'' This is a simple script that will return ''Aphex Twin - Donkey Rhubarb'' as the text representing that playlist entry. In fact, any one of the field names, when surrounded by % characters, will return the text associated with that field.		Enter the string: ''%artist% - %title%'' This is a simple script that will return ''Aphex Twin - Donkey Rhubarb'' as the text representing that playlist entry. In fact, any one of the field names, when surrounded by % characters, will return the text associated with that field. TfS is not case-sensitive.

	As you'd expect then, ''%artist% - %~~discid~~% - %title%'' would return ''Aphex Twin - ~~1e05c304~~ - Donkey Rhubarb''.		As you'd expect then, ''%artist% - %tracknumber% - %title%'' would return ''Aphex Twin - 1 - Donkey Rhubarb''.

	~~That's a kind of useless example though, because most people don't add DISCID fields to their files. So,~~ for playlist entries without ~~DISCID~~ fields, that script will return ''Artist - ? - Title'' ~~or something similar~~. ~~This is kind of ugly, so~~ let's make things a little more complex.		As for playlist entries without TRACKNUMBER fields, that script will return ''Artist - ? - Title''. Now let's make things a little more complex.

	==Novice Level==		==Novice Level==

Canar at 01:27, 28 July 2006

2006-07-28T01:27:56Z

← Older revision		Revision as of 01:27, 28 July 2006
Line 1:		Line 1:
	~~:''This article deals with the simple syntax; please see [[foobar2000:Tagscript]] for info on the script-like syntax.''~~

	So you want to learn how to use foobar2000's titleformatting syntax, eh? Well, then. Because I'm lazy, instead of writing "titleformatting scripts", I'm going to just use the abbreviation TfS.		So you want to learn how to use foobar2000's titleformatting syntax, eh? Well, then. Because I'm lazy, instead of writing "titleformatting scripts", I'm going to just use the abbreviation TfS.

Canar at 01:27, 28 July 2006

2006-07-28T01:27:43Z

← Older revision		Revision as of 01:27, 28 July 2006
Line 3:		Line 3:
	So you want to learn how to use foobar2000's titleformatting syntax, eh? Well, then. Because I'm lazy, instead of writing "titleformatting scripts", I'm going to just use the abbreviation TfS.		So you want to learn how to use foobar2000's titleformatting syntax, eh? Well, then. Because I'm lazy, instead of writing "titleformatting scripts", I'm going to just use the abbreviation TfS.

	==~~Setting Up~~==		==Getting Started==

	I would recommend that while you're learning, you disable the Columns UI if you're using it. Use the Default User Interface, as it will immerse you fully in TfS. Columns UI is very complex, and learning to use TfS to configure it is difficult for advanced users, let alone new ones.		I would recommend that while you're learning, you disable the Columns UI if you're using it. Use the Default User Interface, as it will immerse you fully in TfS. Columns UI is very complex, and learning to use TfS to configure it is difficult for advanced users, let alone new ones.

Canar: /* Setting Up */

2006-07-28T01:27:10Z

Setting Up

← Older revision		Revision as of 01:27, 28 July 2006
Line 38:		Line 38:
	Incidentally, this is also an exceptional track, from a time period when Richard D. James was going from making very difficult, pretentious music to light, accessible music that was as complex as his pretentious efforts. But you probably don't care about that. The real reason I listed all that info is because it is an example of the metadata in a well-tagged file. What "well-tagged" means can often depend on your own preferences. For example, if you don't like the "Total tracks" entry, you don't need to add it to your files, nor do you need to include it in your TfS. You get to pick which tags you want to have on your files. Beware though, some components interact with particular fields and do not allow you to change which ones they use.		Incidentally, this is also an exceptional track, from a time period when Richard D. James was going from making very difficult, pretentious music to light, accessible music that was as complex as his pretentious efforts. But you probably don't care about that. The real reason I listed all that info is because it is an example of the metadata in a well-tagged file. What "well-tagged" means can often depend on your own preferences. For example, if you don't like the "Total tracks" entry, you don't need to add it to your files, nor do you need to include it in your TfS. You get to pick which tags you want to have on your files. Beware though, some components interact with particular fields and do not allow you to change which ones they use.

	Most of the entries in the "Name" column are pretty self-explanatory. "<PLAY COUNTER>" is formatted the way it is because it is a true field name. Here we are encountering one of the new complexities of v0.9. foobar2000 v0.9 hides the true field names from you by default. Instead, it displays what the field is supposed to contain. It will place the true field names in angle brackets ("<" and ">"). At this point, please go to Preferences -> Advanced -> Display -> Properties dialog -> Properties dialog fields. ~~Save~~ the text somewhere else, then delete the text from foobar. For your reference, in case you mess something up, the default is		Most of the entries in the "Name" column are pretty self-explanatory. "<PLAY COUNTER>" is formatted the way it is because it is a true field name. Here we are encountering one of the new complexities of v0.9. foobar2000 v0.9 hides the true field names from you by default. Instead, it displays what the field is supposed to contain. It will place the true field names in angle brackets ("<" and ">"). At this point, please go to Preferences -> Advanced -> Display -> Properties dialog -> Properties dialog fields.

			Now you have two choices. I recommend that you save the text somewhere else, then delete the text from foobar. For your reference, in case you mess something up, the default is

	Artist Name=ARTIST;Track Title=TITLE;Album Title=ALBUM;Date=DATE;Genre=GENRE;Composer=COMPOSER;Performer=PERFORMER;Album Artist=ALBUM ARTIST;Track Number=TRACKNUMBER;Total Tracks=TOTALTRACKS;Disc Number=DISCNUMBER;Total Discs=TOTALDISCS;Comment=COMMENT;		Artist Name=ARTIST;Track Title=TITLE;Album Title=ALBUM;Date=DATE;Genre=GENRE;Composer=COMPOSER;Performer=PERFORMER;Album Artist=ALBUM ARTIST;Track Number=TRACKNUMBER;Total Tracks=TOTALTRACKS;Disc Number=DISCNUMBER;Total Discs=TOTALDISCS;Comment=COMMENT;
Line 66:		Line 68:
	\| <PLAY COUNTER> \|\| 5		\| <PLAY COUNTER> \|\| 5
	\|}		\|}

			Alternately, you can look at that list and convert between the simplified and true field names in your head. This is a little trickier, but it's doable!

			Either way, from here on, I will only refer to the true field names. Forget all that simplified stuff.

	==Beginner Level==		==Beginner Level==

User:Canar:Titleformat syntax guide - Revision history

Canar: User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: Testing kjoonlee's claim

Elliottmobile: User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide: Sorry, but what you made was a page for a user named "Canar:Titleformat syntax guide". I could do the same by saying that **this is bold and you will not change it**

Canar: User:Canar/Titleformat syntax guide moved to User:Canar:Titleformat syntax guide: There is no reason for you to be changing my methods of namespacing, elliottmobile. Stop meddling.

Elliottmobile: User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide

Canar at 13:34, 28 July 2006

Canar: /* Novice Level */

Canar: /* Beginner Level */

Canar at 01:27, 28 July 2006

Canar at 01:27, 28 July 2006

Canar: /* Setting Up */

Elliottmobile: User:Canar:Titleformat syntax guide moved to User:Canar/Titleformat syntax guide: Sorry, but what you made was a page for a user named "Canar:Titleformat syntax guide". I could do the same by saying that this is bold and you will not change it