Filename Parser

This module will allow X-Pert Playout to Parse names of files and get information from them. It provides an easy way to use information, included in the file name, without using a database. You can make the most of this feature if you have a standard naming structure for your clips.

In this setting dialog box, you have to “tell” X-Pert Playout how you name files, so it will “know” what certain parts of your filenames mean. The dialog box is divided into three zones – the uppermost zone provides options to write/browse for a sample filename and to set general “parsing rules” – presets; in the middle zone you should “explain” the naming structure by including metadata fields; and in the lower zone you can specify the properties of each metadata field.

For clarification, please, have a look at the following example:

Let us pick a sample filename, like BGMusic-Lime_Biscuit-The_road_to_heaven-live.mpg. Enter the latter name in the Filename field. You could also browse for existing files or choose from the drop-down list of filenames after pushing the arrow button to the right of the Filename field. The drop-down list contains all filenames of the currently loaded playlist.

This is a possible way to name music files – create a preset (let us call it Music):

Push the Plus button, situated to the right of the Active file parser preset field .

A dialog will prompt you to name the new preset. You can rename it later on by pushing the Recycle  button, or delete it by pushing the Minus  button.

Once you have entered the preset name, you can start “explaining” the naming rules. Let us go back to the sample filename – you can see that its structure contains, in order of appearance, an abbreviation (BG), a category name (Music), a separator (-), a name of a performer/star (Lime_Biscuit), another separator (-), a title (The_road_to_heaven), one more separator (-), and a note (live), followed, of course, by the file format. This is what you have to “tell” X-Pert Playout. Here is how:

 

 

In the Metadata options area, use the Plus  and Minus  buttons to add/remove parser fields. You can choose from the available types of fields. In our example, you have to enter one by one:

 Note (it will stand for the abbreviation BG), Category, SEPARATOR, Star, SEPARATOR, Title, SEPARATOR, and Note. If you want to skip some information in the filename, select NONE in the relevant position. Do not forget to set which symbols are regarded to as separators (check the relevant boxes in the lower left corner). Here, exclude the lower dash from the separators list, as it represents the space within the separate fields.

To the right of the Metadata fields list you can see a number of checkboxes that provide some conversion options:

 Convert all underscores to spaces - in our case Lime_Biscuit will become Lime Biscuit.

 Convert all “%20” to spaces is not applicable in our case, but otherwise you can use it for downloaded files (their names often happen to contain “%20” instead of spaces)

 ALL CAPS will turn all letters in the filename to upper case.

 All first caps – capitalizes the first letter of each word in the relevant metadata field

 Capitalize first only – capitalizes only the first letter of the relevant metadata field

 Include letters andInclude numbers are checked by default. If you uncheck some of them, the filename parser will ignore the relevant characters (i.e. will not include them in the field).

You have to set your preferences for each metadata field separately (select it by clicking on it).

Finally, you have to specify the length of each metadata field.

This is not a problem if you choose to name your files with fixed length for each field – check the Fixed length flag and specify the number of characters using the arrows. The corresponding characters in the Filename field will be highlighted in blue, so that you can see your setting.

However, setting variable lengths is a bit more complicated.  Check the Variable length flag in the lower right field and then specify minimum and/or maximum characters to be included in the relevant metadata field. If you have set a Minimum value, but the relevant metadata field contains fewer characters, you will need some Pad symbol to fill-in the gab.

If you have set a Maximum value, but the relevant metadata field contains more characters, you will have to insert a NONE field before the SEPARATOR field, thus, telling X-Pert Playout to ignore the remaining symbols to the separator.

Back to our example, Lime_Biscuit contains 12 symbols. If we set a minimum value of15 symbols and a Pad symbol (*) for the [Star] field, the Filename Parser will display Lime Biscuit*** in the playlist grid. If we set a maximum of 9 symbols for the [Star] field, the Metadata fields list should contain “ [Star], [NONE], [SEPARATOR],” instead of “ [Star], [SEPARATOR]”. You can change the positions of the metadata fields by drag-n-dropping them.

Append at end field gives an opportunity to add characters to the end of a metadata field.

Some fields, like [Title], [Category], etc., are displayed directly in the X-Pert Playout grid.

Others, like [Tape ID] for example, may provide information to SubTitle Plus (www.subtitleplus.com) or SubX-Pert Graphics (see below) for proper display of the corresponding subtitles. When you use the filename parser to display subtitles, you have to create a preset with naming structure [Tape ID] and [SEPARATOR] and the fields’ length should be set to Variable. In the clip’s properties dialog fill in the same Tape ID as that in the subtitle file.

NOTE: In order to use the features of the Filename parser module, you must set it first, and then add files to the playlist. THE MODULE CANNOT PARSE AN ALREADY LOADED PLAYLIST, since it already contains all the metadata for the relevant clips, included in it.

WARNING! If, in the newly-loaded playlist, there is any information in the fields that is also used by the Filename Parser preset, this information will be overwritten!