Yate V3 Release Notes

Version 3.17.4 (6170)

      Please Read This

This is the last planned update which will support OS versions less than 10.9 (Mavericks). This release will now target a different update path for those earlier OS versions. There is no guarantee that there will be further updates for 10.6, 10.7 and 10.8, however, the ability is in place to provide patches. Due to the loss of functionality outside of our control, we have come to this this decision...and not lightly. It's time to upgrade. For those of you who decide to continue using Yate on these older platforms, please be aware that the ability to load actions created by newer versions will not be possible.

      The Main Window

• In order to stop the unnecessary display of the main window when a process finishes, nothing visual is done when the application is active. ie. the main window will not be forced to the front and the dock icon will not bounce. Unfortunately there is no way to reliably bounce the dock icon when the application is active.
• Added a Renumber by Disc toolbar button.
• Added a Calculate Track Count Per Disc toolbar button.
• Artwork panels will display duplicate artwork items when a single file is selected.
• A Help Indexed by Menu Items link has been added to the Help menu.
• Unhandled Frames has been renamed to Unhandled Items.
• The status bar can no longer be hidden.
• The Audio Information panel at the bottom of the File Browser panel now auto-hides.
• Some other minor cosmetic changes.

      Regular Expression Tester

• There is a new regular expression test panel. The functionality can be accessed as a stand alone window from the Actions menu or as a sheet opened from a Regular Expression statement in an Action Editor window.
• You can test all supported regular expression functionality.
• You can set content values for accessed variables and named variables.
• You can view the regular expression and template fields as they are passed to the regular expression compiler. ie. After Yate escaping.
• Matches will be colour highlighted.
• The regular expression and template fields have context menu items to assist with the most common regexp sequences.

      TheMovieDB Importer

• You can now optionally synthesize the EpisodeID (eg. S01E12) for TV shows.

      WAV Files

• WAV files have an alternate tagging scheme to the suppported ID3 specification. A small number of tags may be specified in a LIST-INFO chunk. Yate always wrote the Album, Artist, Title and Year tags to this construct to support those applications which do not handle an ID3 chunk. The Comments, Copyright and Genre metadata is now written as well. Further, Yate will now read any of the previous fields if non empty and there is no in place ID3 data or if the ID3 chunk is not present. Yate will also preserve any unhandled metadata that it finds so that it can be put back when the file is written. These unhandled items have a description field which starts with LIST-INFO:xxxx where xxxx is the name of the unhandled item.
• When logging verbose raw file contents, the contents of the LIST-INFO chunk will be displayed.

      Action Manager

• The Action Manager has a new Log Action Usage context menu item. The Log Viewer will contain a list of all actions describing the actions called and those that call them.

      Action Editor Windows

• There is a new context menu item called Save Changes then Run Action.

      Action Statements

• You can now specify that the Run statement should execute only for those selected files which have a specific variable whose value is true.
• The Compare Date Test, Compare Numeric Test and Compare Text Test statements can all now save individual per file test results to a variable. When executing in stepwise mode the the action test state will still be set to the combined test result as documented. Having the individual test results saved to each file allows you to use the new Run statement option to limit which files get processed based on a condition.
• The Make Numeric statement can now save a field as a boolean or negated boolean value. While true is interpreted as being any non zero value, there may be times when you want the value to be 0 or 1.
• There is a new action statement called Logical Set. While the Compare Date Test, Compare Numeric Test and Compare Text Test statements can all now save individual per file test results to a variable, there are many other statements which can set the action test state. The Logical Set statement allows for pretty much every logical operation that exists. The statement can perform its logical operations on the Action Test State, Variables and named variables.
• The Transfer Metadata statement's semantics for Unhandled items has been changed. If you transfer metadata between files of different types and you are transferring Unhandled items, the Unhandled items of the destination file will be cleared. This makes more sense than simply ignoring the transfer and retaining the previous items. This makes it far more convenient to transfer metadata and clear Unhandled in a single operation.
• New action statement Clear User Defined Items by Source. The statement can clear all user defined data (text items and urls) associated with any combination of metadata sources: AcousticBrainz, AcoustID, AutoSearch, and nine other sources.
• The Scale Artwork/Change Type statement has been renamed Manipulate Artwork. The restriction that an artwork item must be converted to a PNG image in order to square it has been removed. The statement now also allows for the setting of an image to greyscale.
• The following artwork statements now support their functionality or testing by file index, a picture type or description: Artwork to Folder, Manipulate Artwork, Rearrange Artwork and Remove Artwork.
• New action statement called Duplicate Artwork. This is useful if you want to perform some sort of image transformation on an item which is kept disjoint from the original.
• Copy Unhandled and Clear Unhandled now have the same extended matching criteria. The four character pattern limit has been removed in order to handle the new WAV LIST-INFO unhandled items.
• The Regular Expression statement has a new test interface. The statement's expression and template fields have context menu items to assist with the insertion of the most common sequences.
• New escape sequence \> inserts an integer value representing the current time in milliseconds since Jan 1, 1970.
• Repeat For statements were not being updated when a called action was renamed.
• Repeat For statements were not being processed by the action usage logic.
• The Access Discogs and Access Musicbrainz statement UI was messed up if there was more than one in a single action which specified the Custom option.
• Comments and Lyrics in FLAC files can now start with a { character. The FLAC handler is smarter in determining the presence of secondary comments and lyrics.
• Fixed a memory leak in the Load and Run statement.

Version 3.17.3 (6096)

      Main Window

• The File menu's Close Files, Hide Files and Select Files submenus now have additional canned filtering options. The main window's equivalent context menu submenus have the same options. The context menus have additional options which process their functionality based on matching, or not matching, the contents of a clicked column's data. By default these menus now all process multiple data points. For example Close Files in the Same Folder will close all files in the same folder as any selected file. In the context menus the Option (Alt) key can be used to change the functionality to apply to only the clicked row.
• The Show All Files menus have a new Add at the End item.
• The table header's context menu has a new sort option called Selected First.
• The Movement Number/of field on Custom panels has had its label field lengthened so that the default name is Movement as opposed to Mvt.
• Added a Media Type column.

      Font Resizing

• You can now reize the font used in the Snapshot window.
• You can now resize the font used in the AcoustID Recording Information Window.
• You can now resize the font used in multi line text fields. Note that unless noted otherwise, all multi line text fields share the same font size.

      Rename and File to Tag Templates

• The templates have four new tokens: Work Name, Movement Name, Movement Number and Movement Number - Roman. In a Rename template, 'Movement Number - Roman' takes the decimal numeric field and writes it as a Roman numeral. In a File to Tag template 'Movement Number - Roman' reads a Roman numeral and saves it as a decimal integer to the field.
• File to Tag templates can be used on a new action statement called File to Tag from Content. This uses a template to extract fields from other fields or named variables as opposed to from the file path.
• All Rename template property reference tokens have been moved to a new Properties submenu.
• Rename templates have new Bit Depth, Has Video and Stream tokens. To enable the testing of existence, the Has Video property returns Video for True and empty for False.
• There is a new Rename property token called File Type. It inserts the uppercase filename extension.
• There is a new conditional Rename template token called IfMultiDisc. The token tests if a file is part of a multi disc album. The test returns true if either of the Disc or Disc Count fields are greater than 1.
• There is a new conditional Rename template token called IfCompilation. The token tests if the Part of a Compilation field is non zero.
• Rename templates have a new setting to specify that you want accents to be removed from characters.

      Involved People, Musician Credits and FLAC Files

• Musician Credits and Involved People metadata is written in a format, which while not a standard, is as close to a standard as exists for FLAC files. If you want to preserve the two fields exactly as entered you should set the When loading files do not sort the Involved People and Musician Credits option. However, this setting may not help if an application other than Yate rewrites the file and its contained tag information. This is due to the fact that as opposed to other supported audio formats, FLAC files encode the credits as multiple FLAC Comments. There is no guarantee that the order of the credits in the file will be maintained by other applications.
  
  If you always want the data to be reloaded as displayed, there is a new Preserve exact appearance of Involved People and Musician Credits setting. This setting does not affect the standard writing of the metadata. What it does is cause additional tag items to be written which preserve the metadata as displayed. When reading FLAC files and the option is set and the additional tag items are present in a file, the as is metadata will take precedence over the standard metadata. The additional tag items are not written if the associated metadata is empty. Note that the fields always have leading and trailing spaces and newline characters removed. Further all control characters are removed and newline sequences are normalized. When the 'Preserve exact appearance' option is set, and the special tag items are present, Yate will ignore and toss subsequent changes made by other taggers to non empty Involved People and Musician Credits fields.

      Beatport Importer

• The Filename/Path column has been separated from the Title column so that a track's title metadata can be displayed.
• The tables's column headers have a new context menu supporting various autosizing functions.

      Database Viewers

• Images are now cached as thumbnails as opposed to being cached full size. This can drastically reduce the memory footprint of an open database file. If an image is displayed in the Artwork Viewer it is loaded on the fly.
• Double clicking in a cell in a Yate Album ID column is the same as 'Show Album in Track DB'.

      Escape Sequences

• There is a new escape sequence \L. The sequence disables subsequent processing of escape sequences in the string. If you require text which contains \ characters, it may be far simpler to precede the text with a \L rather than change every \ character so that it is not escaped.

      New Action Statements

• There is a new action statement called Remove Invalid Characters. This is a convenience method which duplicates the Yate Transformations>Remove Invalid Characters functionality.
• There is a new action statement called File to Tag from Content. This statement allows you to apply a File to Tag template to the content of a field or named variable.

      Action Statement Changes

• The Enumerate Tag Sets statement has been renamed Enumerate Tag Sets and Fields. The statement has new options to produce lists of Yate field names representing all possible fields or various subsets.
• The Regular Expression Statement allows for the processing of \v and \<named variable> sequences. Previously the inserted text was always treated as being literal and all regular expression escape sequences were escaped. You can now specify that the inserted text is not to be automatically escaped. This is useful if you are inserting the actual regular expression from a variable or named variable. See the online help for more information of the some potential issues and how to avoid them.
• The Make Numeric statement now supports converting from and to Roman numerals.
• The Extract Preference Set statement now supports the extraction of the File to Tag, Rename and Search template lists.
• All action statements which take File to Tag, Rename or Search templates now support the manual entry of the template (in addition to choosing templates from a list). The template fields now support escape sequences. This means that specific templates can be assigned at runtime.
• The Renumber Tracks statement now has the from... and random functions found on the Actions>Renumber Tracks submenu.
• The Calculate Track Count statement has the new Absolute and Maximum functions.
• The iTunes Import Base Settings functionality will also import the following fields for iTunes video content: Episode, Episode ID, Season, Show Name, Sort Show Name, Video Description.
• The Copy Metadata Between Files statement now supports the setting of all fields. This setting can insulate you from the possible addition of new fields in the future.
• The Transfer Metadata statement now supports settings to specify the transfer of all metadata with or without Unhandled fields. There is also a new run once option.
• The User Defined Fields statement now provides access to Lyrics. The statement now allows you to set a description to empty.
• The Field List Enumerator statement now provides access to Lyrics.

      UDTIs

• The following additional UDTIs are now normalized across all supported audio types: MusicBrainz Album Artist Id, MusicBrainz Artist Id, MusicBrainz Disc Id, MusicBrainz TRM Id, MusicBrainz Work Id.

      Bug Fixes

• APFS on High Sierra seems to report minuscule time differences on a file's modification date/time when it is not appropriate. Yate uses these values to determine when a file has been externally modified. A ridiculously small threshold has been added which seems to fix the issue of redundant warnings.
• Fixed an issue with changing the font size in the LogViewer on High Sierra.
• Various other High Sierra UI tweaks.
• The Append and Prepend statements were missing a space in the display for certain option configurations.
• The Search for Artwork statement's Continue option could cause extraneous URLs to be issued.
• The Rename template Video Definition token was not correctly mapped.
• Album Database Max Rating and Average Rating fields were always displaying integer values.
• The Run Application statement was discarding the Open With option if an action containing the statement was re-opened in an editor.
• If you exported then imported a track's metadata, it is possible that multi item fields with a default item (such as Comments), were duplicated. Note that the exported files are fine. The issue was with the import.
• Regardless of the fields chosen to be copied, the Transfer Metadata stament will no longer copy Unhandled items unless the source and destination files are the same audio type.
• When displaying a list of tokens starting with a letter in the Replace Template editor, the list was not always sorted.
• Video fields are no longer displayed in a Snapshot if the file does not contain a video track.
• The User Defined Field statement no longer removes trailing spaces when matching prefixes.
• The Repeat For statement was not testing the stop condition before the first iteration.

Version 3.17.2 (6021)

      iTunes Support

• Added support for reading and writing the iTunes Remember Playback Position option.
• The data is stored in a new field on the audio panel called Remember Position. While in the Audio panel, the setting applies to any linked iTunes item including videos.
• The field is only available in audio file types which can be stored in iTunes. ie. DFF, DSF and FLAC are not supported.
• iTunes preferences can specify the display, auto-import and auto-export of the setting.
• The Import from iTunes and Export to iTunes action statements provide support for the new field.
• The field is available on Custom Panels.
• The field can be displayed in a main window column.
• The field can be filtered.
• The field can be exported to a database.
• The field is accessible on the Compare iTunes Values panel.

      MP2 Files

• Files with an .mp2 filename extension will now be loaded. The files are treated as mp3 files. The Stream property will identify the files as MPEG-1, Layer 2 as opposed to MPEG-1, Layer 3 for mp3 files. With the exception of the reported stream type, all help references to mp3 include mp2.

      Character Folding

• Character folding of various Unicode characters to their ISO Latin-1 common usage is performed by:
  • The Re-encode statement's Fold Characters function.
  • The Re-encode statement's Force ISO Latin-1 function.
  • A rename template's Force Latin-1 option.
  Previously the substitutions were hard coded.
• You can now create a replacement set in Preferences-Replacement Sets and mark it as the Fold Character set (F). A set with the default values can be built with the Create a Set With the Default Fold Character Values context menu item.
• The formatting rules and interpretation of the set is accessible in the Re-Encode statement's, Preference Replacement's and Preference Replacement Template's online help.
• The name of the Fold Character set can be extracted by the Extract Preference Set statement.
• The set used as the Fold Character Set can be modified at runtime by the Preferences statement.

      Multi-Item Editing Panels

• The Show Initial Values and Show Editing State Values controls are now enabled when no files are selected.

      Action Statements

• All escape sequences which indirectly load a field and the Set Indirect statement now ignore convenience qualifiers on Custom fields. This is to facilitate using the field names as returned by an Enumerate Tag Set statement.

      Fields

• The previously ID3 only, Music CD Identifier field has been extended to MPEG-4 and FLAC files. The coercion to hexadecimal content is only enforced when saving to ID3 based file as the low level representation is binary.
• The Music CD Identifier and Reverb fields are now available from the Insert Yate Field menus. This is for consistency reasons. At this point only those fields which can have multiple items and do not have a default placeholder are omitted.

      Bug Fixes

• A few High Sierra UI tweaks.
• The Get iTunes Value action statement had some mismatched indexes between the UI and the appropriate data.
• When Re-Encoding to ISO Latin-1 (rename or Re-encode statement), no folding occurred if all characters originally were Latin-1. v3.17.1 started folding ISO Latin-1 grave and acute standalone characters.
• Fixed a few more disabled menu items messed up in v3.17.
• Fixed a crash on the UD Text panel which was data dependant.
• The Exists statement did not always correctly report that Terms of Use, Official Artist/Performer Webpage, and Commercial Information Webpage items were empty.
• The Artwork panel displays less items when Show Initial State and Show Editing State are both enabled. Initial/Editing states should only show items not current.
• Now do a better job of not sorting or merging credits (Involved People and Musician Credits) when loading files.
• Preferences-Tag Lists was constantly removing the selection whenever the state of a tag item was changed.
• The relatively new Actions menu Database ID menu functionality was not checking for changes to the files after performing the function.

Version 3.17.1.2 (5973)

• Same regression: One bug, two patches....argh!!!!

Version 3.17.1.1 (5972)

• Regression: Some context and table header menu items were incorrectly disabled.

Version 3.17.1 (5971)

      Databases

• Previously, the only column types which had a somewhat graphic rendition when written to a database were those associated with Ratings. These columns had a value displaying a number of stars or asterisks depending on the encoding. This made it difficult to access the data when the databases were opened in other applications. The ratings fields are now written as integers in the range of 0 through 5.
• Both the old-style and new-style ratings columns are interpreted correctly by Yate and synching will still work as before.
• There are new Preference-Database options to set the display of Ratings, Love and boolean columns. These options are applied when the columns are displayed. When editing the columns, the associated numeric values will be displayed. Using these options you can display stars for Rating, hearts for Love and checkmarks for boolean columns. Alternately, you can choose to display the numeric values.
• The Rating column is now an editable field. The 'Set Rating' context menu item has been removed as the column is now the same as any other editable column. You can edit, apply to multiple rows, etc.

      AcousticBrainz

• The Access AcousticBrainz action statement previously only allowed you to import BPM and Initial Key values. The AcousticBrainz database also provides extensive classification data. You can now save all or a subset of the classification data to a variable and/or the file as a key-value list. You can extract whatever values you wish.
• The online help provides the key and value names (which have been sanitized) and samples showing how to extract data.
• Sample actions are available on the resource page which display the saved classification data in a variety of ways.

      Notifications

• Previously when Yate finished processing certain functions such as loading files, saving, etc., the main window was always brought to the forefront and activated. This can be annoying if you are working in another application. The previous behaviour will not change when Yate is the active application. When not the active application, Yate will bounce the dock icon. Some people find bouncing dock icons annoying. If you wish you can limit the bouncing to occur only when Yate is not onscreen by setting a new option in Preferences-General-Configure Notifications and to bounce repeatedly or only once. You can also elect to not bounce the dock icon and to use the previous behaviour.

      Miscellaneous Changes

• Save statements (UI and actions) set a new file property called Save Error. (1 for error, 0 for no error). The property can be used to test if a Save successfully completed.
• When filtering files you can now test for Save Error and Cannot Locate.
• A much stronger attempt is made to preserve the file selection when filtering, closing and hiding files in the main window.
• The File and context menus have a new Validate Locations item. If files cannot be located by the OS after they have been externally moved or deleted and then they are restored, you can use this function to re-validate the locations.

      Action Statements

• The Test Property statement can test the new Save Error property.
• The Preserve Modification Date/Time when Saving Audio Files option has been moved from Preferences-General to the Audio-Common panel.
• The Replace statement can now operate on individual items in a list.
• The Find and Remove statement can now operate on individual items in a list.
• Found a few more Unicode characters to fold via Re-Encode-Fold Characters. The list of folded characters is now documented.
• The Extract Preference Set statement can now extract the name of the special Case and Rename replacement sets.
• You can now manually enter a replacement or exception set name in the Preferences statement. This was done so that set defaults can be assigned to saved values.
• The Transfer Metadata statement has been extensively modified. The statement is now supported when running stepwise. The metadata being transferred can be customized. Property lists can and should be saved to a variable. Saving the property list to a named variable has been deprecated. The ability to save imported metadata to the initial as well as the current values has been removed. When saved to the initial values there was no way to determine if the file had been modified or if changes had occurred.

      The Edit>Find Menu

• The main window will now display the Filter panel for the Edit>Find>Find... menu item. Find>Jump to Selection, will attempt to center the first selected item.
• Database viewers now tie the Find menu items to the displayed search field and its associated controls. Find>Jump to Selection, will attempt to center the first selected item.
• In Action Editor windows, Find>Jump to Selection, will attempt to center the first selected statement.

      Behaviour Changes

• When running an action the Save statement's processing of 'For all files' when external modification is detected did not work while executing grouped. This is due to the fact that when running grouped there is only a single file in play. The semantics and the message have been changed to 'For all files until the action finishes'.
• When running an action and a Save fails, closing the files is no longer a user choice.
• The Rename statement notifies on file location changes and had the same 'For all files' issues as the Save statement. Equivalent changes have been made.
• The Show in Finder, Show in Path Finder and Display in File Browser commands will now work from the context menu even if the main window is not active.

      Bug Fixes

• Fixed a few weird ones involved with properly handling the external change of folder names.

Version 3.17 (5921)

A lot of work has been done on iTunes integration. Support has been added for iTunes style Loves and Dislikes. You can now prefer Permanent IDs (PIDs) when linking and fall back to metadata matching if they are not available. PIDs and Love metadata can be imported and exported. The Compare iTunes Values functionality now handles all special import/export metadata.

The are also extensive changes to how the Editing state is set and maintained.

      iTunes Changes

• The More Info editing panel has a new control to display and edit the new Love field. Clicking on the control changes the value from not set to Disliked to Loved. Note that this field can be used with or without iTunes interaction.
• A new main window File List column, Love, is available. Double clicking in the Love column displays an abbreviated menu to choose the various values.
• The main window has a new Ratings context menu to set star ratings and love/dislike ratings.
• The Compare iTunes Values functionality now handles all metadata which can be imported and exported. The Classical metadata can be imported as individual items as opposed to being grouped as with the standard Import from iTunes and Export to iTunes functionality.
• Preferences-iTunes settings have been split up into General, Fields of Interest, Auto Import and Auto Export tabs. Auto Import and Auto Export support Love/Dislike and Permanent ID
• Preferences-iTunes has a new option named Prefer PIDs When Linking. When this option is set, all Link to iTunes functionality will use retained PIDs for linking, if available. If the PIDs are not available, linking by metadata will take place.
• The Import from iTunes and Export to iTunes action statements have been updated to support Love and PID choices.

      The Editing State

• Yate has always maintained an editing state which is basically a snapshot of the selected files' metadata. In the past the state was reset when file selection changed or an action terminated. The editing state is now only reset when file selection changes occur, files are saved or files are refreshed.
• There is a new Preferences-File List option called Preserve Editing State. When the option is set, an editing state is only automatically set when a file is selected and it has not already had an editing state set. Further, the editing state is never automatically cleared. So, you can in effect restore to the editing state even after saving the files.
• There is a new Preferences-File List option called Set Editing State Before Running an Action. As the name implies, this action will cause the automatic setting of the editing state whenever an action is run.
• The Edit menu Undo Changes item has been renamed Revert to Editing State which more accurately describes what is about to happen and better aligns with the individual field functionality available on the function buttons to the left of each field.
• A new Edit menu item named Update Editing State is now provided. This provides a means of manually updating the editing state. ie. setting a new Revert to Editing State point.
• There is a new toolbar icon for the Update Editing State functionality.
• The Log>Changes item has been renamed Log>Changes to Initial State. A new item called Log>Changes to Editing State will let you see the changes between the current and editing states.

      Credit Formatting

• In Preferences-Audio you can now control the initial display of the Musician Credits and Involved People fields. You can select the desired sorting (or none) and elect to merge or not merge names with the same credit to a single item.
• When formatting credits from the Musician Credits and Involved People field's function buttons, you can now choose to merge or not merge names with the same credit into a single item.
• The Format Credits action statement now allows you to merge or not merge names with the same credit into a single item.
• When configuring the behaviour of the Combined Credits Editor in Preferences-File List you can now elect to merge or not merge names with the same credit into a single item.

      Databases

• You can now add a note to a database file.
• The Love/Dislike metadata can be exported.
• The row size of a database viewing small thumbnails has been slightly increased to allow for larger fonts when changing the font size.
• When creating databases and the Preserve sidecar option is set, the sidecar is only preserved if the column layout of the new database is identical to that found in an existing sidecar file. Starting in this release, if the option is enabled, visual aspects and the note contents will be preserved even if the column layout differs.
• When exporting Export Sets and creating databases from the UI, the file chooser's configuration panel will contain a Preserve sidecar option where appropriate.
• You can now potentially change a database type. You can always change a Track or Album database to be Standalone via the viewer's context menu. Depending on the fields in the file and their encoding in the sidecar file, you may be able to change a Standalone database to be a Track or Album database. Warning: Standalone databases have no restrictions on editing fields. Any data can be placed into any field. Be careful when changing from a Standalone database to a Track or Album database.

      Importing PDF Files as Artwork

• When dragging in PDF files you can now choose to scrape the file for the first artwork item or to render the first page at a supplied dpi resolution. This is configured in Preferences-Artwork.

      Main Window

• The Actions menu has a new item to create Yate Track and Album Database IDs.
• The Actions menu has a new item to copy a Unique ID to the clipboard.
• When creating or editing a UDTI, there is now a picker control to choose common names.

      Other Preference Changes

• The ID3 specification allows for the marking of the tag format as Experimental. Previously Yate did not load these files. You can now choose to not load, load the file ignoring metadata or to ignore the Experimental Indicator and load the file as if it was not present. This is configured in Preferences-Audio-ID3.
• Items common to Audio-MPEG 4 and iTunes-General are now displayed in both sections.
• The deprecated setting Do Not Normalize UDTIs has been removed. It was far too error prone when editing, which was why the normalized mappings were introduced in the first place.
• If a default action has been specified in the Action Manager, it will be run whenever files are dragged to the dock icon or opened via the Finder's Open With command. You can disable the running of the default action if Yate is already open via the new Preferences-Actions Only Run the Default Action if Yate is Not Already Open setting.

      Online Data Sources

• In the Discogs and MusicBrainz wizards' Release Detail display the track listings table now has a Time (ms) column. Note that this column will be empty if the data is not available.
• In the Beatport Importer, when a Track Id is imported, Yate will also set the appropriate UFID where expected by Beatport Pro.
• In the Beatport Importer, when importing the Track Id, the 'Only if empty' option is treated as 'Only if empty or value differs'.

      Audio Properties

• A new property called Stem Data is available. The specific read-only metadata available in a Stem file can be viewed in a snapshot or by double clicking on an audio properties table. If you wish to manually parse the data, you can extract it via this property.

      Action Statements

• The Database ID statement can now create Track and Album IDs in the same statement.
• The List Manipulate statement has new Common Prefix and Trim Spaces functionality.
• The Copy and Move statements no longer consider the source and destination being the same as an error. ie. the paths are returned in the Retained Path 1 and Retained Path 2 properties.
• The Move Non Audio statement now supports the renaming of items being moved.
• There is a new convenience escape sequence \Y4 which inserts the value of the Year field formatted as YYYY or empty.
• There is a new convenience escape sequence \YY which inserts the current year.
• The Date Functions statement now treats an empty source named variable field as the current date/time.
• The Prompt for Text statement can extract a picker list from the Prompt for Text List named variable. Previously the list delimiter had to be the default list delimiter (\~). In order to make data entry easier, a newline character (\n) will now also be recognized as a delimiter.
• New action statement named Quit. As the name implies, an attempt will be made to close the application. All loaded files are closed discarding changes.
• New action statement named Crop Image. When you have some method of pre-determining left, right, top and bottom offsets, you can use this function to crop an artwork item at a specific index.

      Action Manager

• When doing a Smart Export, if a prefix pattern is supplied and it does not end with a - one will be supplied.

      Bug Fixes

• A few display problems when running on Snow Leopard have been corrected.
• When attempting to match Media Type names to known iTunes equivalents, trailing newline characters (as well as whitespace) are now removed.
• The Get Next Line statement was not returning the last line if it was not terminated.
• Actions>Copy Selected Metadata did not open its panel if Copy Metadata Top to Bottom or Copy Metadata Bottom to Top was called first.
• FLAC items which map to Involved People Items will now display with the correct alias name.
• Regression: the Disc Of Calculation functionality was messed up in v3.16. Check any actions which use the statement as settings were not always retained correctly.

Version 3.16.2.3 (5839)

• The 3.16.2 update to search templates broke the reading of the really old search templates which used an * as opposed to a metadata token. Unfortunately, the built in templates used the older format.

Version 3.16.2.2 (5838)

• Fixes for some embarrassing broken help links in the Getting Started topic.

Version 3.16.2.1 (5837)

      Regression

• v3.2.16 introduced a timing issue in URL rate limiting.

Version 3.16.2 (5834)

      Search Templates

• To ease the formulation of complicated URLs where the search metadata may be positional or possibly may not be contiguous, new tokens have been added. When the older Metadata token is used, the metadata type selection checkboxes are used. The new Album, Album Artist, Artist, Composer and Title tokens ignore the metadata type checkboxes.

      Rename Templates

• There are two new rename template tokens: Disc Smart Pad and Track Smart Pad. These tokens will pad the values with leading zeros based on the value of the associated Count fields. eg. if Track is 1 and Track Count is 9, 1 will be used. If Track is 1 and Track Count is 10, 01 will be used.

      Export Sets

• Variables 0 through 9 can now be specified in an export set. This is to facilitate the export of constructed fields as a column.
• Once exported, the columns containing variable fields are essentially treated as Out of Bounds columns. ie. they will not sync.

      AcoustID

• AcoustID functions now share the MusicBrainz preference settings for combining multiple items, an overriding join sequence and comma substitution.
• The AcoustID Import Track Metadata statement has a new Custom mode. Using this mode you can prioritize various criteria which will be used in the match selection process. There are many criteria items which can be specified. You can also specify a max audio duration difference value. See the online help for more information.
• The AcoustID Import Track Metadata statement can now import Album Artist metadata.
• The AcoustID Import Track Metadata statement can now read a special named variable in order to override a tracks' duration. This is only necessary where AcoustID data is being retained and later loaded into arbitrary files for lookups.
• The Extract Earliest Release from AcoustID statement has an new Ignore compilations option.
• The Create AcoustID Fingerprint and Get Data from AcoustID statements have a new Ignore errors option. This option stops the posting of errors to the UI.
• The AcoustID Metadata for ID statement has a new Extended mode. This mode returns detained information representing the entire set of data returned by AcoustID.

      Bit Depth Information

• There is a new Bit Depth property which returns a track's bit depth when meaningful. If bit depth is not meaningful, mp3 and m4a(AAC) files, the empty string is returned. Note that the bit depth was previously returned at the end of the Channel Mode property. For now, this has not been changed in order not to break any actions that were written to extract the bit depth from the Channel Mode property.
• There is a new file list column named Bit Depth.

      Action Statements

• The Contents of Folder statement's return files mode now supports the filtering of results by filename extensions.
• The Compare Text Test statement fuzzy mode can now be configured to perform a non positional test. eg. John and Bill will match Bill and John. See the online help for more information.
• The Stop Action and Open Files statement has a new option named Close all visible files discarding changes first. While you can modify the Open Mode via the Set Open Mode statement, there are times when doing so may not give you the ability to close all open files depending on which Open Mode you wish to use. As the option name implies, all changes to the previously open files will be lost. If you wish to preserve modifications, execute a Save statement first.
• You can now override the free space padding in the Preferences statement.
• The Access Query Database statement can now import columns of data.
• The List Manipulate statement can can create a key-value list from two lists.

      Tab Characters and Blue Text

• Tab characters no longer display as invalid (blue) in multi line text fields.
• The Trim action statement and the Multi Line Editor's Trim function no longer remove tab characters when the Control set is specified. You can replace tabs with spaces by using the Whitespace set with the Change Sequences to option.
• Depending on the source field, the Yate Transformation of Remove Invalid Characters will either leave tab characters unmodified or will change them to a space.

      iTunes and Audiobooks

• For some unknown reason, the metadata supplied when dragging audiobooks out of iTunes is different than that for every other media type. Further, some required linkage information is missing. In the past this meant that you could not drag audiobooks into Yate from iTunes. This release has a workaround.

      Database View Options

• There is a new View Options context menu item which allows you to set the background style/colour and grid options. These are per database settings and override the new Preferences-Database settings which are used as default values.

      Online Help

• By default, Yate's online help is displayed in your Mac's default browser. Certain browsers do not always force newly opened pages to the forefront. If this annoys you, you can force the opening of online help in Safari which does force the opened pages to the front. Note that the new setting only modifies the behaviour when opening embedded content. The new setting is available in Preferences-General and on the Help menu.

      Preferences

• Minor rearrangement of the AcoustID, Discogs and MusicBrainz preference sections.
• New Database settings for background style/colour and grid options. These settings establish the default display settings.
• There are now four more canned colour options for an Action Editor window's statement list background.

      Bug Fixes

• If an mp3 file was marked as a podcast, changing to any other media type was not recognized until the file was closed and reopened.
• When choosing a display background colour, the text colour will now be changed to white, if required, to increase visibility.

Version 3.16.1.1 (5780)

      Bug Fixes

• Fixed the issue in Preferences-Exception Sets where the set selection would be cleared when changing the content.
• The Access MusicBrainz statement could hang the Batch Processor, depending on the items being imported.

Version 3.16.1 (5779)

      Saving Files

• You can now specify an action to be executed prior to saving files via File>Save (or shortcut), the context menu Save item, or by the Save toolbar icon. The action is specified in Preferences-Actions. See the new Automatically Running an Action When Saving Files help topic for more information.

      m3u File Support

• m3u and m3u8 files can now be opened in Album mode as well as Playlist mode. When opened in Album mode, folder expansion is suppressed and the sort order is not preserved.

      Discogs / MusicBrainz Support

• The preferences for both wizards have settings to control the automatic substitution of commas in people oriented fields when importing. You can elect to leave commas unchanged, to substitute commas with alternate commas (visually the same) or to replace commas with smart spaces (only inserted if required as delimiters).
• ISRC values can now be imported from MusicBrainz.

      Renaming

• The maximum path component length in the HFS file system is 255 decomposed UTF16 character positions. Unfortunately this is not guaranteed to represent 255 visual characters. The rename template IfLength and Truncate tokens now take negative parameters. When a negative parameter is specified you are testing for decomposed UTF16 character positions as opposed to character counts.
• The Truncate action statement also supports negative lengths so calculations can be made in actions.

      iTunes Support

• New preference settings to display/auto import/auto export Media Kind. Media Kind is mapped to the Media Type field. When setting the media kind, any value other than one of the following is ignored: Audiobook, Alert Tone, Booklet, Home Video, iTunesU, Movie, Music, Music Video, Podcast, Ringtone, TV Show, and Voice Memo. iTunes will refuse to process some settings. For example you cannot change the media kind of a video file to be Music.
• The Import From iTunes and Export to iTunes action statements support Media Kind.

      Auto Search for Artwork

• The algorithm has been tweaked yet again. Better matching is done against albums with somewhat generic album names such as "Best of".
• You can now configure the algorithm, to treat Album and Artist metadata with equal priority. This is the new default value.
• If you wish to prioritize one metadata type over another you can still do so.
• The Multiple Searches option has been removed.

      Action Statements

• There is a new action statement called Get iTunes Value. Every time Yate accesses a track in iTunes it retains those values which may be imported or exported. This information is disjoint from the information stored in fields. When Yate imports from iTunes these values serve as the information source. When Yate exports to iTunes, this information is refreshed. Using this statement you can obtain the values contained in iTunes the last time it was accessed.
• New escape sequence to insert the Yate version string (\?yv)
• New escape sequence to insert the iTunes version string (\?iv)
• The List Contains Test statement can now specify equals, contains, starts with and ends with.

      WAV Files

• WAV files have an alternate method of storing an ISRC value outside the bounds of the ID3 metadata. If you wish to read and write this data (EBU Tech 3352) set the Preferences-Audio-ID3-Process axml chunks for ISRC (WAV only) option. When set, the out of bounds metadata will be read and written. If the two values differ, both will be displayed. Note that an incorrectly formatted ISRC value will not be written to the axml chunk. A loose validation of the ISRC field is performed based on individual character types and length (dash characters are ignored and removed).
• Added support for WAV-RF64 files.

      Databases

• In Album databases which have a Yate Album ID column, there is a new context menu item named Show Album in Track DB. The process either opens a specified default Track database or looks for an open Track database which also contains a Yate Album ID column. An attempt is made to filter the referenced Track database's display to only show tracks contained in the selected album.
• There is a new Preference section called Databases. This new section has an option to specify a default Track database. The image source for Database files setting has been moved from Preferences-Artwork to the Database section.

      About Panel

• The About panel can now save the version information to the clipboard.

      Column Sizing

• The main window and all Database Viewer windows now have Downsize Column and Downsize All Columns options. Often columns which become too large are difficult to manage. This is especially true if attempting to resize the rightmost column. Note that not all columns will be resized.

      Bug Fixes

• Hitting Cmd+S rapidly could cause the Save code to reenter and crash.
• If the Batch Processor was started while the Preferences window was displaying a sheet, preferences functionality was lost upon completion. A restart of the application was required.
• The Path Finder application support was broken. This was due to AppleScript issues. The functionality no longer uses AppleScript.
• If all artwork was exported from the Discog Wizard's artwork view, the saved files were named with a MusicBrainz prefix.
• The File menu items for Show in Finder and Show in Path Finder were not working with Database files. Context menus worked as expected.
• The File menu Display Folder in File Browser item was always hidden.
• After linking to iTunes, if an auto import occurred, the editing panels were not always being updated.
• Changing the state of Classical Metadata in any of the three iTunes Preference sections did not take effect until the application was restarted.
• Changing the Preferences - MusicBrainz Alternate Server setting multiple times could cause the application to crash. Note that changing this setting only takes effect the next time the application is started.
• Fixed a potential crash in Close files Not Selected when some of the files to be closed had been modified.
• The Combined Credits Functions action statement was broken when Process Simple Credits was enabled.
• Show Discogs Release was mangling the URL.
• When cropping images, switching from Fine Tune mode to Square mode, did not always display the correct slider.

Version 3.16 (5738)

      Combined Credits Editor

• The Combined Credits Editor, or CCE, is an attempt to make it easier to edit Involved People and Musician Credits across tracks and albums. The CCE is accessible from the Edit menu.
• The CCE is intended to solve three issues:
  • When looking at credits on an album, they are often described on a per track basis. For example CD credits may describe John Doe as vocals on all tracks and guitar on track 4. As there are rarely completely separate descriptions for each track, this layout of information makes it difficult to enter in Involved People or Musician Credits as the file selection may have to continuously change. The CCE hopefully makes it easier to specify which tracks are relevant when adding new items.
  • Users of Roon are faced with thousands of Roon standard credits which must be specified exactly or they will not appear. Hopefully, we've made sense of this process. We've built in a number of functions to make it easier to transition manually entered text to something Roon will recognize.
  • The Discogs API does not differentiate between credits which are instrument or involvement based. Prior to Yate v3.16, the Discogs Preferences enabled you to edit the Discogs credit mappings and to assign specific Discogs Credits to Composer, Conductor, Lyricist and Remixer as well as to Involved People and Musician Credits. This functionality has been moved into the CCE where you can also alias one role to another.
• You can choose to process only the Involved People and Musician Credits fields or additionally to process the simple credit fields. The following credits are simple credits: Artist, Album Artist, Composer, Conductor, Lyricist, Original Artist, Original Lyricist and Remixer. Custom fields marked as being credits can also be processed.
• Credits are displayed as one person - one role.
• Credits can be saved to the known credits list.
• Credits names and mappings can be changed.
• Known credits can contain aliases and alias substitution is a provided function.
• Standard alphabetic case settings can be applied to both credits and people.
• Over 6000 known credits are built in. In many cases alias values have been supplied to ease the transition to known Roon settings. These aliases can be ignored if desired.
• Extensive filtering is available for the known credits list and for the list of person-credit items extracted from tracks.
• Duplicate credits can be identified.
• Credits not palatable to Roon can be identified.

      Artwork

• The Artwork Cropper tool can now crop any image.
• Edge cropping as well as squaring is now available.
• You can now manually load images into the Artwork Viewer. You can drag and paste images and image files and Open image files.
• If you open or drag a folder into the Artwork Viewer, an attempt will be made to open a folder.jpg file.
• The Artwork Viewer can load a folder.jpg file if the set of selected files are all in the same folder.
• The Artwork Viewer's displayed image can be saved as a folder.jpg file if the set of selected files are all in the same folder.
• The image cropper is now available in the Artwork Viewer.
• The Artwork menu has a new item: Show folder.jpg in Artwork Viewer.

      Beatport Importer

• Changes have been made to the UI to allow more granularity in the display of information. Separate columns are now provided for Status, Track ID, Release ID, Import and Score.
• Columns can now be sorted.

      Discogs and MusicBrainz Wizards

• Both wizards no longer clear the search criteria when the New Search button is hit.

      theMovieDB Importer

• New import setting for Media Type. When enabled, the Media Type field will be set to one of Movie or TV Show.
• New import setting for Video Definition. When enabled, the Video Definition field will be set by calculating the value based on the properties stored in the file.
• New import setting (TV only) for Season Description. The import of a season's description is now optional.
• New import setting for Classification which works with a list of country codes supplied in Preferences-Video.
• An imported release date will now save the full date in the Year field as opposed to truncating after the year.
• Most of the description fields are now retained differently to be more compatible with iTunes and other applications. The mappings are described in the online help.

      Audio Preference Changes

• Audio preferences has been cleaned up to make them easier to read. Settings common to all supported audio types are now on a Common tab.
• The Application Presets button now allows you to select Kodi and Roon.
• The ID3, MPEG-4 and FLAC panels all have granular settings applicable only to Roon.
• The online help on any of the audio panels has a link to describe settings changes necessary for Roon.
• There is some controversy as to whether the low level ID3 TXXX frames used to contain UDTIs can contain multiple values. In ID3v2.4 a null character (binary zero) is used to separate multiple fields. Yate always reads the fields correctly if a null character is used as the separator. By default Yate does not support this encoding when writing files. If you wish, you can enable this behaviour by checking the ID3 Use nulls to separate multiple values in TXXX frames option. When unchecked, the multi-value delimiter (;;;) sequences will be left unmodified when writing the fields. This option only applies when ID3v2.4 is used as the write format.
• MPEG-4 files can now be set to read both Conductor variants.
• The MPEG-4 Write Empty Video Fields setting has been moved to Preferences-Video.

      Other Preference Changes

• Discogs Preferences no longer has the ability to edit the credit field mappings. This functionality has been moved to the new Combined Credits Editor.
• Preferences-Video has a new setting used to specify an alternate join sequence to use when importing genres from theMovieDb.
• Preferences-Video has a new setting to specify a list of country codes to be used when importing classifications from theMovieDB.
• Preferences-File List has been reorganized.
• The File to Tag template editor has a new token named Fold Characters. This token must be the first item in a template. It performs Unicode character folding on the source data as is done by the Re-encode action statement and the Re-encode item on the Yate Transformations content menu. This is mostly useful to ease the detection of dash (-) variants in a filename.
• Preferences-General-Notifications has a new option to automatically clear out all notifications when exiting the application. (Notification Center only). There is also a button to do it manually.

      New Escape sequence

• \_ is a new escape sequence used to insert an alternate comma (‚).

      Action Statements

• A new statement called Combined Credits Functions is supplied. The statement provides a means of accessing much of the Combined Credits Editor's functionality in an action.
• A new statement called Repeat For is supplied. This is basically a standard programming for loop.
• The Calculate Disc Of function has been enhanced to support emptying Disc Count fields when there is only one disc. Also it can now optionally empty or set the Disc field to 1 for various conditions. The Action Menu's Calculate Disc Of function has been enhanced with the same options.
• There is a new Property called Video Size. The property describes the maximum width/height of file containing video tracks as width x height.
• The Get Data from AcoustID statement can now read a special named variable in order to override a tracks' duration. This is only necessary where fingerprints are being retained and later loaded into arbitrary files for lookups.
• The Run Application statement has been enhanced. It can now launch applications and pass Open With messages. With certain players, this statement can be used to enqueue tracks. A sample action is provided on the resources page.
• When supplying a list of file types to the Prompt for File or Folder statement, you can now use comma as well as space as a delimiter.
• The Create m3u statement now allows an empty relocate to value.

      File List

• Track, Disc and Movement columns all have the same display implementation. The approach is to only display the 'of' number if it adds value. In a potential display of 'n of m', the following held:
  
      n=2, m=3 --> 2 of 3
      n=2, m=0 --> 2
      n=0, m=0 --> empty
      n=0, m=2 --> empty
  
  A non zero 'of' value was not displayed if 'n' was empty or 0. This case will now display as '0 of 2' in the belief that whatever is available should be displayed. The new semantics apply to data entry as well.
• The Hi Def Video field has been renamed Video Definition. You can set values of SD, HD 720 or HD 1080. These values can be read by iTunes when adding files.
• The Audio Properties box will display the maximum width/height of file containing video tracks.

      Miscellaneous

• Wherever the a delete key is valid for deleting items, both left delete (backspace) and right delete will now work.
• The Database Viewer context menu items Hide Items With Data Equal to Cell and Hide Items With Data Not Equal to Cell are now case insensitive.
• All functions which operate on multiple albums, now ignore alphabetic case when grouping by album name.
• Previously, MPEG-4 ---- atoms with multiple data components were delegated to the Unhandled panel. Yate will now read and preserve all available data in the technically invalid container.
• The main window and all Database Viewer windows now have Auto Size Column and Auto Size All Columns options.

      Bug Fixes

• Fixed a few UI bugs in theMovieDB importers.
• theMovieDB importer would crash if Import was hit with no files selected.
• theMovieDB importer was not properly importing descriptions. The mappings were not the best.
• theMovieDB importer was putting movie taglines into Set Subtitle as opposed to Description.
• theMovieDB importer was not properly retaining previous settings values.
• In v3.14.2 code was introduced to open the appropriate preference editor if you held down the Alt/Option key while clicking on a template in the File to Tag, Rename or Search for Artwork menus, or the Artwork menu's Default Search item. This made keyboard shortcuts to these items which contain an Alt/Option key to stop working as expected. The code has been changed to open the appropriate preference editor if Alt/Option is the only modifier key which is down. Further, a keyboard shortcut will never open the editor.
• A few editor panels had inoperative help buttons.
• Quit was not disabled when when a UI initiated action was running.
• The Label field was not splitting multiple values when Choose Value was selected.
• Got rid of some annoying beeps when configuring the window tabbing behaviour.
• Fixed a few potential crashes in the Custom Panel Editor.

Version 3.15.1 (5590)

      Auto Search for Artwork

• The functionality has been entirely redesigned.
• There should be far fewer incorrect matches with the new algorithm. In fact, we feel so good about it that we've enabled the use of the functionality in the Batch Processor. Note that the number of successful matches may not change.
• The Fix too Much Auto Searching Error process has been removed as it no longer applies to the new algorithm.
• There are a variety of options to tune the algorithm which can be accessed in the Preferences-Artwork section via a Configure Auto Search button.
• The algorithm targets specific countries. It will more than likely be required to specify one or more countries to be searched in the settings.
• The associated action statement has been redesigned as well. All older uses of the statement will be interpreted as a search request and will not be based on previously acquired metadata.

      iTunes & The Grouping Field

• As of v12.5.4, iTunes is once again writing grouping metadata to mp3 and aiff files. This does not remove the need for the fix we introduced in Yate v3.14.3 as the low level frames used are not standard.
• Grouping metadata is no longer handled as a synch item. Therefore, Import from iTunes, Export from iTunes and the main window's iTunes column no longer display or handle Grouping metadata.
• We are now using the same low level file component as iTunes to store Grouping metadata when the Maximum iTunes Grouping-Work Name Compatibility option is set.
• The change of the non standard file component used is handled transparently.
• While there is no need to do so, you can run the Force Save All MP3 and AIFF Files action to force exact compatibility in all files. This serves no purpose if Maximum iTunes Grouping-Work Name Compatibility option is not set.

      The Movie DB

• You can now import movie and tv show metadata from The Movie DB. The Importers are available on the Actions menu and online help is accessible off the main help page.

      Discogs

• The track detection algorithm has been tweaked yet again.
• Media subtitles can now be imported via the wizard and the Discogs Metadata for Release statement.
• The Back to Release button on the Release window can now also start a new search.
• Discogs rate limit changes are now handled dynamically.

      MusicBrainz

• The URL encoding has once again been adjusted to possibly enable more accurate results.
• The Back to Release button on the Release window can now also start a new search.

      Custom Panels

• Multiple occurrences of FLAC UDTIs are represented as a single UDTI with values separated by the multi-value separator. You can configure a UDTI field on a custom panel to represent each value as a separate line. The data is converted appropriately before being displayed and when written. To enable this, add a UDTI item to the panel and configure it to occupy more than one row. Assign the item a display name starting with a semi-colon. The semi-colon will not be displayed.

      Preferences

• You can drag and drop the preference sections so that they are organized however you wish. The context menu for the list of preferences contains a single item which will resort the sections so that General is first and the others are sorted in increasing alphabetical order.
• There's a new preference section named Video with a few settings related to The Movie DB functionality.
• If you prefer to have text preselected when tabbing into a single line text field in an edit panel, you can enable this via a new option in Preferences-File List.
• Additional tokens have been added to the File to Tag templates to extract metadata for TV shows. Show Name, Sort Show Name, Season and Episode. Note that the extracted metadata will be ignored in files not containing video.

      Action Statements

• The Preferences statement can now override the Artwork settings for scale size and scale only if square.
• The Replace statement now supports the All, First, At Start, At End, Last, Leading and Trailing qualifiers when matching characters. Previously when matching characters, All was the only valid mode. There is a new qualifier called Compress which is only valid when matching characters. The option replaces any consecutive sequence of the replace from characters with a single occurrence of the replace with string.
• The Copy Metadata Between Files statement now supports the ability to copy the source file's initial metadata values as well its current metadata values. With two of these statements you can now swap the metadata between two files.
• New action statement named Compare Field Across Files. This is essentially a new more powerful variant of the Compare Files {Test} statements.
• The Indexed Artwork statement now lets you set the index item to be the default item. ie. it is moved.
• The Rearrange Artwork statement has been significantly enhanced. You can now match on any combination of largest, any picture type and matching against the description field.
• The Open Database for Querying statement now supports case insensitive keys.

      The Multi Field Editor

• The Replace function supports the new Compress qualifier when matching characters.

      Bug Fixes

• Label and Publisher controls on Custom Panels were not displaying the drop down control, introduced in v3.15, to access their associated lists.
• The iTunMovi component in video MPEG-4 files was not being read correctly. Regression introduced in v3.15.
• As Yate lists are case-insensitive, autocomplete could have been put in a state where a file contained the correct text but the displayed field did not. This could happen when changing the case of a field which auto-saves and autocompletes.
• Now have a workaround for m4a (AAC) files where an incorrect sample rate is contained in the header.
• The text fields on the Discogs and MusicBrainz Wizard Search panels will now work with clipboard utilities.
• When producing CSV files from the UI, an Original Album field was incorrectly mapped to Original Filename.
• Original Filename was not available as a column.
• Multi line UDTIs on custom panels now display correctly.
• Now catch DSF files with invalid tag pointers and recover if possible.

Version 3.15 (5501)

      ReplayGain Calculation

• The ability to calculate ReplayGain parameters for all file types except DFF and DSF has been added.
• The functionality is available in the UI via the File menu and in actions by the new ReplayGain statement.
• The gain and peak can be calculated for tracks only, for tracks and albums where an album is all selected files and for tracks and albums where the Album field is used to determine album identification.
• The target level has been defaulted to -18 LUFS (Loudness units relative to Full Scale). You can override this in Preferences-Audio.

      FLAC and MPEG-4 Involved People and Musician Credits Compatibility

• Unfortunately there are no real standards for these fields. Lots's of work has been done in this release to enable better compatibility with other applications (including Kodi).
• In FLAC files, mappings and encodings changed. The transition is a transparent process and happens whenever a file is saved.
  
  • New mappings are provided for all fresh installs of the application. If you have not changed the out of the box FLAC mappings you can simply do a Yate>Reset Built In Items>Reset FLAC Mappings to get the newer mappings.
  • The new default mappings can individually read and write Involved People items for Arranger, DJ Mixer, Engineer, Mixer and Producer.
  • If you have changed the defaults for the Involved People or Musician Credits fields, you can download a file containing only those mappings from the Resource - Template area. Please read the documentation as there are a few things to check after the import.
• In MPEG-4 files, new mappings are provided to individually read and write Involved People items for DJ Mixer, Engineer, Mixer and Producer.
• Old and new encodings will be read correctly. Documentation for the encodings can be found via links at the bottom of the Tag Mapping Table accessible off the main help page.
• If for any reason you want to update the mappings/encodings in all your tracks you can always run an action through the Batch Processor. Sample actions are provided in the Resources-Sample Actions area. However, unless you are experiencing display issues in other applications, there is no need to do so.
• No action changes should be required as the display formats for these fields have not changed. All merging and un-merging on low level data is handled automatically. If you directly accessed roles saved in UDTIs, it may be possible that these roles now appear in Involved People. If this is the case, sample actions are provided to manipulate the Involved People and Musician Credits fields.

      Main Window

• Where possible, fields now display "Mixed" as opposed to "???" for multiple values.
• Note that the Preferences-File List option to Disable Unique Fields on Multiple Selections has been removed. This is now implemented as a warning which can be temporarally or permanently disabled. If you had previously disabled the old setting, you will not see any changes. If you want to re-enable the warnings, do a Yate>Reset Warnings.

      Artwork Panels

• The thumbnail strips in artwork panels have three new menu items: Normalize, Largest First, Delete All but Largest.
• The menu items are also provided on the main window's Artwork menu.

      UDTIs

• In order to support multiple FLAC tag items of the same name which are not mapped to specific fields, UDTIs may now contain multiple values separated by the Multi Value Delimiter.
• When editing a UDTI on the UD Text panel, you can now elect to treat multiple lines as separate values.

      Preferences

• Lists
  • Prior to this release, the application supported lists for Genres, Artists, Composers and Groupings. These lists were fixed to specific UI controls and autocomplete could be enabled or disabled.
  • This release introduces new lists for Conductors, File Types, Labels, Lyricists, Media Types, Moods, Publishers and Remixers.
  • The Preference sections for Artists, Composers, Genres and Groupings have been removed. There is now a single Preferences section called Lists where you manage and view these lists.
  • Eligible UI controls can be mapped to any list. If you want to maintain a single list for Composer and Lyricist fields, you can do so.
  • Eligible fields can be dissociated from any list.
  • Individual fields can be auto-saved. An auto-saved field will add its UI edited content automatically to a list. You can also toggle this state from an appropriate control's function button menu.
  • Individual fields can have autocomplete enabled or disabled. You can also toggle this state from an appropriate control's function button menu.
  • Unfortunately, it was impossible to preserve the settings associated with the previous incarnation of the lists. You should view the Preferences-List section at least once, to ensure that your desired settings are in effect.
  • The lists automatically create separate entries when items with multiple elements separated by the multi value delimiter (;;;) are added. Existing lists will be adjusted accordingly.
• General
  • New setting to preserve an audio file's modification date/time when saving the file. Careful here, as some players use a changed modification date/time stamp to detect changes.
• Audio
  • All
    • New setting to specify the ReplayGain target level.
  • FLAC
    • New option called Keep Involved People Lists in Involved People mapping. Involved People List Items are written to their designated mappings. If you wish, you can have the items written to the write Involved People mapping as well.
• Discogs
  • Discogs functionality tends to operate better if extraneous media types are ignored. By default media types which begin with blu-ray, dvd and video are ignored. It is posible that certain audio tracks can be identified as dvd. If you wish you can now edit the list of media types to be ignored. The list is case insensitive and uses commas (,) as separators.
• Exceptions
  • An exception set marked as the default, is used by rename functions (changing file names) and case transformations (not changing filenames). You can now specify separate sets to be used for each function area.
• FLAC mappings
  • There's a new mapping type called Involved People List Item. These items allow you to map components displayed in the Involved People field to alternate mappings. The new default mappings implement support for ARRANGER, DJMIXER, ENGINEER, MIXER and PRODUCER. You can add others if you wish.
• Replacements
  • A replacement set marked as the default, is used by rename functions (changing file names) and case transformations (not changing filenames). You can now specify separate sets to be used for each function area.

      MusicBrainz

• You can now import Media Subtitles which get saved to the Set Subtitle field.
• Bug Fix: UTF16 characters were not properly transformed to UTF8 characters for URL inclusion.

      Fingerprinting

• Fingerprinting is now available on DSF files.

      Renaming

• When renaming, sequences of multiple spaces will be replaced by a single space.

      Action Statements

• New ReplayGain action statement.
• The User Defined Fields statement can now be used to remove selective General Encapsulated Objects and Private Information items.
• The MusicBrainz Metadata for Release action statement has a new track level key named Media subtitle.
• The Preferences statement allows you to override the new more granular default Exception and Replacement sets. It also can now be used to clear any of the Preference lists: Artist, Composer, Grouping, etc.
• The Fill Lists statement supports the new expanded lists. The statement is now multi-value delimiter aware.
• The Standardize Case statement supports the new expanded lists. The statement is now multi-value delimiter aware.
• The Extract Preference Set statement supports the new expanded lists.
• The Case statement now has a No Change option. This is a convenient method of applying exceptions and/or replacements without changing the case of a field.
• New escape sequences, available from the Yate Escape Sequences context menu, to insert the paths to common folders: Application Support, Downloads, Documents, Movies, Music and Yate Application Support.

      The Multi Field Editor

• The Case panel now has a No Change option. This is a convenient method of applying exceptions and/or replacements without changing the case of a field.

Version 3.14.3.5 (5412)

• A better fix for the v3.13.3.4 issue.

Version 3.14.3.4 (5411)

• Found an oddball layout of an m4a file which was causing problems.

Version 3.14.3.3 (5410)

• The iTunes Grouping workaround introduced in v3.14.3 had some minor issues.
• The Rearrange Artwork statement was flipping the Largest first and Largest Cover (front) to first options.

Version 3.14.3.2 (5408)

• Bug fix: v3.14.2 broke the import of a Comment field via a File to Tag template.

Version 3.14.3.1 (5407)

• Bug fix: The rename documentation states that Artist is substituted for an empty Album Artist field. Unfortunately when testing for the existence of Album Artist, the same logic was applied. That meant you were testing if Album Artist or Artist existed.
• Bug fix: The Test action statement was ignoring the Exit and Stop options.

Version 3.14.3 (5394)

      iTunes

• iTunes 12.5.2 introduced an incompatibility with how the low level Grouping field in mp3 and aiff files is interpreted. When iTunes reads one of these files it sets its Work Name field to the value stored by other applications as Grouping. This release contains a work around. It's not a terribly aesthetic workaround but it works.
• New Preferences-iTunes option called Maximum iTunes Grouping-Work Name Compatibility.
• Grouping metadata can now be imported and exported.
• The display, auto-import and auto-export iTunes preference settings now support Grouping.
• The display, auto-import and auto-export iTunes preference settings setting to Ignore MPEG-4 files has been removed.
• The Export to iTunes and Import from iTunes action statements support Grouping and no longer have the Ignore MPEG-4 files setting.
• New help topic called: iTunes, Classical Metadata and the Grouping Field

      Main Window

• The Edit Panel Picker is no longer supported as a drawer. Sierra doesn't like drawers.
• Added columns for Seller and Price Paid.
• You can now elect to display larger text in the status bar. You choose the size from the Font menu. Note that the status bar in Database files is affected by the option as well.

      MPEG-4 Files

• Now approxmate the bit rate for m4a files which report a bit rate of 0.
• When writing MPEG-4 files and the Map stik atom to Media Type option is set, unknown or empty Media Type values will set the stik value to Music or Home Video.

      Preferences

• Sierra tabbed window preferences have been moved to a popup panel. You can now choose to include the Discogs and MusicBrainz wizards in the main tabbed group.

      Artwork

• There are new, or restored, Artwork menu items: Save Artwork to Folder Icon and Save Artwork to folder.jpg. The associated main window context menu has equivalent menu items. These functions work with the default artwork item (the first). No folder will be modified more than once.

      Action Statements

• New action statement: Discogs Metadata for Release
• Okay, we bullet and added a Prepend action statement.
• The MusicBrainz Metadata for Release statement now returns the per disc track count in the Track List with the key Track Count.
• Access Query Database-Set Column to Value now allows you to only change records returned from a previous query.
• Column Value List from Query Database now has an Unsorted option.
• Although the functions were implemented to be more efficient when run stepwise, the limitation that the following action statements cannot run groupwise has been removed: Artwork to Folder, Artwork to Folder Icon and Artwork to folder.jpg.
• The Write Text File statement has a ne append option.

      Bug Fixes

• When an action was renamed and it was on a Custom Panel, the Panel was updated but the stored settings were not.
• The Access Query Database-Set Column to Value was not allowing an empty value.
• Worked around a potential crash on Sierra when editing cells in a Database Viewer.
• You coundn't sort the MusicBrainz Wizard's search results by Track or Disc number.
• Column Value List from Query Database was flipping the Case Insensitive option.
• Column Value List from Query Database was not case preserving when set to Case Insensitive.
• The Discogs wizard no longer removes () sequences at the end of names unless they are (#)
• The File List Customize column display attributes mappings were messed up internally. In order to fix the issue all column attributes have been reset to their default values. Sorry for the inconvenience.

Version 3.14.2 (5357)

      Tabbed Windows on Sierra

• Sierra allows for the automatic tabbing of windows. The default behaviour is set via System Preferences-Dock-Prefer tabs when opening documents
• New Yate Preferences-General settings to control tabbing groups of windows under Sierra. You can override the default system settings and enable the grouping of Action Editor and Database Viewer windows, each in their own group.
• You can also choose to include the Action Manager in the same group as Action Editor windows. This is a great feature for small displays.
• You can optionally choose to merge database viewers into the same tabbed window with actions.

      File to Tag

• File to Tag templates can now extract from any number of path components. Previously only the filename and containing folder name were available. You do this by specifying multiple Folder Start tokens, each of which works with a higher up path component.
• There are new qualifier tokens to mark sequences as Required, Optional, Numeric and Not Empty.
• When in the File to Tag template editor you can now preview the template against specified paths as opposed to loaded files. This is useful as at times it may be difficult to find multiple files with the desired paths for testing. To be prompted for test data, hold down the Shift key when starting the preview.
• The File to Tag action statement has been enhanced to support the per file enumeration of a list of templates.

      Menus

• If you hold down Alt while clicking on a template in the File to Tag, Rename or Search for Artwork menus, the template is opened in the appropriate editor.
• If you hold down Alt on the Search for Artwork menu's Default Search item, the associated template will be opened in the appropriate template editor.

      Named Variables

• Setting a named variable to the empty string completely removes the all space it previously occupied. The named variable is still accessable as all uninitialized named variables have an empty string as their value. The only difference is that when displaying named variables via the Dump Variables statement, empty named variables will not be displayed.

      Actions

• You can now use the Delete key to remove items in an Action Editor window.
• Much better memory management when running an extremely long action through the Batch Processor.
• The Prompt statement allows to you to post the message to the system logging system. On Sierra, in the Console application, it is difficult to find log messages that have been posted before the Console was opened. The online help for the Prompt statement now describes a Terminal command which allows you to reliably see Yate initiated messages passed to the system log on Sierra.
• All query database statements will now initialize the Query Database field if there is a single Open Database for Querying statement, in all open actions, which supplies a prefix. There is also a new Insert Query Database Prefix context menu item in these fields.

      Action Statements

• The Delete Non Audio statement was deleting all non audio files when the *: pattern was supplied. *: was intended to delete all empty folders, not files. In order to provide equivalent functionality and to allow you to separate files and folders, the * pattern can be used to delete all non audio files, but not folders. The sequence */*: will delete everything permitted.
• Unless the key passed to any Query Database statement starts with a #, it is trimmed (leading and trailing spaces removed). This was implemented to support symbolic keys which start with a #. You can now simply put a space before the key to avoid the special line number mode.
• The Preferences statement now allows you to reset an Exception or Preference set to its pre-action value. This is done automatically when an action ends but there are cases when you would want to do so while executing.
• The Preferences statement has new override settings for Write ID3v2.3 and Write ID3v2.4. Setting the value to empty resets the value to the setting in the application preferences.
• The List Key statement has a new option which supports per file keys as opposed to a single key for all files.
• The File to Tag action statement has been enhanced to support the per file enumeration of a list of templates.
• The Prompt statment's Batch Status mode has been renamed to Status. The mode is now available in all contexts to display a message on the main window's status bar.
• The Date Functions statement now supports the extraction of and offset by Hours, Minutes and Seconds. The resultant date format when offsetting a component is now smart as to what the output format is. There is a new Full options to force a full date/time representation. There is also a new extraction type called Duration. This is a special form used to return a visual representation of a passed number of milliseconds. The returned representation may contain days and hours and will always contain minutes and seconds.

      Database Viewer

• The Advanced Filter functionality uses # Column Names to supply integer values for cells. A new heuristic is applied which will allow these columns to work as expected with cells containing symbolic ratings.

      Preferences

• The from value of items in Replacement sets have always been treated as case sensitive. You can now specify that you want case insensitivity by starting the from value with a \~ sequence.

      MusicBrainz

• ... and yet again ... better escaping of special characters in the MusicBrainz Wizard's search fields.

      Bug Fixes

• The Compare Fields Test statement was not properly setting the action test state when only one file was active and testing was for Files only.
• Better testing to avoid timing issues when closing Action Editor and Database Viewer windows.
• While batch processing, the Load and Run statement was not logging the name of a file which could not be opened.
• Fixed the annoying little banding effect under the file list's table banner if using coloured backgrounds on Sierra.
• File to Tag previews now display meaningful field names as opposed to internal key names.
• Depending on how a standalone database was created, not all fields were editable.
• The Sort List statement was not working when sorting a sublist with the numeric option.
• The Issue Database Query statement was returning incorrect results on a keyless database when using a previous result set.
• Export Sets had two possible Length items. The Length item at the top of the list was based on the extracted audio duration in ms while Length at the bottom of the list referred to the user editable Length field. The duration item has been renamed Duration. No changes are required in existing sets.
• Columns could not be hidden in standalone databases.

Version 3.14.1.2 (5289)

• Bug Fix: Fixed a timing related crash on Sierra.
• Regression: The patch to fix the "invalid database" message when finding missing tracks from the Discogs or MusicBrainz wizards, resulted in some databases displaying Albums as opposed to Items on the status bar.

Version 3.14.1.1 (5288)

• Bug Fix: On Sierra Rename sometimes could crash.
• Regression: Finding missing tracks in a Track database from the Discogs or MusicBrainz wizards, was always saying the database was invalid.
• After all these years we found an mp3 file mangled in a new way which caused us problems.

Version 3.14.1 (5287)

      The Action Manager

• The Action Manager now supports the saving and restoring of the sort order.
  • If you have a manually arranged display list, you can now save the sort order by the Save Current Sort Order context menu item.
  • You can return to your saved sort by the Sort by Saved Sort Order context menu item.

      Action Editor Windows

• New Action Usage context menu sub menu. Displays a list of all accessed file actions and all accessed or declared inline actions. Clicking on a menu item will open or show the associated action.
• All action statements which run an action have a picker button to display a list of action files. The picker control will now display all declared inline actions, when appropriate. The picker control has been added to the Repeat Forever statement.
• The Start action statement now has a picker control to display all referenced but not declared inline actions. As a convenience the menu will also display Batch Start and Batch End if not declared.

      Full Screen Support

• Hopefully a better interaction with the Full Screen mechanism. (Yosemite or later). The main window, Action editors and Database viewers can be full screen and tiled. All other windows cannot.
• New General-Preferences setting called Allow document windows to become full screen. The setting can allow or disallow full screen support on Action Editor windows and Database Viewer windows.

      Error Messages

• The more meaningful Cocoa Error messages introduced in v3.14 now display the error number as well as the descriptive text.

      Resources Web Page

• The Sample Actions web page has been replaced with a Resources page which has a new Documents area.

      Audio File Health Check

• The Repair Files from Audio File Health Check Log action has been updated and can be found on the Resources page accessible off the Help menu. When you import the action make sure that Overwrite is set.
• The newer action now removes invalid control characters and newline sequences from fields which do not support them. It also directly modifies the targeted files as opposed to importing and exporting metadata.
• While it is still recommended that you run the action by dragging the log file to the Batch Processor target, it will work if run directly from the UI.

      Action Statement Changes

• The Indexed Artwork action statement now supports saving to a named variable and the function can now extract the size of the artwork data in bytes.
• The Trim functionality will now process User Defined Text Info and User Defined URL items, if the deep option is specified.
• The following action statements can be executed always or only if the action test state is true or false. Break, Cancel, Exit, Exit Grouped, Exit Repeat, Next File, Restart Batch Processor, Restart Repeat Forever, Stop, Stop Batch Processing.
• You can now set the button labels directly on an Ask statement.
• The Run Context Test statement has been renamed to Test Run Context.
• The Test Key State statement has been expanded to test if a key is pressed or not and given the ability to Set, And, Or the action test state. This way any explicit combination of modifier keys may be tested.
• The Re-Encode statement now has a function to remove RTF formatting. Useful if you've read an RTF file and you want the raw text.

      MusicBrainz

• Yet again ... better escaping of special characters in the MusicBrainz Wizard's search fields.

      Bug Fixes

• A Save statement executed stepwise from the UI while processing a Load and Run statement, saved to the current file selection as opposed to the track loaded by the statement.
• It was possible to lose changes in a focused artwork description field if the field lost focus by clicking on a toolbar icon or by executing a keyboard shortcut.
• The Cancel Batch button on the Dump Variables window was not cancelling.
• Fixed a vulnerability where the closing the Action Manager in full screen mode could cause the application to crash.
• The new Custom Panel Action Buttons, were not always refreshed properly.

Version 3.14.0.1 (5252)

• Regression: testing to determine if a path was clean uses a new API set and had a bit flipped. This affected the Batch Processor and possibly other places as well.
• Here's a small feature we missed in v3.14. You can add a tooltip to a Custom Panel Action Button by placing a Comment starting with 'Tooltip:' in the associated action. All text following the header will be used as the tooltip.

Version 3.14 (5250)

      Deprecated Items

• There are a few things which are either no longer necessary or are anachronistic for the application. We would like to remove them in a subsequent release. There is a new topic called Deprecated Items on the main help page under the Reference section.

      Visual Indicators

• Previously Yate used circled alphabetic characters as special display indicators. These characters look terrible on non retina displays under Sierra. We've dropped the circles.

      Main Window

• When closing files via the Delete key there is now a "Don't show again" option.
• The Actions menu Copy Metadata submenu now has a Copy Selected Metadata... item. The function will display a panel allowing you to select the copy direction and the metadata you want to copy.
• Fields which are disabled due to Preferences-File List-Disable Unique Fields on Multiple Selections, now display a visual indicator. Text fields display ... and the Artwork panel displays a lock icon.

      Error Messages

• We've attempted to replace cryptic Cocoa Error messages with more meaningful text when saving files.

      New Fields

• The upcoming iTunes v12.5 introduces support for four new classical metadata fields. Work Name, Movement Name, Movement Number and Movement Count. The fields are implemented and can be displayed on the More Info editing panel. The fields are also available as columns in the main file list area, may be filtered, exported and placed on Custom Panels.
• The fields are available for all file types, including those not supported by iTunes.
• iTunes handles these fields in a somewhat strange manner. They are stored in MPEG-4 files but in all other iTunes supported file types, they are only retained in the iTunes database. For this reason, Yate will allow you to import/export the fields much as with other database only fields such as Rating, Playcount, etc. Due to the better, implementation in MPEG-4 files, Yate will allow you to disable import/export of thes fields for MPEG-4 files.
• Note that when importing the values from a version of iTunes less than 12.5, empty and 0 values will be imported.
• Preferences-iTunes has been updated to allow the selective display/import, auto import and auto export settings for these new fields.
• The Import from iTunes and Export to iTunes statements have been updated to support the new fields.
• iTunes 12.5 also introduces a new setting to control the display of its Name field as the Work or Song name. The value for this setting is stored in MPEG-4 files but unfortunately is not programatically available. For this reason the new Show Work Name in iTunes setting on the More Info panel is only available for MPEG-4 files.

      Finder Integration

• New File Tags column in the main window. The column describes the Finder Tags associated with the associated file. The column can be exported, filtered, etc.
• New Folder Tags column in the main window. The column describes the Finder Tags associated with the associated file's containing folder. The column can be exported, filtered, etc.
• New Edit Finder Tags functionality in the UI. Access via the Edit or context menus. You can edit Finder Tags for files and folders.
• Rename templates can now specify that the Finder should hide or show filename extensions.

      Custom Panel Editor

• You can now supply alternate display titles for components.
• Audio Properties can now be displayed as individual fields on a Custom Panel.
• You can now add action buttons to a panel. As the name implies the buttons execute an action.
• Date oriented fields are now allowed to be marked as cropped fields.

      Preferences

• When creating a new Export Set, you can choose to import the set associated with an existing database.
• When renaming files you can now set the Finder's show/hide state for filename extensions. This is done via Rename Templates. Note that the show/hide state is only set if a file is actually renamed. If a filename is not changed, the show/hide state will not be modified.
• Action preferences has a new setting to enable/disable the new warning issued when using escaped named variables where usually unescaped are used.
• Audio preferences has a new setting to enable verbose raw data logs. When enabled, the binary data associated with each low level frame, atom or comment will be dumped. You can set a threshold limit for the maximum amount of data that can be displayed for any one item.
• iTunes preferences has been updated to accomodate the new classical metadata fields.
• Title Case / Capitalization: It turns out that the API to capitalize strings always capitalizes a letter following a hyphen. We've made the following changes by writing our own capitalize function:
  • Titlecase: adding a - to the middle words list in Preferences-General-Configure Titlecase, will now suppress the capitalization of a letter following a hyphen, as one would expect. Note that doing so will effectively disable the proper handling of hyphenated names.
  • Capitalize First: will no longer capitalize letters following a hyphen.
• File List-Disable Unique Fields on Multiple Selections was applied to text fields and to the Artwork panel. The Artwork panel inhibiting has been given its own option called Disable Artwork panel when tracks in multiple folders are selected. The option will be initially set for new installs. It will effectively copy the Disable Unique Fields value when upgrading. The change of either option takes effect immediately.

      Action Manager / Main Window Action Icons

• The label displayed with Action 1,2...5 buttons can be customized by enclosing text within square brackets in the name of an action assigned to a toolbar button. For example an action named '[Move] Files to External Drive' will be displayed with a label of 'Move'.

      Action Editor Windows

• Warnings will now be issued when an escaped named variable is used where typically an unescaped named variable is used.
• Warnings will now be issued when an escaped UDTI is used where typically an unescaped UDTI is used.
• The context menu for text fields has a new submenu named Insert Named Variable. The submenu provides a quick means of inserting the named variables referenced in a text field in any open action. (escaped or unescaped).
• The Insert Special Yate Named Variable, Insert Common UDTI and Insert Named Variable context menu submenus are now contextually aware. A determination will be made if the escaped or unescaped name is required.
• The restriction disallowing the insertion of the File Index and File Count properties via the Insert Yate File Property menu has been removed.

      Flow Control

• The Constrain Execution to a Single File statement introduced in v3.12 allows you to limit execution of an action to a single file. However the effects of the statement are not selective or reversible. An attempt has been made this release to provide a more selective means of executing an action grouped but only once, regardless of the number of selected files. The Run, Repeat With and Test statements all have a new Once option which can be enabled when Grouped execution is selected. The Once modes are useful when processing data which is not related to the fields stored in the audio files. For example data in a query database or in a list.
• A new action statement called Break provides a more selective exit from a particular execution of an action. This function stops the execution of the current action, regardless as to how it was called or whether the execution mode is stepwiseor grouped or being repeated. The next statement to be executed is always the statement immediately following the caller.

      Action Statements

• System Integration
  • New action statement Play System Sound.
  • New action statement Test Key State. Used to set the action test state based on one of Shift, Control, Option or Command being pressed.
• File System Integration
  • The Move statement will now process ifDup sequences on specified Rename templates. To ensure duplicate handling, it is no longer necessary to move to a file named to a UUID and then to rename.
  • New action statement Contents of Folder returns a list of all non hidden items in a specified folder. You can return files and folders, only files or only folders.
  • The Write Text File statement will delete yatesh files if the content is empty. This means that you can create script files on-the-fly and then delete them.
  • The Delete Non Audio Files can now delete empty folders. The include and exclude lists can specify folder names. The include list can also contain *: to imply all empty folders.
  • The Import Artwork statement can now specify that that filename matching should be a contains match as opposed to an exact match.
  • The Variables mode of the Move Non Audio statement now process multiple folders as do the other folder determination modes when running stepwise.
• List Manipulation
  • New action statement Build Key List. Used to construct key value list where the keys and values are extracted from fields. As an example this is an efficient method of producing lists of unique artists for all albums.
  • The Sort List statement now has the option of sorting based on the integer value of the list items. While Sort as in Finder handles some leading integer cases it does not normalize leading zeros. ie. 01 is treated as different from 1.
  • The List Item at Index and Set List Index statements, both now support negative indexes. A negative index counts from the right of the list. -1 is the last element, -2 is the second to last, etc.
  • The List Combine statement has been renamed List Manipulate. The statement now supports the filtering of lists and the ability to produce a list of all unique integer values in a source list.
• Date Manipulation
  • New action statement Date Functions. The statement can be used to extract date components year, month, day, week of year, week of year (relative), day of year, first day of week, day of week, days in month and days in year. It can also be used to add offsets to a date's year, month, week or day component. There are also convenience methods to set a date to YYYY-MM-01 or YYYY-MM-01.
• External Script Execution
  • The Run once option in the Run External Script statement will now save the result to all files when run stepwise. This is more consistent and makes it easier to access the result.
  • As mentioned above the Write Text File statement eases the deletion of external scripts created on-the-fly.
• Numeric Expression Evaluation
  • We got tired of not having a 'mod' function in the Evaluate Expression statement, so we added one. At the same time we added 'div', 'min' and 'max'. More information in the online help for Evaluate Expression.
• Query Databases
  • The Open Query Database statement now enforces the uniqueness of the supplied identifying prefix. All non prefix methods of referencing an open query database are now deprecated. If an open fails because the database is already open, a named variable will be assigned the value of the previously opened database's identifying prefix. See the online help for more information.
• Flow Control
  • New action statement called Test Property. The statement is a convenient means of testing a conditional property across all selected files. You can test for No file, Any File or All files for the Is Modified, Is Linked to iTunes and Has Video properties.
  • Inconsistencies on the Exit Repeat statement have been resolved. The statement immediately exits a calling Repeat With or Repeat Forever statement, regardless of the execution mode.
  • As already mentioned, the Run, Repeat With and Test functions have a new Grouped-Once option.
• Metadata Copying
  • New action statement called Copy Metadata Between Files. The statement allows you to copy selected metadata from a single file to another file or all other files.
• Encodings
  • Encode As has been renamed to Lossy Encode As. Use of the statement is deprecated. Re-Encode should be used as an alternative.
  • The Re-Encode statement now supports ASCII (Lossy) and ISO Latin-1 (Lossy) modes.
• Prompts
  • The Prompt statement now has an option to hide the Copy button.
  • There are no longer any limitations when batch processing with the Ask, Dump Variables, Prompt and Prompt for Text statements. The standard Pending Action Window is now displayed even when batch processing.
• Regular Expressions
  • The Regular Expression statement's pre-processor now accepts named variable escape sequences \<name> as well as variable sequences \v#.
• Extended Named Variable Support
  • The following action statements now support named variables:
    • Bracket
    • Evaluate Expression
    • Extract Bracketed Text
    • Get First Line
    • Lossy Encode As
    • Make Numeric
    • Re-Encode
    • Regular Expression
    • Remove/Insert
    • Scanner
    • Split
    • Truncate Variable
• Usability
  • The following action statements now have Show buttons to quickly view their respective template in the appropriate Preferences context:
    • Artwork to Folder Icon
    • Artwork to folder.jpg
    • Create Album Database
    • Create Track Database
    • File to Tag
    • Rename Files
    • Search for Artwork

      Discogs / MusicBrainz

• The Discogs and MusicBrainz wizards now assign the default button focus to the Import button on the Import panels.
• Better escaping of special characters in the MusicBrainz Wizard's Album search field.

      Database Viewer

• You can now produce an m3u file for all displayed items in a Track database.

      MPEG-4 Files

• MPEG-4 files with fragmented audio/video data can now be processed. Note that the duration, bit rate, etc. is taken from the audio track so values may be zero if they are not available where expected.

      Bug Fixes

• Various action statements were not replacing : characters in file paths. They were replaced in filenames but not always in path components. While the OS always replaced the characters it was not consistant with the Invalid Character Substitution setting. Note that Rename was not affected by this issue.
• List item at Index was returning true for an empty list and an index of 0.
• It was possible for a thumbnail on a custom panel to display an incorrect image. This could only happen when the associated track had no artwork and the tab panels were changed a few times.
• The Remove/Insert statement was not processing escape sequences in the numeric fields, as documented.

Version 3.13.0.2 (5116)

• Fixed an issue with FLAC files which have an ID3 header which contains invalid frames.

Version 3.13.0.1 (5115)

• Bug Fix: The Sort List statement was not sorting consistently when sorting sub-list components.
• Bug Fix: Custom Panel fields which had a disabled checked Cropped field, with the value set, were not being sized properly.
• Bug Fix: The Search for Artwork>Cover Art Archive menu item was sometimes being redirected to Discogs.
• Bug Fix: The action test state was not being set correctly for some modes of the Regular Expression statement.
• Bug Fix: A few Sierra issues have been fixed.

Version 3.13 (5113)

      Action Test State Changes

• Previously every action had its own unique test state. This goes back to the early days of action processing in Yate when there were no flow control statements other than the Test statement. The current implementation makes it impossible to return a true or false value in the test state from a called action. The behaviour has been changed such that there is now a single test state for the entire action mechanism. The value of the test state always reflects the last time it was set. With one exception, the test state is only automatically set when action processing first starts from the UI or whenever a new folder is about to be processed by the Batch Processor. In these cases the test state is set to false.
• The exception is the Load and Run statement. After executing a Load and Run statement the test state reflects the success or failure of the track loading, as it always did. The test state from the executed action is not returned.
• There is a new option in Preferences-Actions where you can return to the earlier action test state mechanism. This may be removed at a later date.
• The Preferences statement now allows you to set the behaviour either way at runtime. This also, may be removed at a later date.

      Stem File Support

• Stem file metadata can now be viewed
  • In the Snapshot Editor
  • By double clicking in an Audio Information panel
  • Via Log>Raw Data

      Database Viewer

• There is now an Advanced Filter panel. Complex filters can be defined and saved.
• Relative date testing is possible.
• Saved filters may be directly accessed via the viewer window's context menu.
• Database rows in Album and Track databases can now be dragged outside the database. The associated files or folders will be treated the same as if dragged from the Finder. Dragging to the Finder will copy, dragging to Yate will open, dragging to iTunes will add to the destination (library and/or playlist).

      Action Manager

• You can now select any combination of actions and folders when doing a Smart Export. Note that the folder structure is not preserved when doing a Smart Export.

      Action Editor Windows

• You can now Show and Hide line numbers in Action Editor windows via the context menu. This is to facilitate the location of items described by line number in certain error messages.

      Action Pending Window, Prompts, Batch Processor logged messages, Action Error Messages

• With few exceptions, wherever an executing statement and action is described ... the action name is now displayed in one of the following ways:

  When executing a non inline action

  action name (line number)

  when executing an inline action

  action name (line number in containing action)

      Preferences

• Actions
  • All preferences associated with Action Editor windows now take effect immediately.
  • You can elect to display a vertical grid line between line numbers and statements in Action Editor windows.
  • You can now change the labels on the Ask statement's True and False buttons.
  • You can choose the Action Test State mode.
• Export Sets
  • You can now export the Classification, Hi Def Video, Network Name, Show Description and Video Description fields.

      Beatport Importer

• The importer now supports a "run after import" action.

      Discogs

• Yet another tweak to the Discogs track separator algorithm. Note that this is the algorithm used to detect tracks and discs in the metadata returned by the API, not the algorithm which matches files to the metadata. Sub tracks are now better recognized.

      Action Statements

• Comment statements are now displayed as ' text to make better use of display space.
• The Run Context Test statement now supports the cancelling of action processing if the specified context is not supported.
• The Access Query Database Cell statement has been renamed Access Query Database as row and column access options have been added.
• The Create Album Database and Create Track Database statements have a new option to preserve the contents of an existing sidecar file. See the online help for more information.
• The Prompt for File or Folder statement now optionally supports the selection of multiple items and allows the selection of both files and folders.
• The Regular Expression statement can now be used to return matched patterns and matched locations as well as replacing text.
• The Preferences statement supports the run time changing of the Ask Statements True and False button labels. It also lets you choose the Action Test State Mode.
• The Set Action Test State from Variable statement is now called Set Action Test State. The statement now supports the explicit setting of the test state to True or False as well as to the contents of a variable or named variable.
• The Dump Variables statement can now display the call stack. This may assist in the debugging of complicated actions. Each line in the displayed call stack represents a statement calling an action which has not yet terminated.
• The List Item at Index statement will process each file individually, when run stepwise, if the source and destination are not named variables.
• The Set List Index statement will process each file individually, when run stepwise, if the list is not in a named variable.

      Bug Fixes

• Reduced spurious redraws in the File Browser when displaying a large folder.
• The 'db' field in database files did not support (B) for Beatport.
• The Log statement was failing when a path was not specified and it was running in the Batch Processor.
• The Build List statement was needlessly disabling some field types from the 'source' field.
• Actions exported via Smart Export were not preserving the date/time modified information.
• The Preferences statement was being ignored when overriding the Unique Value Mode. Regression introduced in v3.12.
• It turns out that there were workarounds to allow inline actions to execute recursively.
• The Run External Script statement's Ignore errors option was being reset the next time the action was opened (not run).

Version 3.12 (5014)

      Named Variable Changes

• Named variables now always persist while batch processing. The non-persistant option was a holdback to the application's earlier days and now has potentially breaking issues with the various batch processing modes.
• In the rare event that you created actions to be run through the Batch Processor, which assumed that named variables were empty whenever a new folder as processed, they will break!. It is a good practice to always initialize named variables to the desired initial value.

      Main Window

• New field on the URLs panel called Podcast URL.
• Added support for specifying that a track is a podcast. Note that iTunes only recognizes the setting when a track is first added. Setting the Audio Panel's Media Type field to Podcast will set the appropriate low level metadata for ID3 and MPEG-4 based files. When adding podcasts in ID3 files, iTunes requires that the Podcast URL field contains a well formed URL or it will not be recognized as a podcast. If you do not supply the URL and Podcast is specified, a hidden dummy URL will be supplied. When reading a file, the Media Type field will be set to Podcast if the low level podcast metadata is present.
• There are now five Action-n toolbar items, increased from three.

      Discogs

• We've switched the application to use the custom Discogs authentication method. There is no longer a need to authenticate the application at Discogs. The Force Discogs Authorization and Validate Discogs Access Token menu items have been removed.
• Discogs has increased the number of requests which can be sent in a given amount of time. The application's throttling algorithm has been modified to reflect the changes. Thanks Discogs!

      MusicBrainz

• Better retrying is now performed for 503 and 504 responses.

      iTunes

• New Action menu item called Batch Extract iTunes PIDs. If you want the PID values and you have little or no metadata in your files, this process eliminates the need of dragging the tracks from iTunes into Yate. The process will also identify tracks in iTunes which cannot be located.
• Linking to iTunes by PID silently updates the iTunes location if the file has been moved.

      Custom Panels

• Links to multi item editing panels can now be placed on custom panels.

      Databases

• The Database Viewer's context menu filter items have been enhanced and hopefully been made a little clearer.
• You can now hide selected or not selected rows.
• When database values are being accumulated, numeric fields are normalized to avoid ??? displays for same but textually different numeric fields. This mostly affects Album databases.

      Encodings

• The Multi Field Editor's Re-Encode function, the Re-Encode action statement and the Yate Transformations - Re-Encode to sub-menu, all have new options which are somewhat different than the previous usage of re-encoding from an incorrect Latin-1 determination. They are:

  Unicode UNFC

  When chosen a field will have decomposed accent sequences changed to composed accent sequences. eg. É will count as one character as opposed to two when taking the length of the field.

  Force Latin-1

  The re-encoding provides a forced transformation to Latin-1, preserving as many characters as possible. This differs from the Encode As ISO-8859-1 (Latin 1) statement as it does a smart transformation as opposed to simply trying to change the encoding. It will ensure that decomposed characters are composed; it will do a transformation of those nasty Unicode quote characters, it will preserve accents wherever possible; it will remove accents from characters which cannot be converted; and will change characters which cannot be represented to underscores (_).

  Remove Accents

  The re-encoding will attempt to remove all accents from characters.

  Fold Characters

  This changes various characters to their similar Latin-1 equivalents. Currently this includes single and double quote equivalents as well as dash/hyphen equivalents.

• Rename templates now have a Force Latin-1 option. This is equivalent to performing the Force Latin-1 re-encoding described above. One possible use of this is to ensure that files can be placed into m3u as opposed to m3u8 files while renaming.
• Some users produce CSV files on other platforms and then create the associated sidecar (plist) file via Preferences-Export Sets, if required. When CSV files are produced on non Mac platforms it is possible that the OS cannot automatically determine the file's encoding if accented characters are present. In the past the encoding setting which can be specified for a CSV database was only used for writing purposes. If a CSV file cannot be opened letting the OS automatically determine the encoding, an attempt is now made to open it with the explicit encoding specified in the sidecar file.
• The Read Text File and Write Text File action statements now support the explicit specification of an encoding. You can always do a read and then write of any text based file to process files produced on other systems.
• The list of available encodings for database file creation and the Read Text File and Write Text File action statements now include twelve different possible encodings.

      Preferences

• Preferences-Audio-MPEG-4 now lets you set the rating mapping. Previously it was hard coded to be iTunes (0-100).
• The Preferences-Audio rating mappings now support a new mapping called Direct*2 (0-10). This mapping is used by JRiver Media Center when writing MPEG-4 ratings.
• There are now presets in Preferences-Audio and Preferences-Audio-Configure Full Rating Mapping for JRiver Media Center settings.
• When Yate starts it automatically creates a backup of the application preferences. In Preferences-General You can now configure how many backup files will be retained.
• File to Tag, Rename and Search templates can now be marked as Hidden. When Hidden, a template will not appear on any associated menu. This is useful when a template is used by an action and is not intended to be directly run.
• Replacement set to fields can now be edited in a larger text view. They can still be edited inline.

      Title Case

• The v3.11 Title Case algorithm properly handles multiple sentences being processed. Abbreviations are problematic as they are terminated with periods. You can somewhat get around the issue by making general exceptions which cause the abbreviations to be set to lower case. However, the Title Case algorithm can do much better if it knows that the items are abbreviations. For this reason, Preferences-Exceptions has a new case mode called Abbreviation. This mode is only meaningful in the Title Case word list. In all other lists it is treated as No case change. The mode tells the Title Case algorithm to treat the word as an abbreviation when it is followed by a period. It is a good idea to use this new mode on words such as v, vs and ft.

      Action Manager

• You can now specify that an action should appear on the File to Tag, Rename or Search for Artwork menu as well as the User Defined Actions menu. You do so from the context menu Add to Menu item.
• In the past all actions which effectively started with a File to Tag statement, were automatically added to the File to Tag menu. This mechanism is no longer supported. However, all such actions will automatically be migrated to have the include on the File to Tag indicator.

      Action Editor Windows

• There is now a button in the help panel which will load the displayed help page in the default browser.
• You can now add if-endif and else sequences directly. Previously you could only add if-else-endif sequences.

      New Action Statements

• AcoustID Metadata for ID. The statement can be used to manually extract metadata from downloaded AcoustID data. See the online help for more information.
• Set User Defined Text Item. While UDTIs can be set by the User Defined Fields statement, this new statement is not limited to having the source in a variable.
• Stop Action and Filter Files. The statement allows you to Close, Hide and Select Files, either Matching or Not Matching a chosen filter. The main window's filter functionality now supports the specifying of Variables in filters so that complex non destructive filters can be formulated.
• Restart Batch Processor can only be specified while processing the Batch End inline action. The statement causes the folder traversal to restart. This can be used to create multi-pass actions.
• Open File by the OS. eg. opening a file with a .txt extension will typically open the file via TextEdit.
• Enumerate Tag Set. Useful when you want to write an action based on a variable set of fields.
• Metadata for MusicBrainz Release Id. This statement is used to fetch the metadata for a specified MusicBrainz Release Id saving it to a key value list in a named variable.
• Constrain Execution to a Single File. If you write an action which does not actually use the current file selection, it can be a pain to ignore meaningless action executions in grouped mode if more than one file is selected. This statement causes the action to operate as if a single file was selected.

      Modified Action Statements

• The Replace action statement has new options called Leading and Trailing. They are similar to At Start and At End, with the exception that all leading or trailing sequences are replaced by a single replace with string. As an example, the Trailing option can be used to remove all trailing semi-colons in a field.
• The Stop Action and Open Files statement can now specify multiple paths separated by newline characters.
• The online help for the Move statement now describes the sequence to do duplicate handling.
• When Batch Processing, if you are performing lengthy operations in the Batch Start or Batch End sub-actions, there may not be any progress updates for a while. The Prompt action statement now has a Batch Status mode allowing you to output a prompt message to the Current Folder field in the Batch Processor's progress panel. Doing this too often may slow things down quite a bit.
• Re-Encode modified as described in the above Encoding section.
• The Open Database for Querying statement now sets a prefix-Path named variable. It is the unescaped expanded path used to open the file. The variable can be passed as a parameter to any query database statement to identify the file.
• The Column Value List From Query Database statement now has an ignore empty values option.
• The Create Album/Track Database statements now create the path to the file if it does not exist.
• When sorting the results of a Build List statement and Case Insensitive is specified, the sort will be an as in the Finder sort.
• The Compare Date, Compare Numeric and Compare Text statements now all have an Any option. The default behaviour for stepwise execution is and has been for all files. The Any option, allows you to do a test which will succeed if true for any file.
• The Load and Run statement can now be used when running in the UI.
• The Move Non Audio Files statement no longer displays an error if the source and destination folders are the same. The statement simply does nothing.
• The Add to List statement has new options to disallow adding empty items and/or items already in the list. You can also control how may files get enumerated when adding to a named variable and executing stepwise.
• The Translate Rating statement supports the new Direct*2 (0-10) mapping.
• The Ask, Prompt and Prompt for Text statements have a new Hide Info option. Thise option will hide the action name, associated file and reason text. This can result in a somewhat prettier display.
• The Read Text File and Write Text File statements have been enhanced as described in the above Encodings section. After successfully reading a file the named variable Read Text File Encoding will be set to a textual description of the encoding used. If a file cannot be read due to the encoding, the Read Text File Encoding will be set to Indeterminate.
• The Write Text File statement also now supports lossy and lossless writes. It also allows the testing of content to determine if it can losslessly be converted to a specific encoding.
• The Repeat With, List to CSV and Build List statements allow an empty delimiter so there is no concept of a default delimiter. As this is typically not the case, the statements now pre-initialize to having a delimiter of \~ (the default delimiter's escape sequence). If you want an empty delimiter, you can delete the text.
• The Access Query Database Cell statement has a new convenience function to set a cell to a named variable. This avoids the need to escape a named variable when setting a value.
• All Query Database statements can now identify the desired database by specifying the named variable prefix supplied on the Open Database for Querying statement.

      The Batch Processor

• The Batch Processor now automatically creates a named variable called Batch Phase. 0 implies Batch Start is executing. 1 implies that folder processing is occurring. 2 implies that Batch End is executing.

      The Multi-Field Editor

• The Replace panel has the new Leading and Trailing options.

      MPEG-4 Files

• iTunes may use two atoms to identify the seller of a track. 'sfID' (the iTunes store) and 'xid ' (a vendor ID field). These contents of these atoms are now both displayed in the Seller field. Previously 'sfID' was stored in Seller, while 'xid ' was stored in a UDTI named iTunes Vendor xID. You can read more about the display format of the Seller field on the help page for the Privacy panel.

      Bug Fixes

• The List Contains Test statement was not allowing an empty pattern for 'Equals' tests.
• The Encode As statement did not handle Latin-1 properly. At times, ASCII could be substituted.
• The Multi-Field Editor's Replace function had an extraneous Words checkbox.
• The main window's status bar was not always displaying the longest common path.
• The Access Query Database Cell statement was not accepting an absolute row index of 0.
• The Column Value List From Query Database statement was ignoring the case insensitive option.
• The following Database statements were not properly handling empty paths: Close Database, Update Database, Remove Items from Database, Save Database and Close Query Database.
• Fixed a timing issue which could cause a crash when closing the Beatport Importer window.
• The single export of a Tag Set from within Preferences-Tag Sets was broken.
• Values were not being retained after doing a Set All or Clear All in Preferences-Tag Sets.
• When an action was duplicated, the new action did not inherit the initial action's icon.
• The Rename template IfExists and IfExists+ sequences were not working when a Variable was being tested.

Version 3.11.0.2 (4885)

• Titlecase transformations now handle decomposed Unicode characters.
• Tweaked the Discogs track recognition algorithm.
• The placeholder files in the Batch Start and Batch End sub-actions and the file which is a destination for the Transfer Metadata in action statement are now marked as valid for all file types. This allows you to modify all fields, regardless as to which file types they are valid for.
• Note that the Yate sample action Repair Files from Audio File Health Check Log has been updated for Audio File Health Check v1.1/
• Bug Fix: The Re-Encode action statement's UI was not recognizing the field selection.

Version 3.11.0.1 (4881)

• Discogs site changes required adjustments to get the Discogs Authentication Wizard to operate again.
• Bug Fix: If you cleared the AAC Kind field via a Set or Clear action statement as opposed to using the Set AAC Kind statement, the value was not written out.

Version 3.11 (4879)

Lots of work on artwork retrieval, AcoustID functionality including auto searching for Discog Release Ids, new Grouping retention and more.

      General

• m4b files are now supported and are handled exactly the same as m4a files.

      Main Window

• The main window's status bar now displays common path prefixes as well as unique folder paths.
• New File>Save Selected Files submenu. (Also available on the context menu). This menu provides functionality previously only available via the Save action statement. Forced saves, forced free space removal, etc.
• Grouping fields on the Info editing panel and on custom panels now have a drop down menu displaying previous values. Auto complete is configurable on the Edit >Autocomplete submenu. The list can be edited in the new Groupings Preference panel.
• You can now drag items from the main window's file list area to a different application. This enables you to pass files directly into other various audio players, the Finder, etc. Note that the drag is advertised as a copy, so dragging to the Finder will effectively copy the last saved contents of the file.
• ISRC is now available as a column in the main file list.

      Artwork

• The Search for Artwork menu now has items allowing you to retrieve artwork from Fanart.tv, the Cover Art Archive and Discogs ... and all of them at once. Access to Fanart.tv requires a Fanart API key and you must have authorized Yate to access Discogs through the Force Discogs Authorization wizard.
• You can elect to automatically fingerprint, download AcoustID metadata and extract the various MusicBrainz Ids which are required to access the artwork. Note that when required, Discogs Ids will be extracted, if available, from MusicBrainz.
• The import of Cover Front images can be restricted to the single largest item.
• Discogs searches will search releases and masters.
• Cover Art Archive searches will search releases and release-groups.
• For each artwork source there is an item to selectively choose the various artwork types which are available.
• Every attempt is made to normalize the artwork across albums.
• To make it easier to change the Fanart.tv, Cover Art Archive and Discogs artwork retrieval settings, they are optionally accessable from the Search for Artwork menu.

      AcoustID

• The AcoustID action statements can now import the Year.
• The Get Data from AcoustID functionality now sets a few artifical Network Response property codes to make it easier to determine the exact outcome of the function. The function will also now download release group information at the same time.
• When using the AcoustID Import MusicBrainz Ids statement, pre-existing album metadata is used as a hint. You can now set it to be a requirement via the new Require Album metadata match option.
• The AcoustID Import MusicBrainz IDs statement now provides presets for various option combinations.
• Any AcoustID functionality which imports a MusicBrainz Release Id will now also import the MusicBrainz Release Group URL, if the information is available. This can avoid an extra access to MusicBrainz when deploying a Fanart.tv search.
• The Create AcoustID Fingerprint now creates a UDTI to indicate creation failure.
• Preferences - AcoustID has two new options to make it easier to test if a fingerprint should be generated and if AcoustID data should be downloaded. The options are used by the UI and associated Get Data from AcoustID and Create AcoustID Fingerprint statements.
• The AcoustID menus now support various canned variants of the action statements to obtain the MusicBrainz Ids.

      iTunes

• If you've ever changed the Album, Artist or Title fields and found that you can no longer link to iTunes, there is now a solution, as long as you have not yet saved the files. The Link to iTunes with Initial Values menu item performs the linkage based on the metadata initially obtained when a track was loaded.

      Preferences

• New Preference section called Groupings. This section maintains a list of groupings similarly to the Artist and Composer sections.
• Yate's ID3 audio encoding values allow you to choose the text encoding that best serves your local. Typically, UTF-8 is the preferred setting as it is appropriate anywhere. There are misbehaved applications which expect ISO-8859-1 characters and read the data as such, regardless of the encoding described in the metadata frames. You may find that these applications are incorrectly representing some accented characters. Rather than changing the encoding setting to ISO-8859-1 for all frames, which limits the characters you can represent, you can select the new ISO-8859-1 if possible option. The option will use the specified encoding where necessary, but if no data will be lost, a frame will be encoded as ISO-8859-1. This setting along with the Encode As statement gives you the option of validating the encoding for specific fields programmatically.
• File to Tag templates now allow the specification of sets of delimiter characters as opposed to explicit strings. \*set will match contiguous occurrences of any characters in set. \?set will match at most one character in set. You can now use a single template to match filenames of track title and track-title.
• The Titlecase algorithm has been significantly modified to provide better results. A description can be found in the Preferences-General-Configure Titlecase online help.
• The Names Exception list in Preferences-Exceptions has support for a wildcard matching representation. For example: MacD* can be used to change MACDONALD to MacDonald. This was tedious with forms starting with Mc and O' as many possibilities had to be enumerated. There is a new wildcard form where a pattern can end with a ?. This form works as follows: If a word begins with the text before the ? character, it will use the text before the ?. The next character will be capitalized and subsequent characters will be in lower case. For example MCVIE matched against a name exception of Mc? will be converted to McVie.
• The default unique value setting for new installations has been changed to UUID. These values are now used in various actions for temporary filenames and the historic Yate method may result in stranger filenames. There is no need to change existing Yate ID usages.

      Action Statements

• The Export Replacement Set action statement has been renamed Extract Preference Set and has been significantly expanded. See the online help for more information.
• The Save action statement now allows you to specify that you want free space reduced only if the file is otherwise being saved.
• There is a new statement called Get Artwork from Cover Art Archive which allows you to filter the image types you wish to download.
• There is a new statement called Get Artwork from Discogs which allows you to filter the image types you wish to download.
• The Standardize Case and Fill Lists statements now allow manipulation of the new Grouping list.
• There is a new statement called Get Discogs Release Ids from MusicBrainz.
• More data is downloaded from AcoustID than in the past. The Get Data from AcoustID statement will reload the data even if AcoustID Data exists and it does not contain the lastest information.
• The Normalize Artwork action statement now lets you choose which artwork types are to be normalized.
• Previous to this release certain action statements took a special form of a path. \V# as opposed to supporting full escape sequences. This restriction has been removed. Further the restriction that a specified base path must exist has also been removed. The following statements are affected: Copy, Move, Export Metadata, Import Metadata, Import Metadata from Audio File, the four Symbolic Link statements and Artwork to Folder. In all of these statements, the constructed path must resolve to be absolute (/), relative to the home folder (~/) or relative to the source track (./) or (../).
• The Write Text File, Log, Create m3u Files and Artwork to Folder statements will now create the destination folder, if it does not already exist.
• The Create Track Database statement can now be run during grouped execution. Note that this only makes sense while Batch Processing as it allows you to selectively control which tracks get written.
• The fields in the Delete Non Audio Files statement now support escape sequences.
• The Extract Bracketed Text statement now allows you to insert markertext if you remove the text.
• New escape sequence \+# where # is a variable number. The sequence reads the name of a Yate field from the specified variable and inserts the field's initial value.
• New escape sequence \*# where # is a variable number. The sequence reads the name of a UDTI from the specified variable and inserts the UDTI's value.

      Discogs & MusicBrainz

• The Mapping panel's context menu items used to modify the mapping of files to tracks have been removed.
• The Mapping panels now allow you to show/hide the various mapping settings. These settings now include the ability to set a truncation pattern in Title fields so that you can remove qualifying information such as featuring lists which may hamper file to track mapping. Changes made to these settings remap the files on the fly.
• MusicBrainz imported Artwork URLs now include the artwork type in the item name.

      Bug Fixes

• Exporting individual Exception Sets from within Preferences was not working.
• When importing Artwork URLs from MusicBrainz, only URLs for loaded artwork were imported.
• When artwork was imported from Fanart.tv, the auto resizing settings were ignored.
• If an Export Set was imported, the Preferences list was not resorted until the next time the application was started.
• Some LyricWiki URLs were not being properly escaped.
• The Artwork to Folder statement was flipping the Save All and Save First settings.
• The Import Metadata from Audio File statement was creating the path to the source file if it could not be found.
• The Link to iTunes and Link to iTunes if Modified statements were sometimes losing the use PID option.
• Preferences-Search-Keep List Sorted was not immediately resorting when changed from off to on.

Version 3.10.1 (4737)

• The Write Text File action statement now allows the specification of the text encoding.
• All writes of text files now properly set the OS extended attribute describing the encoding.
• Security updates.
• For those people interested in Stem files, Yate can tag .stem.mp4 files.
• Bug Fix: The Run Context Test statement incorrectly had a Batch+Interact item as opposed to Batch+Stepwise.

Version 3.10.0.1 (4730)

• Enhancement: MPEG-4 files now retain Reverse DNS atoms which have a mean other than com.apple.itunes as General Encapsulated Objects. This allows for the retention of non standard binary items stored by various audio processing applications.
• Bug Fix: The Track Combined and Disc Combined Export Set field types were not importing when Applying Track Database Metadata Changes. Further, the fields were not editable in the Database Viewer.

Version 3.10 (4727)

More work on interacting with database files. A new set of actions which support the querying of databases. Note that there is a new help topic called Query Databases. There are new sample actions on the website. Among them a group of actions to create, maintain and query an artist database for among other things, to look for all albums crediting any combination of artists.

For you shell script writers out there, you can now create and execute scripts on the fly.

      Database Viewer & Databases

• New context menu item: Apply Cell Value to Selected Rows. Eases the setting of fields in multiple rows to the same value. Change a single cell, then apply...
• You can copy the contents of any text cell to the clipboard.
• Columns can be hidden and moved.
• You can now change the font size in Database Viewer windows.
• The ability to produce databases without an associated sidecar file has been removed from the UI (main window and Preferences-Export Sets) and action statements (Create Album & Track Database). The sidecar files are tiny and are were auto-created each time the Database Viewer was run.

      New Query Database Action Statements

• Open Database for Querying is used to open a database for querying. The database remains open until the action or batch processor terminates. Changes are automatically committed. Named variables are automatically created which describe the properties of the database: the number of rows, the column names, the column used as the key column, the column mappings.
• Close Query Database. Query databases are typically closed automatically. You can manually close a query database and save or discard modifications by means of this statement.
• Add Item to Query Database. Creates a new item (row) in the given database with a specified key.
• Remove Item from Query Database. Removes an item (row) in a given database with a specified key.
• Access Database Query Cell. This statement allows you to extract or modify the contents of a query database cell. It also allows you to apply the contents of a cell to the current track(s) being processed.
• Issue Database Query. You can issue text, numeric and date based queries against query database columns. The statement returns a list of matching keys which can be used in Access Database Query Cell statements. The queries operate either on the entire database or on a previous result set. This allows for complex queries to be formulated.
• List from Query Database. This statement is used to produce a list of unique elements in a database column on the complete database or a previous result set from a Issue Database Query statement. The returned list either contains the list of unique elements or the unique elements and their associated occurrence counts.

      Batch Processor

• A new batch processing mode which opens a dragged plist file's associated database for querying. An attempt will be made to locate an associated .csv, .tsv or .tab database file. The file is opened as if an Open Database for Querying statement was executed with the In file option for the key column determination.
• In this mode, no folders are automatically traversed.

      Running Actions

• Actions executed by the Batch Processor do not interfere with the responsiveness of the application as they run almost entirely on background threads. Interactive actions run at times on the application's main thread. Many action statements cause the Action Processor to relinquish control back to the system. Typically when this happens, functions are run on a background thread or interaction is provided with the UI. However, it is entirely possible that an action runs for too long a time without giving the system time to operate. When this happens a beachball will eventually be displayed. The Action Processor now keeps track of how long it has been since control has been returned to the system. If five seconds or more of uninterrupted action execution has occurred, the Action Processor will now automatically give up control for a short period of time. Due to this behaviour, you might see a beachball appear, then disappear, then appear, etc. This new behaviour also enables the Cancelling of all actions regardless of their execution mode.

      Running External Scripts

• The Run External statement now supports escape sequences so that a script's name can be determined at runtime.
• In order to allow you to create scripts on the fly and set the proper execution attributes, Yate will automatically adjust the file attributes of any script file which has a filename extension of yatesh.
• The new sample action Dump Metadata creates, executes and deletes a script on the fly.

      Other New Action Statements

• Load and Run is used to load an audio file and run an action against it. This is only valid while batch processing.
• Repeat Forever. An indefinite loop construct.
• Restart Repeat Forever. Regardless as to how many actions and statements are being processed, this statement will exit until an active Repeat Forever statement is found. If found the statement will essentially be restarted. If not found the statement is equivalent to Stop.
• List from Column. Used to create a list of every element in a specific column of a list of lists.
• Show in Log Viewer. Used to display the contents of a named variable in the Log Viewer.
• Extract Replacement Set. Replacement sets are convenient for storing static lists of information that might be used in more than one action. There are three options: Save a replacement set to named variables, save a set to a simple list or save a set to a key-value list.
• List Combine. Used to form a union, intersection or removal between two lists.

      AcoustID

• The AcoustID Import MusicBrainz Ids statement has a new option to facilitate matching when you know that all the tracks being processed are in the same album. If the best match algorithm is failing, perhaps due to data inconsistencies, the Choose best option can be used in conjunction with the Allow matching to multiple releases option. When this set of options is chosen, the best match will be chosen if available. However, if a best match is not available, the MusicBrainz Release Id which can be associated with the most tracks is chosen for all files, including those without AcoustID data. Any previous MusicBrainz Recording Ids are removed and no additional data will be imported. This may be useful when attempting to find a release id to use with the fanart.tv search functionality.

      Discogs

• While searching Discogs it is possible to explicitly constrain a pattern to a particular database field. In the past Yate has always done this for the Album and Artist search metadata. It has been found that there are special considerations with accented characters and various textual sequences. Yate has numerous workarounds for these behaviours but there are assuredly others. For this reason, you can now make either or both of the search fields explicit or non explicit. Explicit searches operate as before and are constrained to their associated fields. Non explicit searches are not constrained to any particular Discogs database fields. A search which is completely non explicit more closely matches the searches manually performed on discogs.com. It also appears that there are no special considerations for the search pattern for non explicit searches. As explicit searches may potentially return a more constrained set of search results, we are allowing you to pick and choose your search mode.
• There is now a separate field on the search panel where you can specify a Discogs release or master ID. The ID field always takes precedence over the Album and Artist fields. Note that any id=# items previously stored in the Album field's drop down menu will no longer work. The values will be pushed out of the list eventually.

      MusicBrainz

• There is now a separate field on the search panel where you can specify a MusicBrainz release ID. The ID field always takes precedence over the Album and Artist fields. Note that any id=# items previously stored in the Album field's drop down menu will no longer work. The values will be pushed out of the list eventually.

      iTunes

• The Link to iTunes and Link to iTunes if Modified statements now support linking via an iTunes PID property saved to an iTunes PID UDTI. This functionality is primarily intended for users starting to work on tracks contained in iTunes which have little or no metadata. You can drag the tracks from iTunes to Yate, linking them, and save the PID for later use. Note that a retained PID has no meaning in any iTunes library other than the one from which it was obtained. Further, upgrading iTunes to a new version or rebuilding your iTunes database will invalidate any retained PIDs.
• New convenience functions: Save iTunes PIDs and Remove iTunes PIDs. The Save function immediately unlinks the tracks so that the iTunes library contents are not overwritten when the files are saved.

      Other Action Statement Modifications

• Most list functions now provide default values for empty delimiter fields.
• The Access AcousticBrainz statement now has an Ignore Errors option.
• The Close Database statement now sets the action test state to indicate if any files were closed.
• The Database ID statement now supports sets only if the ID is missing or not consistant.
• The following statements now fully support named variables: Case, Find & Remove, List Contains Test, Sort Form, Substring.
• The Prompt for Text statement now supports the showing of a picker menu with a list of user set items.
• The Replace statement now suports matching the last occurrence of a pattern.
• The control variable in a Repeat With statement can now be a named variable.
• The Prompt for File or Folder statement now allows you to specify a list of permissable filename extensions when prompting for a file.
• The Read Track Database Sidecar File has been renamed Read Database Sidecar File as it works with any database sidecar.
• The Encode as ASCII statement has been renamed to Encode as. The statement now permits encoding text as ASCII or Latin-1 (ISO-8859-1).
• The Run, Test, Repeat With, Repeat Forever and Open and Run statements all display a soft error when an inline action is not defined. They also support Create and Open operations on inline actions.
• User Defined. No changes but note that there is a new escape sequence to insert the current value of a UDTI.
• New file property called Network Response. This property is set by functions which do network access on a per file basis. The property is currently supported by Access AcousticBrainz, Get Data from AcoustID and LyricWiki Access.
• New file property called ID3 Version. See the Get Property statement's online help for a description as to how the value is encoded.

      New Escape Sequences

• \~ inserts the default list delimiter character ⏎
• \, inserts the default column delimiter character ➤
• \@<name>. Named variable name contains the name of the named variable to be inserted.
• \ya will insert a track's Yate Album ID
• \yt will insert a track's Yate Track ID.
• \^name^ will insert the value of the UDTI item name. Note that the escape sequence also work if the UDTI is mapped to a custom variable.
• \H will insert the path to the home directory.

      Action Editor Windows

• Text fields have a new context menu to facilitate inserting escape sequences.
• Text fields have a new context menu to facilitate inserting common UDTIs.
• You can now do text searches via the standard Edit>Find menu items.
• New Action Groups added and we (hopefully) cleaned up what appears in each group. Of import to note is that the Variable group is gone. Most of what was in there is in the new Assignments group. The Dump Variables statement is in the Prompt category as it always was.

      Main Window

• New Actions menu items named Save iTunes PIDs and Remove iTunes PIDs. These menu based functions are convenience methods to save and remove the PIDs.
• When all selected files are in the same folder, the status bar will display the path as well as the track counts and duration.
• There are no longer restrictions as to the number of image files which can be dragged in at a time.
• There are no longer restrictions as to the number of m3u(8) files which can be dragged in at a time while in Playlist mode.
• New Open Mode toolbar item which does not have the Link/Do Not Link to iTunes button.

      Auto Search for Artwork

• If you get an error indicating that you have been searching too much, there is a new Artwork menu item called Fix Too Much Auto Searching Error. The function allows you to respond to a catcha to prove that you are not a robot.

      Snapshot Editor

• The Snapshot editor can be opened if more than one file is selected. The editor will display the tags in the first selected file.
• The Properties subtree now displays all properties available via the Get Property statement.
• You can copy the value field of any displayed item to the clipboard.

      Preferences

• When exporting a single Export Set, you can now export the set, export a sidecar file, export an empty database or export an empty standalone database. The empty database option is useful for creating database files for use in another application and is a way of creating empty Query Databases.
• In General Preferences you can now configure the Titlecase algorithm.
• File List preferences has a new option to update open databases whenever you Save files. Note this option is equivalent to selecting File>Databases>Update Databases whenever a Save, (File or context menu), is issued. The option has no effect when saving from an action statement, closing files, or quitting the application.

      Bug Fixes/Modifications

• Scrolling Database Viewer tables while accumulating images often displayed a beachball on El Capitan.
• Artwork Thumbnail controls on custom panels were not always positioned correctly.
• Improvements to the AcoustID functionality to better handle invalid data.
• Certain keyboard shortcuts were not being preserved after restarting the application.
• Most database statements were not properly handling Unique File Identifiers and named Comments.
• The Read Track Database Sidecar File statement had a few issues. In order to maintain compatibility with the Open Database for Querying statement it now uses \~ as the delimiter as opposed to \n.
• On El Capitan, the Window menu's Full Screen Mode item can now be modified in Preferences-Shortcuts.
• The Database view has to remove the current filter before looking for duplicates.
• The Evaluate Expression statement was messed up when run stepwise.
• The Set Open Mode statement was displaying the wrong mode for Album-Replace.
• Importing iTunes values while on the 'Compare iTunes Values' panel did not always import.

Version 3.9.1.1 (4590)

• Adjustment: Yet another change to Auto Search for Artwork.
• Bug Fix: When importing Fanart.tv CD images, the first track which should have received the image was not modified.

Version 3.9.1 (4588)

• The User Defined Fields statement now has a picker to choose common item names.
• When adding a named component to a Custom Panel, a picker is available to choose common item names.
• When adding escape sequences via the context menu in Action Editor text fields, holding down the Shift key, will insert the unescaped name.
• The context menu in Action Editor text statements now has a Yate Named Variable submenu, to insert the special purpose named variables directly set by Yate.
• While Batch Processing, the Access MusicBrainz and Get Artwork from Fanart.tv functions enable testing for Service Unavailable errors from MusicBrainz.
• New escape sequence \&#### where #### is exactly four hexadecimal characters. This sequence can be used to specify any UTF16 character.
• Bug Fix: The Video Classification field's function button had a Key Notation menu as opposed to a Classification Preset menu.
• Bug Fix: Inserting escape sequences from a context menu was throwing errors in Action Editor single line text fields.

Version 3.9 (4581)

In this release we mostly concentrated on Yate databases (CSV/TSV) files and the handling of the files, both attended and unattended. There are also new lookup modes when accessing AcoustID, Discogs and MusicBrainz. ... and you can now search for a variety of artwork on fanart.tv.

      Apply Track Database Metadata Changes

• Available from the Actions menu, this function is a special form of the Batch Processor. You supply a Yate Track Database, (a CSV/TSV file with a File Path column) which is automatically read. All changes in the file are applied to the associated tracks. Changes can be optionally pushed to iTunes as well.
• This means you can take a CSV/TSV file anywhere, make changes and apply them at a later date without having to open the database or load the tracks.
• Note that this is not a synchronization. The metadata in the audio files is updated with any different data found in the database file.

      The Batch Processor

• The Batch Processor automatically sets three named variables before executing Batch Start, the main portion of the action and Batch End. The variables are:

  Batch Root Folder

  The folder passed to the Batch Processor.

  Batch Auto-Save

  1 if the Auto-Save Files option was selected, 0 otherwise.

  Batch Verbose

  1 if the Verbose option was selected, 0 otherwise.

      Support for fanart.tv

• fanart.tv is an excellant source for a variety of artwork. You must register and then request a Personal API key at their site and enter the API key into a new field on the Preferences-Artwork panel. Unlike other Artwork functions which attempt to group albums, this functionality uses MusicBrainz Ids to request the artwork. Only tracks with MusicBrainz Release IDs will be processed. Other required MusicBrainz IDs will be downloaded if required. See the new action statement's online help for additional information.
• The functionality can be accesed in the UI from the Search for Artwork menu and via the new Get Artwork from fanart.tv action statement.
• We're happy to be able to provide access to the fanart.tv site. Artwork contributions are appreciated.

      AcoustID, Discogs & MusicBrainz

• The Access Discogs and Access MusicBrainz statements have a new mode called Track Matching. Only those tracks which have a release ID and the same qualifying IDs required by Release Matching will be processed. The release ID does not have to be the same in all tracks. Tracks which have the same release ID are processed as a group. This method is useful when you have tracks from different releases in the same folder.
• The AcoustID Import MusicBrainz IDs statement has a new option called Allow matching to multiple releases. This option will look at all the available tracks and assign them to releases by trying to match the largest number of tracks possible to any one release. This method is useful when you have tracks from different releases in the same folder. The AcoustID MusicBrainz release ID extraction functionality can be summmarized as:

  AcoustID Import MusicBrainz IDs - Allow matching to multiple releases-unchecked

  Try to find a single release containing all tracks.

  AcoustID Import MusicBrainz IDs - Allow matching to multiple releases-checked

  Find the minimum number of releases to contain the tracks.

  AcoustID Import Track Metadata

  Only look at individual tracks.

• All AcoustID functionality automatically imports the MusicBrainz Release Country if a MusicBrainz Release Id is imported.
• The AcoustID functionality now better handles the case of duplicate tracks (ie. the same fingerprint) in the same folder. It is also much better at matching tracks in compilations.

      Multi Field Editor

• The Replace function has a new mode to replace all occurrences of individual characters in the match pattern.

      Action Statements

• New escape sequence \=# where # is 0-9. The sequence is used to indirectly load the contents of a Yate field where the name of the field is in a Variable. The escape sequence and the above Set Indirect statement use field names as they are displayed in the Multi Field Editor.
• New action statement called Get Artwork from fanart.tv.
• New action statement Set Indirect. The statement is used to set the contents of a Yate field where the field is determined at runtime. This is useful when processing metadata changes found in CSV/TSV files where the columns can be assigned to arbitrary fields.
• New action statement Read Track Database Sidecar File. If you want to provide processing on an arbitrary database file you can use this function to obtain information on the column to field mappings.
• New action statement Set List Index. The function is used to change the content of a Yate list at a particular index.
• New action statement called Length which is used to extract the length of a field or named variable.
• The List Contains Test functionality has been extended so that contains tests as well as equality tests can be performed. Using the function you can now search for column specific information such as a Yate Track ID or a File Path within a database file which has been formatted as a list-of-lists by the CSV Data to List statement.
• The Preferences action statement has been expanded. See Preferences below.
• The Transfer Metadata statement's functionality has been expanded.

  Transfer metadata In - Set initial values

  In addition to establishing the current values, this option sets Yate's initial values. This means that you can test for modifications made after the transfer.

  Transfer metadata in - Create Properties list

  As the Transfer Metadata statement imports metadata to a staging file, you do not have access to the source file's audio properties such as Stream, Bit Rate, etc. With this option a Key-Value list is created which contains most of the source file's properties. The List Key statement can be used to read the properties.

  Transfer metadata out - Only if modified

  When set, the transfer out will only occur if the staging file has been modified.

• The Prompt statement has a new Plain Text option. While batch processing the option forces the saving of the text to the log file without the associated issuing action information.
• Major enhancements to the AcoustID Import Track Metadata statement. See the online help for more information.
• The AcoustID Import MusicBrainz IDs statement has a new option called Allow matching to multiple releases.
• The Sort List statement can now sort based on sub-list items.
• The Artwork to Folder statement now allows the saving of artwork matching a specified picture type.
• The Rearrange Artwork statement now bases the largest test on width*height as opposed to width+height.
• The Replace Text function has a new mode to replace all occurrences of individual characters in the match pattern.

      Preferences

• When exporting a single Export Set which is valid for use with a Track Database, you are presented with the option Export as Track Database Sidecar. This means that you can now produce CSV/TSV files external to Yate and later provide the appropriate column mappings so the the Database Viewer bi-directional passing of metadata can be performed.
• Preferences - Export Sets has a new field type called OOB for Out of Bounds. This field type can be used to map to unknown column types in CSV/TSV files generated external to Yate.
• Preferences - Actions has a new option to configure how Yate generates unique values. Yate generates unique values with the Database ID statement and via the \u escape sequence. In the past a proprietary method was the only available type of unique value generated. You can now choose to generate Yate (old style), UUID (Universally Unique Identifier) or GUS (Global Unique String) values. The Preferences action statement has been modified so that you can override your default setting in an action.
• Preferences - Actions now lets you choose from a few possible backgrounds for the Action Manager and the Action Editor statement panel.
• Preferences - Artwork has a new field for the fanart.tv personal API key.
• AcoustID settings have been moved to a AcoustID preference panel.
• There is a new Preferences - AcoustID setting to prioritize complete albums over country codes.

      Main Window

• You can now close files which are not selected.
• Multi line panel editor fields now display blue if they contain invalid characters. Note that while newline characters are not invalid in these fields, carriage control characters are.

      Custom Panels

• Named Comments, User Defined URLs and Unique File Identifiers can now be added to custom panels. Along with User Defined Text Info items, these item types are the only items which can be added to a panel more than once.

      Bug Fixes

• The Multi Field Editor's Remove & Insert function had issues retaining its numeric settings properly.
• The Multi Field Editor's Remove & Insert function was not correctly calculating the remove from the end index. The last character is at index 0 when removing from the end.
• If only a single artwork item was preloaded from the Cover Art Archive when running the MusicBrainz Wizard, specifying that the remainder should be loaded only did one more.
• Fixed a hang when running Access MusicBrainz while Batch Processing. The hang was metadata dependant.
• User Defined Text Info items on custom panels were not always updating their change indicators. They also had issues with choosing values and reverting to a previous state.

Version 3.8.1.3 (4484)

• Changes to the file structure were not being detected in the File Browser under El Capitan.
• Better handling of titles on El Capitan Open/Save panels.
• Force options panels open on El Capitan Open panels.
• The ability to view artwork in the Discogs Wizard was not available when a release was loaded and the Artwork checkbox was previously unchecked.
• Enabled all Actions menu items to allow keyboard shortcuts.

Version 3.8.1.2 (4481)

• Fixed some El Capitan issues.

Version 3.8.1.1 (4480)

• Fixed a crash which could stop Yate from starting after updating. The crash is dependent on which version you were updating from. If you are experiencing the crash, please manually download the new build which fixes the issue. If you have not seen the crash after updating to v3.8.1, you can safely update to this version from 'Check for Updates'.

Version 3.8.1 (4479)

• Some fixes for El Capitan 10.11.1.
• Feature Request: The Actions, File to Tag, Rename and Search for Artwork menus are now available on the main window's context menu. Remember that you can hide context menu items via Preferences - File List - Context Menu Items.
• New Batch Processor data file processing mode. The mode is intended to be used when you want to parse a data file (.txt, .log, .csv, .tab, .tsv) which contains file paths and metadata to be applied. In these cases you do not need to supply a root folder to the Batch Processor. To trigger the new mode, simply drag a text file to the Batch Processor wizard's target icon. A dummy audio file will be supplied for the action. The full path to the text file will be saved to named variable Batch Data File. The contents of the data file will be preloaded to named variable Batch Data File Contents. The sample action Repair Files from Audio File Health Check Log, which parses a text file, has been modified to run in both batch modes.
• New action statement called Cancel. The online help for Stop, Stop Batch Processing and Cancel describes the differences between the three statements.
• New escape sequence ! used to access file properties from action text fields. Escape sequences with appropriate property names can be generated via a text field's context menu. example: \!Creation Date!
• The Log action statement can now write to the batch processor's log file.
• Tweak: Auto search for artwork is working again. Even larger artwork items may be returned.
• Tweak: The Lyric Wiki action statement is working again.
• Bug Fix: The Dump Variables action statement now handles long text streams when batch processing and writing to the UI.
• Bug Fix: The Log action statement's Log Changes mode was not working.
• Bug Fix: When Preferences-Artwork Album and Track Database Image Source was set to None, the viewer's Apply, Update and Delete context menu items were hidden.

Version 3.8.0.1 (4461)

• Regression: The action Unattended Metadata Lookups was not built in as intended. This patch is to fix new installs. Anyone missing the action can find it on the Sample Actions page accessable from the Help menu.
• Bug Fix: The new AcoustID Import Track Metadata action statement had two options flipped.
• Bug Fix: Show File References was not working on some multi-item editing panels.

Version 3.8 (4458)

Main features this release:

• Yate now handles video tagging in MPEG-4 containers. (m4v now supported and mp4). Note that the files must contain at least one audio track.
• The downloading of Discogs artwork is back.
• There is a new snapshot editor which lets you see all the tags in a single file.
• Metadata can be imported from Beatport.
• The is a new companion application called Audio File Health Check which can be downloaded from the Help menu. Audio File Health Check is an application used to scan your audio collection and produce a log file of errors in the files. An action can be downloaded to repair the files identified in the log.

      Application

• Previously, Yate always used m4a as a descriptor for m4a and mp4 files. With the introduction of support for m4v files the container type is now referred to as MPEG-4. Note that the file format is the same for m4a, m4v and mp4 files.
• All references to Audio Stream including column headers, filters, etc. have been changed to Stream.
• A new wizard is provided to authenticate Yate to access Beatport.

      Main Window

• Single line text fields now display blue if they contain any control or newline characters. Previously the highlighting only occurred for newline characters.
• Yate text field context menus now have a Remove Invalid Characters menu item.
• New editing Video panel.
• The Sorting editing panel has additional video based fields.
• Audio properties now refers to the Stream as opposed to the Audio Stream. MPEG-4 files will display video after the audio stream type, if appropriate.
• New columns added for Episode, Episode ID, Season, Show Name.
• New column called A/V which displays either Audio or Video.
• Three new toolbar items called Action 1, Action 2 and Action 3. These toolbar buttons will run actions which can be assigned to them from the Action Manager context menu. Note that the tooltips for the buttons will name the associated action.
• A new toolbar item for the Beatport Importer.
• Made the selection of dragged and loaded files more consistant. When you drag files or open files, they are selected, regardless of the Open Mode and regardless as to if the files are already loaded, hidden or not.
• The function menu for Musician Credits and Involved people now has an Append to Values menu item when more than one file is selected. It's an easy way to add common roles to files containing different values.
• The function menu for Initial Key now has a Key Notation submenu where you can change the field's value to a different representation.
• There are new options to draw a grid around the table cells.
• Double clicking on a row in the main file list will display the Artwork Viewer if clicked in the Artwork Column. Double clicking in any other non inline editable column will display the Snapshot Editor.
• The Subtitle field has been renamed Description. This makes more sense as the field maps to the iTunes Description field, it is used on the new Video panel and is used by the Beatport importer to store the mix name. The ID3 specification calls the field Subtitle/Description. If you were using the escape sequence \[Subtitle] in an action, it will continue to work as expected, however \[Description] is now the preferred form.

      Snapshot Editor

• You can now view and edit a snapshot of all the tags in a single file. Access via the Edit menu, the main window's context menu or a toolbar icon.

      Video Editing Panel

• There is a new editing panel called Video.
• New tag fields: Classification, Episode, Episode ID, Hi Def Video, Network Name, Season, Show Name, Show Description and Video Description. Sort Show Name is available on the Sorting panel.
• The new fields can be synched with iTunes. See Preferences below for more information.
• The function button for the Episode ID field has a Synthesize item which is used to build a S##E## string from the Season and Episode fields.
• The function button for the Classification field has a Classification Presets submenu allowing you to easily choose predefined classifications.
• Yate now handles the iTunMOVI atom so that cast, producers, directors, codirectors and screenwriters can be synchronized with iTunes. There is a new option to enable this functionality as it overwrites information in the Musician Credits, Involved People and Label fields.

      Discogs Artwork Changes

• The downloading of Discogs artwork is now rate limited to twenty per minute per IP address. This is far better than 1000 per day per application. Thanks Discogs!
• The downloading of Discogs artwork has been reintroduced into the MusicBrainz and Discogs Wizards.
• The artwork requests are not time sliced. Time slicing the requests would allow one to be sent every five seconds. The implemented algorithm bursts the requests to obtain as may images as possible. This means that if a release you're looking at only has five images they will come down in about five seconds as opposed to twenty five seconds. Yate synchronizes all image requests to Discogs to ensure that the rate limiting requirements are met. That means it is possible that after rapidly downloading twenty images you may have to wait 40-50 seconds before another request can be made. The application displays the wait state and the next go time wherever appropriate.

      Discogs & MusicBrainz Wizards

• Both wizards feature a redesigned artwork viewer which contains an image strip of loaded artwork. Hopefully this is better then next, next, next....
• The image strip tags images which are Cover (front) with a star.
• The new artwork viewers display the state and origin of loaded and pending artwork. They also display the time that Discogs artwork loading can be resumed.
• You can now control how much artwork gets preloaded when loading a release. (See Preferences). You can initiate the download of unloaded artwork the artwork viewers and from the Release panels which now display the new image load state information on the Artwork metadata item.
• More work has been done on sanitizing album fields passed to Discogs in order to achieve better search results.

      AcoustID

• A new matching algorithm to match tracks as single entities. This is useful to extract basic metadata when a best match for a release cannot be found.

      Beatport Support

• Beatport metadata extraction is provided via an action statement named Access Beatport. The function requires a Beatport Track Id which is embedded in purchased mp3 and aiff tracks. All purchased tracks have the Track Id as a prefix in their filename. Yate will look for the Track Id in a variety of places. The function is of most use for purchased WAV files which come with no metadata.
• There is also a UI based Beatport Importer which allows you to interactively search and select best matches based on metadata, file names or Track Ids. Note that if you have the required Track Ids, the action statement is far more efficient.

      Text Encoding

• The ID3 specification uses ISO-Latin-1 as its 8 bit text encoding. In the past before UTF8 was supported, many people specified their mp3 fields in a variety of languages which contained characters not supported in ISO Latin-1. When these files are read by Yate, fields which specify an encoding of ISO Latin-1 may not display the correct characters if in fact they were not ISO Latin-1 characters.
• Yate now allows you to specify the original encoding and will attempt to re-encode the text according to that encoding. Note that if a field currently contains characters which cannot be represented in ISO Latin-1, no modifications will occur.
• The re-encoding can be performed in the Multi Field Editor, via the new Re-encode action function and via the Yate Transformations submenu in a text field's context menu.

      Action Functions

• Variable fields are no longer cleared when executing a Save or Revert action statement.
• The Trim statement now supports the normalizing of newline sequences to Mac based newline characters.
• When trimming the Comments, Lyrics, Terms of Use, Commercial Information Webpage or Official Artist/Performer Webpage fields only the default items are modified. If you would like the trim statement to modify all of items for any of these field types, select the new deep option. The option has no effect on other field types.
• New property called Has Video which can be used to determine if a file contains video track(s).
• The Save function now exposes an option which was previously only available as a hidden feature. The Save if mp3 has leading padding will do as it says. Note that leading padding is typically benign. However, If you have files which are not playing correctly or which cannot be fingerprinted, removing the leading padding may fix the issue. We do not like messing with the audio stream. Only do this if for some reason you feel that the audio track is not behaving correctly.
• The Field List Enumerator statement now supports Unique File Identifiers. You can also specify that you want an index list as opposed to a list containing descriptor names. This is useful when looking for duplicate items. Note that when enumerating Artwork an index list is always produced.
• The User Defined Fields statement now supports Unique File Identifiers. You can also now match items by index as opposed to matching a name. More information and limitations are described in the function's online help.
• The is a new Access Beatport statement.
• New AcoustID Import Track Metadata statement.
• New Re-encode statement used to change the encoding of text.
• New Key Notation statement used to change the representation of the musical key between a variety of notations.
• There is a new escape sequence \{field name}. This sequence will insert the initial value of a field. The initial value of a field is the value when the file was loaded or last saved. Most action text fields have a new context menu submenu called Insert Initial Yate Field which can be used to pick the field names.
• New Transfer Metadata statement. The statement is used to transfer metadata in from or out to an audio file. The statement can be used when parsing text files to apply changes to files.
• The Preferences statement has been expanded to support all the special exception/replacement sets currently available. It also now supports setting single preference values from a drop down list in order to override the value associated with the setting. Currently only the new Named Variables Persist option is supported. Preference changes made via this statement get reverted when the batch processor terminates or an action being run from the UI stops.

      Action Manager

• New context menu items to set asociations with the main window's new toolbar Action 1, Action 2 and Action 3 items.
• You can display a popup window which contains an action's description by means of the Description... context menu item. An actions's description is the first non empty text in leading Force Grouped or Comment statements. Hitting the space bar has the same effect.
• The Dump Variables action statement is now displayed in red to make it easier to quickly locate debugging statements.

      The Multi Field Editor

• The Trim function now supports the normalizing of newline sequences to Mac based newline characters.
• When trimming the Comments, Lyrics, Terms of Use, Commercial Information Webpage or Official Artist/Performer Webpage fields only the default items are modified. If you would like the trim operation to modify all of items for any of these field types, select the new deep option. The option has no effect on other field types.
• Added a Re-encode function.

      Preferences

• Preferences-File List
  • New option called Do not enforce formatting of the Year field. When set, the Year field will not be UI restricted to a single integer. The field will be able to contain anything. Changing the option only takes effect when the application is next started.
  • New options to draw a grid around table cells.
  • Removed the Auto select tracks on open (Album mode, Replace) option. File selection is hopefully now more consistant.
  
  
• Preferences-Actions
  • By default, named variables are erased whenever an action started from the UI terminates or after each folder is processed while batch processing. There is a new option called Named variables persist while batch processing which allows you to use named variable content across folders while batch processing,
  
  
• Preferences-Audio
  • All
    • New option to automatically set File Type to a file's extension when loading a file.
  • MPEG-4 has two new options to assist in synchronizing fields to iTunes. Yate attempts to avoid writing empty tags fields to files. iTunes however, will never overwrite a tag field in its database when rereading a file which does not contain the tag field. Yate typically handles this case programmatically when refreshing iTunes. However, certain fields cannot be written to iTunes programmatically. For these fields you must write empty tag values or iTunes will not update when refreshed.
    • Write Empty Content Advisory will cause the associated field to always be written. This was the previous behaviour. If you do not wish to do so, you can now disable it.
    • Write empty video fields handles the empty value case for the new video fields which cannot be programmatically set. This only affects the Classification, Hi Def Video, Network Name and Show Description fields. Note that empty fields will not be written, if the file does not contain a video track.
    • Process iTunMOVI for files with video will do as the name suggests. When enabled, the Musician Credits, Involved People and Label fields will be synchronized with the video role information that iTunes maintains.
    
    
• Preferences-Discogs
  • Import all artwork is analogous to the same option in the MusicBrainz preferences.
  • Always use imported artwork metadata is analogous to the same option in the MusicBrainz preferences.
  • A new artwork preload popup button which allows you to preload no artwork, a single artwork item or all artwork.
  
  
• Preferences-MusicBrainz
  • A new Cover Art Archive Artwork preload popup button which allows you to preload no artwork, a single artwork item or all artwork, coming from the Cover Art Archive (the artwork location referenced from MusicBrainz content).
  • A new Discogs Artwork preload popup button which allows you to preload no artwork, a single artwork item or all artwork, coming from Discogs.
  
  
• Preferences-Rename
  • New template items:
    • Episode
    • Episode Pad2
    • Episode Pad3
    • Episode ID
    • Hi Def Video
    • Season
    • Season Pad2
    • Show Name
    • Sort Show Name
  
  
• Preferences-Replacements
  • The from string associated with a replacement is typically a simple text string. You can now specify that a replacement is only to be made if the from string is at the beginning of the source string, follows a newline character or follows a list of supplied characters. Note that when searching backwards for one of the previous conditions, space characters are ignored. The special characters are specified by starting the from string with the sequence \{characters\}. For example a replacement of:

    from:

    \{.-([<{:&'"?!/\}the (ends with a space)

    to:

    The (ends with a space)

    will change the word the to The as long as it is at the beginning of a string, after a newline character or after one of .-( [ < { : & ' " ? ! /

      Audio Files

• Yate now contains work arounds to fix malformed ID3 frames in BeatPort MP3 and AIFF files.

      Bug Fixes

• The audio properties table was displaying an ID3 version for FLAC and MPEG-4 containers.
• The transient link to the GEOB panel on the Privacy panel was broken.
• The Score column on the Discogs and MusicBrainz mapping panels could not be resized.

Version 3.7.1.2 (4276)

• Bug Fix: Fixed some UI issues in the Multi Field Editor's Trim Function.
• Bug Fix: The Discogs Wizard's Load More feature had problems since switching to authenticated searches.
• Work Around: Discogs searching seems to fail on album names that begin with a single character such as A or I.

Version 3.7.1.1 (4265)

• Bug Fix: The Folder Tags statement was broken.
• Bug Fix: The Show All Files submenus were not properly hooked into the shortcuts system.

Version 3.7.1 (4262)

      Action Manager

• You can now associate canned icons with actions and action folders. These icons are for identification purposes only and are much like Finder Tags. You add or remove the icon association via the context menu Set Action Icon and Set Folder Icon menu items

      Action Statements

• The Move Non Audio Files statement now has a move subfolders option. More information in the online help.
• The Finder Tags statement can now process Finder tags associated with containing folders.
• New action called Log which is equivalent to the File>Log UI functionality.

      Preferences

• Artwork preferences has a new option to only auto scale images if they are almost square. Almost square is defined as the absolute difference in the width and height being less than 1% of the larger of the two. This option is useful to avoid losing resolution on images which you will eventually crop.

      Main Window

• The crop panel now has the ability to scale an image down after cropping.
• Fixed the inconsistant usage of File Type. Previously the main window File Type column was used to describe the container type, yet File Type is a metadata field on the Audio Panel. File Type now represents the standard metadata field. (column, editing panel, filter editor, export sets). There is a new column called Audio Container which describes the container type. (column, filter editor, export sets).

      Audio Files

• Added some additional correction/detection code for malformed FLAC and WAV files.
• When it is detected that a file cannot be located, Yate will now automatically attempt to reconnect to the last known location before raising an error. This solves the problem of NAS or external drives going away and then being mounted again.

Version 3.7 (4184)

      32 Bit Support Dropped

• We polled you over a year ago asking for opinions on our support for Snow Leopard and 32 bit architectures. We didn't rush into this decision, but based on your feedback 32 bit support has now been dropped. Not to worry...Snow Leopard support is not being dropped!

      Support for DFF Files

• Support has been added to directly tag DFF files. While there is no firm standard in place, the same approach was taken as is used in WAV files. Various other applications and hardware rippers are starting to use the same convention.

      File Browser

• The File Browser now attempts to return to the previous selection state when the Back button is hit.

      Database Viewer

• Yate's CSV viewer has been renamed the Database Viewer. It will now read/write CSV (comma separated values) and TSV (tab delimited values) files.
• The Save As functionality now supports the explicit specification of the field delimiter, the character encoding and the line terminators to be used.

      Main Window

• You can now write the data displayed in the main file list as a CSV or TSV file via the new File>Save As CSV/TSV File... menu or context menu item. All visible columns with the exception of the change status column and the Artwork, and iTunes columns will be processed.
• Thumbnail artwork views outside of a full artwork display now have tooltips describing the associated properties.
• The file list has four new columns: Creation Date, Modification Date, Mood and Play Count.
• The file list Select Files context submenu now has new items: Not in Same Folder, In Same Folder, With Different Column Data and With Same Column Data.
• You can now hide and select files based on the same or different Album data. The Select Files sub menu is now available on the application's File menu so that items can be assigned to shortcuts.
• Edit Panel button context menus now display custom panel assigned names.
• The column header context menu now displays the current names assigned to Custom fields and the Mapping columns.
• New toolbar item to open the Recent/Sticky Items menu.
• A new File menu, context menu and toolbar item to refresh the loaded files. The Refresh command tests all loaded files to see if they were externally modified. If they were, you will given the option to reload the files. You can optionally set that all modified files be reloaded if no changes will be lost. This is a convenience function that need only be used in you are possibly modifying the same files in Yate and at least one other application at the same time.
• The Filter function has a new test called Externally Modified, which can be used to filter on files which would be identified by the new Refresh command.
• The Filter function has a new test called Modified, which can be used to filter those files which have been modified with unsaved changes. (Red dots).

      The Multi Field Editor

• New layout...hopefully far less cluttered.
• Copy now supports Only copy if the source field is not empty and Only copy to empty destination fields. The function now supports copying fields or property values.
• Replace now supports Or matching.
• Sort Form added as a function.
• All content is now retained when Yate is closed.

      AcoustID

• When the Import AcoustID Recording Information window is displayed, an attempt will be made to find the best release containing all of the selected tracks. More than one track must be present. A new context menu function is available to select the best release for all tracks. More information in the online help.
• New action statement AcoustID Import MusicBrainz IDs. The statement will attempt to find the best release containing all the selected tracks. If a release can be identified, the MusicBrainz Release and Recoding IDs will be imported. Optionally the Album, Artist and Title fields can be imported as well. If the function succeeds there will be sufficient metadata in place to use the Access MusicBrainz statement while batch processing. This means that MusicBrainz can be accessed while batch processing even if the Release and Recording ids are not initially available.
• The is a new preloaded action (on new installs) called Unattended Metadata Lookups. You can get the action off the Sample Actions web page or you can import the set of updated preloaded actions by holding down the Alt (Option) key and selecting the Yate>Reset Built In Items>Import Actions menu item. Note: make sure that you hold down the Alt (Option) key, otherwise you will overwrite your existing actions. After the import the action manager will have a Preloaded Actions folder.

      Discogs & MusicBrainz

• When on the Search page of the wizards, if you have a properly formatted Release Id in the system clipboard, you can paste it in via the Command-I (⌘I) keyboard shortcut. The Album search field will be set appropriately and the Artist search field will be cleared.
• In order to use the above command more effectively when copying a release from the Discogs site, enclosing square brackets and a leading r will be removed when constructing the id=release id sequence. ie. [r12345] in the clipboard will be identified as release 12345.
• Found and now account for new out of spec Discogs method to separate disc/track numbers.
• The weight algorithms used for mapping files have been tweaked once again. Matching albums with multiple instances of the same title should be better.
• Added Remap Using Custom Settings and Configure Custom Remap Settings... context menu items. These give you full control over remapping the files based on your own knowledge of the formatting of the filenames and what metadata is available.
• The Access Discogs and Access MusciBrainz action statements both have a new mode called Loose Release Matching. This mode requires a consistent Release Id but does not require ordinal positioning metadata. This method increases the likelihood of accessing the online sources when batch processing. If sufficient metadata is present such that loose matching is not required, the option will automatically be removed.
• When using Access Discogs or Access MusicBrainz, the action test state will be set to true if an attempt is made to contact the service. If there is insufficient or inconsistent metadata, the action test state will be set to false.

      File to Tag

• File to Tag menus can now display a sub-menu called File to Tag Actions. Any action where the first executable statement is Filename to Tags will be displayed in the sub-menu. This is to make it easier to locate actions which are essentially providing additional metadata manipulations after performing an initial extraction from the path.

      Preferences

• A new Preferences-MusicBrainz option to specify a list of preferred country codes (two character codes). The country code list is used by the AcoustID best release matching algorithm to determine the best MusicBrainz release id.
• Disc, Title and Track are no longer treated as special Export Set fields. They are now in the lower portion of the export type list with the other standard field types.
• All items that can be displayed as columns in the main list of files can now be specified in Export Sets (with the exception of the change status column, and the Artwork and iTunes columns).
• The full Rating Mapping display in Preferences-Audio now has a picker for preset settings.
• Preferences-Audio now has a picker for preset settings.
• When reading the rate atom as configured in Preferences-Audio-m4a, Yate's default rating storage method is preferred on a mismatch. There is a new option called preferred on mismatch which places the rate value at a higher priority.
• The Custom Field configuration in Preferences-File List now has presets for Acoustid Data and Acoustid Fingerprint.
• Token Editor context menus now display the names currently assigned to Custom fields. Note that the token being inserted is associated with the Custom field number and not the current name. This is only a convenience.
• You can elect to play a sound for the Batch processing finished notification. The sound option is only used in conjunction with Notification Center.
• A few context menus and submenus now display a How to Use this Menu item. There is a new General option to hide these menu items.
• When a Tag Set is loaded into a field table display (various actions such as Append and the Multi Field Editor), the sort is now automatically changed to descending by the state column. This is to make it easier to quickly see what is enabled. The context menu in any Tag Set display now has an Enable/Disable Auto Sort item. Note that the setting is global and affects all Tag Set displays.

      Action Statements

• New action statement AcoustID Import MusicBrainz IDs described above.
• The following action statements now support named variables: Append, Get Next Line, Prompt for Text, Prompt for File or Folder, Replace, Stop and Open Files, Set Action Test State from Variable and Set Variable to Action Test State.
• The Dump Variables statement is now valid while batch processing. By default the statement writes to the log file. There is a new UI option to force display to the UI.
• The Export Metadata action statement has a new Text only option. When enabled, only a single plist file will be created. Artwork, General Encapsulated Objects and Private Information Items are ignored.
• The Close Database, Open Database, Remove Items from Database, Save Database and Update Database statements now require paths with filename extensions of .csv, .tsv or .tab
• The Create Album Database and Create Track Database statements now allow the implicit specification of a Comma or Tab field delimiter. The field delimiter chosen determines the set of valid filename extensions. When the Standalone option is selected you can now opt to disable the sidecar file.
• New action statements called Validate Discogs Metadata and Validate MusicBrainz Metadata. These statements can be used to test for consistent release ids and the presence of the secondary track identification metadata.
• The Prompt for Text popup window now has a Multi Line Editor button which allows you to edit more conveniently edit multi line text.
• Rewrote the Move Non Audio Files statement to be able to move files from multiple sources to multiple destinations. The Move files... field can be left empty to imply all files. The Move files... and Exclude files... lists can now specify files and/or file types. In order to accomodate spaces in filenames, the item separator has been changed from a space to a slash (/). Existing actions have been updated accordingly.
• The Delete Non Audio Files statement Delete files... and Exclude files... lists can now specify files and/or file types. In order to accomodate spaces in filenames, the item separator has been changed from a space to a slash (/). Existing actions have been updated accordingly.
• There is a new escape sequence \. which inserts a centered dot character. This can be useful as a replacement character when debugging and looking for spaces in fields.
• The User Defined Fields statement has an All option which changes the setting of the action test state in stepwise mode from any file to all files. There is also a new test condition to verify that an item exists, is not empty and has the same value across all files.

      m4a Files

• Evidently there are now three places to store personal information in a purchased iTunes album. The out of bounds identification field, the apID (owner email) atom and the ownr (owner name) atom. Yate will now save apID and ownr information to its Owner field. Either or both fields will be written when appropriate. Processing of the out of bound identification has not changed.
• The 'xid ' atom can be used as a vendor specific field which may contain the label and some sort of ISRC value. The information is now saved as a UDTI named iTunes Vendor xID.

      WAV Files

• Found an alternate way that the ID3 tag can be identified in a WAV file which is now handled.

      Bug Fixes

• The clear AcoustID data and fingerprint functionality was not checking if the associated items were mapped to custom fields. This only affected the Clear... menu and action functions. The code interacting with the data was working fine.
• The Copy Metadata functionality was not copying artwork.
• There was a documentation issue with the normalized names for the Acoustid UDTIs.
• A Track Count or Disc Count was not saved in ID3 or m4a files if the associated track/disc number was zero or empty.
• AcoustID fingerprints were not being saved when the Fingerprinter threw warnings along with a produced fingerprint.
• When running the Batch Processor and accessing MusicBrainz, an invalid Discogs Release Id would pop up an error dialog intended for non batch processing and the wizard would hang.
• The normalized UDTI value for Track Position in ID3 and m4a files was incorrectly assigned to TRACK_NUMBER_TEXT as opposed to Track Number Text. When performing Discogs lookups, Yate will now process the correct normalized value of Track Position and the alternate of TRACK_NUMBER_TEXT.
• The Sort Track List action statement was broken.
• Fixed a potential crash when setting Yate Album Ids across multiple albums.
• You can optionally specify to use a monospace font in Action Editor windows. On certain Retina display Macs the font was cropped.
• Fixed a File to Tag error where a space delimiter was not working when in the middle of the filename.
• Edit Panel preset buttons and Custom Panel buttons were not accepting Control-Left Click as a Right Click.

Version 3.6.0.3 (4002)

• Fixed a crash in the Replace function when the At End and Match Words options were set and the entire field was replaced.

Version 3.6.0.2 (4001)

• Bug Fix: Compare Text Starts With and Ends With were acting as Contains.

Version 3.6.0.1 (4000)

• Bug Fix: AcoustID importing of the MusicBrainz Recording Id was broken in 3.6

Version 3.6 (3999)

If you have written actions directly manipulating User Defined Text Information items (UDTIs) please read the section on UDTIs and Mappings.

      General

• Direct support for Notification Center has been added. You can now issue notifications through Growl or Notification Center. You can choose which classes of notifications you would like to receive. If you previously had notifications enabled they will still be issued via Growl unless you change the setting in Preferences - General. Note that if you are running OS X 10.6 or 10.7, a setting of Notification Center will automatically be treated as Growl. Notification Center support was introduced in 10.8.

      Main Window

• If you are running on OS X 10.10 (Yosemite) you can now Hide/Show the main window's tile bar via the Window menu.

      UDTIs and Mappings

• An earlier version of Yate moved the display of the MusicBrainz Recording Id to the Unique File Identifier (UFID) panel. This is where the value is stored in ID3 files and it seemed like a good idea at the time. In practice, however, not having the information in the same place as other MusicBrainz metadata (on the UD Text panel), was not a terribly good idea. The Recording Id is now displayed as a UDTI. Yate takes care of making sure it is loaded from and stored to the correct place in ID3 based files.
• In the past, Yate normalized some FLAC metadata to use the same field names as those used in ID3 and m4a files. This was done for UDTIs which Yate directly manipulated (mostly various Discogs and MusicBrainz metadata items). FLAC metadata item names are only stored in upper case alphabetic characters and the normalization process ensured that there was a common name which could be referenced.
  
  Starting with this version, Yate is far more aggressive with the normalization process and normalizes FLAC, ID3 and m4a UDTI metadata in order to produce a list of more meaningful names representing the function as opposed to the low level frame/atom/comment name which might have been chosen for arbitrary reasons years ago.
  
  If you have written actions to manipulate UDTIs, they may break as the names may have changed. The Frame Mapping Table available from the main Help page describes the current values in the Field column and the older values (where appropriate) in the ID3 Frame column.
  
  If you do not have the time to modify your actions, you can revert to the earlier behaviour by means of the Do not normalize UDTIs option in Preferences-Audio. We feel the new names displayed by the normalization process make much more sense and you should only remove the functionality if you really think it is necessary.

      FLAC UDTI Mappings

• In the past, if you were adding your own metadata items as UDTIs and you wanted common names to be displayed for FLAC, mp3 and m4a files, you had to use uppercase names. FLAC mappings to User Defined Text Info items are now used as alias names. If you want to add a metadata item called My Metadata, mapping it as a User Defined Text Info item will preserve the alphabetic case. This is a fully optional step for aesthetic reasons only and in no way affects what is stored in the audio files.

      Custom Mappings

• When assigning custom mappings you can now choose from a list of commonly used mappings to set their associated values. Note that as was always the case, Custom Mappings are based on the actual metadata frame/atom/comment names stored in the audio files.

      Custom Panels

• User Defined Text Information (UDTI) items can now be mapped to custom panels. This is the only component type which can appear more than once on a single custom panel.
• There are now ten custom panels.
• Custom panels can now have components which resize vertically which are not anchored to the bottom of the panel. You must now mark components as vertically resizable. Components anchored to the bottom of a panel are no longer automatically resizable. Custom panels built before this release will have been modified to have the same render behaviour as before. Components marked as vertically resizable will be resized when rendered unless they are adjacent to another resizable component which does not have the same first grid row or has a different number of initial grid rows.

      Edit Panel Picker

• If you've been using the Edit Panel Picker, you will have to rearrange the button order as seven new edit panels have been added (Custom 4 through 10).
• The drawer based Edit Picker, was intentionally designed to be a single column display so that the drawer hugged the window as much as possible. With the introduction of the new Custom panels, it is now possible that not all the panel buttons can be displayed as a drawer cannot be larger than its parent window. If your main window does not have sufficient height to display all the buttons, buttons for which there is no room will not be displayed. A ... indicator will be displayed at the bottom of the drawer to indicate this fact. If you want to move buttons around, you may have to resize the main window in order to see them all. Note that the window based Edit Panel Picker is not affected.

      Artwork

• You can now crop non square artwork items from any full artwork control's large image well via the Crop Artwork... context menu item.

      Batch Processing

• You can now optionally run an inline action before any files/folders are processed and after all file/folders have been processed. The special inline actions are named Batch Start and Batch End. The actions are always run stepwise even if the main action starts with a Force Grouped statement. Remember that information can only be retained in system variables between executions of the main action on individual folders.

      Actions

• New action statement called Normalize Artwork which ensures that every track in an album has the same artwork items.
• New action statement called CSV Data to List. The function will convert one or more lines of CSV data to a list of lists representing the content.
• New action statement called List to CSV Data. The function is used to format list data for CSV files.
• New action statement called Stop Batch Processing.
• The Remove Artwork statement now has an option to remove duplicates.
• The Compare Text statement now supports the relational operators: <, <=, >= and >. A fuzzy compare has also been added.
• The following statements can now be executed when batch processing: Copy to Clipboard, Text from Clipboard, Ask, Prompt for File or Folder and Prompt for Text. The intent is to use the statements in the Batch Start and Batch End inline actions.
• The Prompt statement by default gets written to the batch log file when executed while batch processing. There is a new UI option which will direct the prompt to be issued to the UI. The intent is to use the statement in the Batch Start and Batch End inline actions.
• If you wish to create a CSV file which does not contain the minimum field requirements to be an Album or Track database you can now do so. Use the new standalone option in the Create Album Database and Create Track Database statements.

      Bug Fixes

• The Content Advisory and AAC Kind fields were editable.
• Selecting an empty Content Advisory did not work if tracks were selected with multiple values.
• When importing from Discogs, Part of a Compilation values of 0 were incorrectly identified as being different from a Yate value of empty.
• The Set Variable to Action Test State was broken in the last release.
• The Set Named Variable had some UI issues since the last release.
• The Set System Variable had some UI issues since the last release.
• The Prompt for File/Folder statement sometimes incorrectly hid the New File option.

Version 3.5.0.1 (3920)

      Retina Display Aware

• The application is now Retina Display aware. If you've been halving your scale factor in Preferences-Artwork to get the size you wanted, please stop doing so. Forcing images to greyscale and the square images functionality was also affected by the pixel multiplying.

      General

• A new case modification type is available wherever the Title Case option is present. The new function called lower-Title Case is a hybrid mode used to bypass the fact that the title case algorithm ignores words with contained capital letters. The title case algorithm is implemented in this fashion to prevent names such as CCR and REM from being modified. The Lower-Title Case function first converts the text to lower case before applying the title case logic.

      Action Functions

• Count Items and List Item at Index now support saving the result to a named variable.
• List Key now supports the entry of an alternate key/value separator. The function also now supports fields as well as named variables.
• The Prompt function has a new Log option. When enabled the prompt will be sent to the system log and will be viewable with the Console application.
• Force Grouped now allows an inline comment.
• The User Defined function has been enhanced. There is a new test only mode which supports various test scenarios. The setting of the action test state is now documented for each individual mode.
• The Scale Artwork function now lets you specify a compression factor when forcing jpg artwork items.
• The Run, Test and Repeat With statements all have a new Indirect option. The option enables the use of escape sequences in the text field where you specify the name of the action to be run. This enables you to choose the action to be run based on the contents of Variable fields or any other constructed pattern. The action name is only validated at run time. If the evaluated name is empty, no action is run... this is by design. You can setup lists using the various list functions to contain the names of actions; inline or not. By using the List Item At Index function, you can pull an action name and place it in a variable which can then be specified as an indirect action name.
• The List Contains Test statement now has a Save Index option.
• The Add to List statement now allows the insertion of an item at a specified index.
• New action statement Field List Enumerator which produces lists which can be used to enumerate Artwork, User Defined Text Info, User Defined URL and Comment items via the Repeat With statement.
• New action statement Indexed Artwork which can be used to get and set information from artwork items based on their index in the artwork list.
• New action statement Remove List Item at Index.

      Action Editor Windows

• Action statements which support fields and named variables now use a single text field to represent the choice.
• There are two new context menu items in an Action Editor Window. You can save the entire action to the clipboard as text or as an HTML snippet.

      Main Window File List

• You can now configure the alignment and text cropping location for most columns in the main file list window. This is performed via Preferences - File List - Customize column display attributes - Configure.
• New main window column called File Type which displays a file's filename extension.
• Column fields which display sizes are now formatted for GB (dsf files are large), MB, KB and B. Common usage is used for the calculations as opposed to rigid actual sizes.

      Main Window Edit Panels

• New Edit Panel Picker which displays a list of all 26 possible edit panels and provides fast access to the panels. The Picker is enabled from the Window menu. The Picker can be viewed as a drawer attached to the left or right of the main window or alternately as a stand alone window which can optionally be configured as always on top. The layout of buttons in the picker can be rearranged by dragging a button to a new location.
• You can now disable/enable autocomplete on the combo box controls which use the Artists, Composers and Genre lists. The settings are maintained individually for each list type. The settings are accessed from the Edit menu. The items may be assigned to keyboard shortcuts.
• Combo box controls which use the Artists, Composers and Genre lists now have new menu options to manually add items to and remove items from their respective lists.
• Function button context menu links to a field's associated multi item editor panel no longer display counts. The counts were somewhat meaningless as they reflected total items offset by the default item. The actual multi item editor panels display merged items so the number never lined up.
• Link controls such as the User Defined Items link on the More Info panel no longer display counts. As before, the links only appear if there is data on the destination panel.
• The URLs panel now has potential links to the Commercial Information Webpages and Official Artist/Performer Webpages panels.
• If a single line field in a panel contains text which contains a newline character, the text will be displayed in blue. You can then use the field's associated function button's Choose Value context menu item to view/edit the full content.
• The Format... function button menu item, now operates when the selected files have different values.

      Custom Panels

• You can now crop Custom fields in Custom Panels when they are single line items.
• New Custom Panel controls named Thumbnail (1), Thumbnail (2), Thumbnail (3). The number in parenthesis indicates the fixed number of rows occupied by the control. The controls can be cropped.

      Audio Information Panel

• ID3 version information is now displayed where appropriate.
• Sizes are now formatted for GB, MB, KB and B. Common usage is used for the calculations as opposed to rigid actual sizes.

      Artwork

• When saving artwork items to the file system from a file dialog, you can set the compression factor for jpg images.

      Preferences

• Preferences - File List allows you to configure main window file list column attributes.
• Preference - System Variables allows you to view/edit the content of a system variable in a multi line editor.

      AcoustID Recording Info Display

• Title and Recording ID are now available for import when a release is selected.
• Import all Metadata will now pull Title and Recording ID when a release is selected.

      Bug Fixes

• You can no longer resize the lower right panel in an Action Editor window to be smaller than the required minimum size....at least we hope so.
• The Audio Properties control is now handled properly on Custom Panels.
• Custom fields were described as resizable when they occupied a single row on a Custom Panel. They are only resizable when the occupy two or more rows.
• When exiting the Custom Panel Editor, the modified name and/or tooltip of the displayed panel was reflected though the UI. Name and/or tooltip changes to panels other than the displayed panel were not reflected.
• If you had load on double click set in the File Browser View options, the Open menu item was always treated as a Load.
• Lot's of UI labels were cropped in OS releases earlier than Yosemite.
• When the MusicBrainz Id descriptive names were changed in v3.4, a few AcoustID menu items were not updated.
• When displaying the Artwork Save As panel, the Keep a Copy option was not properly enabled/disabled.
• Format Credits via action or the UI would stop if a selected file had an empty credits field.
• There were circumstances when using the value chooser to select an empty value would not remove the display of the ??? multiple value placeholder.
• When an image was squared, the Mime type display was not being changed to image/png.

Version 3.4.0.2 (3869)

Regression: Changes made to an artwork item's description field were not being retained.

Version 3.4.0.1 (3853)

Main file list filtering, AcousticBrainz support for BPM and key extraction, more custom fields, Action date stamps, Finder tags, embedded fields within actions and lots more.

      Main Window File List

• New filtering functionality for the main file list. You can now define compound filters and hide, close and select files which either match or do not match a filter. You can filter in one way or another on any pretty much any metadata associated with a track. (There are more than 120 test points.) The filters can be saved, modified and exported. You can hide filter options that you're not interested in. The new functionality is available from the File>Filter... menu item, the main window's Filter... context menu item and from the new Filter toolbar item. Saved filters are available from the Close Files , Hide Files and Select Files submenus.
• The filtering options added in v3.3 and Close Under Mask have been removed as the new filtering functionality is far more powerful.
• A Randomize option is available from the main window's file list column header's context menu.

      AcousticBrainz Support

• AcousticBrainz provides access to an online database used to maintain acoustic information extracted from audio files. At this point we're supporting the importing of BPM and Initial Key values.

      Track Renumbering

• The Renumber and Calculate Track of functions (via the UI or actions) have per disc and per album variants. The per album methods are essentially what existed before. The per disc methods will do the functions in discs within albums. Note that the toolbar items for these functions remain the per album variants.
• There is now a Renumber from... UI function.
• There is now a Renumber Random UI function. The function renumbers selected tracks from 1 in a random order. This can be useful if you are creating your own compilations and you want to randomly number the tracks.

      Playlist Support

• The Create m3u Files action function has been enhanced. You have control as to whether relative or absolute paths are used; you can relocate the paths and you can supply specific file names. You can also randomly order the tracks in the produced playlist.
• The Create iTunes Playlist function has a new Randomize track order option.

      Custom Fields

• There are now 10 custom fields Custom0...Custom9. The new fields are available as File List columns, and in Rename and File to Tag templates.
• Custom fields in Tag Sets and action editor statement lists now show the current name associated with the field.
• You have always been able to set the mappings for Custom fields in FLAC files. You can now do so for ID3 based files and m4a/mp4 files as well. This means that you can map your custom fields to specific file frames/atoms used by other applications. This will be useful for users who access the extended classical fields used by some applications. Note that in ID3 based files the Custom fields can be mapped to COMM, TXXX and WXXX frames. The functionality is accessed via the Column Mappings and Custom Fields - Configure button in Preferences - File List. Custom fields are properly synchronized with their low level mappings as you would expect. For example if you map a custom field to the Discogs Release Id, the Discogs Wizard will set the appropriate custom field even though it lives as a UDTI in the file.

      Action Manager

• The Action Manager now keeps track of modification date/times for actions. There is a new column in the window to display the data. Note that older actions which do not as of yet have a recorded modification time, will display the field as empty. You can configure the format for the display of the date/time information in Preferences-Actions.
• You can now search for actions in the Action Manager.
• The entire Action Manager display can be sorted ascending and descending by clicking on the column headers. You can also sort a selected folder or the folder containing the selected action via the Sort Folder context menu items.

      Action Editor

• When doing a SaveAs in an action you can now choose to have the new action replace all references to the old name. The initial action is not deleted or modified.
• You can now choose to display the list of action statements in an action editor window with a monospace font. See Preferences-Actions.
• Comment statements are now highlighted to make them more visible.

      Action Functions

• There are new escape sequences, \C0, ... \C9 to insert the value of a custom field.
• There is a new escape sequence, \[field name] which used to insert the contents of the specified field within a file. The field names are case insensitive and are available for easy insertion from context menus. If the specified field name cannot be matched the sequence will simply be removed. Note that Variables and Custom fields can only be inserted via the \v and \c escape sequences.
• The Start function allows you to specify an inline comment.
• The Copy function now has an only if the source is not empty option.
• The Create m3u function has been enhanced.
• The Renumber Tracks function has been enhanced.
• The Compare Text Test function now has a like operator.
• The User Defined Fields function has a new Set state option. If an item match was made the action test state is set to true, otherwise false. This is only a meaningful result when the action is executed grouped.
• New function called Index Of which returns the index of a string in a field or named variable.
• New function called List Item At Index used to return a list item by its position in the list.
• New function called List Key to make it easier to store and access key-value pairs in lists.
• New function called Finder Tags used to read and write Finder tags on OS X 10.9 and greater.
• New function called Scanner. Successive Scanner statements can be used to form complex field analyzers.
• New function called Access AcousticBrainz. If you have tracks with MusicBrainz Recording Ids, you can use extract BPM and Initial Key values from the AcousticBrainz database.

      Preferences

• There is a new Preference section called Actions.
• Preferences - Audio has a new option for m4a files used to choose the mapping for the Conductor field. There are two mappings commonly used: CONDUCTOR (Yate's default) and Conductor. Yate now let's you choose whichever mapping you wish to use. See the online help for more information. The setting is imported/exported with the m4a custom field mappings.
• Preferences - General Use Yate Context Menus has been removed. Yate now does it automatically.

      General

• Yate is now far more aggressive about protecting you against changing field mappings when files are open. Changing field mappings in application preferences is now disabled when files are open. Resetting preferences, resetting FLAC items and reimporting FLAC items are also disabled. You will not be allowed to import preferences which can change the field mappings when files are open.
• Modification: The Show in iTunes Playlist UI and action functions will now display all selected files in the Yate-Work playlist. The previous interpretation was too vague.

      Custom Panel Editor

• The Custom Panel Editor now supports the import/export of the current panel. This will allow you to share custom panels with others.

      MusicBrainz Fields

• Once again we're attempting to standardize the names of some MusicBrainz fields so that Yate's aligns with theirs. In the MusicBrainz Wizard's Release View, Track Id is now Recording Id and Track Position Id is now Track Id. None of your settings have changed as only the descriptive names have been modified. Hopefully this will clear up some confusion.

      Bug Fixes

• Some action editor context menu items were not correctly disabled when running an action.
• When renaming an action the Discogs and MusicBrainz Run action after import actions were not renamed if affected.
• When quitting Yate, holding down the Shift key was not disabling the auto export of a preference file (if enabled).
• The Format Credits action statement would insert an = for an empty field.
• Right clicking on Unused grid elements in the Custom Panel Editor under Snow Leopard was not working.
• Scrolling in single line text fields on Custom Panels was not working.
• Fixed a crash after moving files if the OS could not maintain the file tracking.

Version 3.3.0.1 (3711)

• Bug Fix: Fixed the on again off again tab order on the Info panel.
• File to Tag now automatically trims whitespace when saving fields.

Version 3.3 (3708)

      Artwork Viewer

• Enhanced the database artwork viewer to work in conjunction with the main window.
• New Artwork menu item Show Artwork Viewer
• The image in the Artwork panel's large image panel, (or in any full artwork display on a custom panel), can be opened in the Artwork Viewer by double clicking on the image or via the context menu.
• The Artwork Viewer can be configured to follow selection changes in the file list or an album/track database via new options on the Preferences-Artwork panel. You can force images to always open at 100% via preferences.
• The image in the Artwork Viewer can be dragged out, can be copied, zoomed and saved.
• The Artwork Viewer displays the pixel dimensions of the displayed image and the percentage of its size as currently displayed.
• Images in the artwork Viewer can be zoomed to 100% by double clicking on the image.

      Main Window

• Added new filtering items to the main window's Hide context submenu. You can now hide files based on having or not having content in any field. Where appropriate, you can also hide based on multi item fields having values other than their associated default value.

      Multi Field Editor

• Enhanced Find and Remove
• Enhanced Trim
• Enhanced Replace Text
• Added a Copy field section.

      Preferences

• Preferences-iTunes has been rearranged. Auto import and export of iTunes settings is now supported. Be careful when using these settings as values in iTunes or Yate will be overwritten. The options are useful when importing metadata that you only change in one location. For example, you might want to import the current play counts from iTunes whenever linking tracks. If you only change ratings in Yate, you might want to export the current ratings to iTunes whenever saving files.
• New Preferences-General option called Use Yate context menus for text fields. This option enables the substitution of the system's default text field context menu for one which supports all of Yate's case transformations and space compression. This only affects context menus in the Edit Panel and sheets displayed by the Edit Panel.
• New Preferences-Audio option to write an ID3v1 tag in addition to the ID3v2.4 or ID3v2.3 tag being written. This is mostly to help satisfy some older hardware based players which unfortunately still require the older (1996) format.
• Preferences-Audio now supports the customization of the internal rating mapping. The internal rating mapping also controls which values get written out for the Full (0-255) ID3 and FLAC rating settings. You can now customize the mappings to be the same as any of the competing rating mappings out there if you so desire. There is a new action function called Translate Rating which can be used to modify the rating values in files between different mappings.
• Preferences-Audio now allows you to choose to write m4a/mp4 ratings in an alternate format in addition to the standard Yate format. Yate writes ratings to m4a/mp4 files using a standard container extension method. If your ratings are not showing up in a media player (other than iTunes) you may be able to fix the issue by enabling the new rate atom settings.
• Preferences-Audio now allows you to map the m4a/mp4 stik (Media Kind) atom to the Media Type field. Yate will let you export the Media Type as Music or Audiobook. Any other value will be changed to Music. This is really only useful if you want to tag files as being audiobooks before adding them to iTunes. The stik atom is only read once by iTunes when files are added. The atom is not written by iTunes.
• Preferences-Artwork has new options for the artwork viewer.

      Actions

• The following actions have been modified to accept named variables: Compare Date Test, Compare Numeric Test, Compare Text Test, Copy to Clipboard, Decrement Variable, Increment Variable, Set Action Test State from Variable, Text from Clipboard and Set Variable to Action Test State.
• The Text from Clipboard function has been enhanced to allow you to copy only the first non empty line or the entire contents.
• The Scale Artwork / Change Type function has been enhanced to support the squaring of images. An image is squared by resizing an image to the larger of its width and height by introducing transparency. The old image is centered in the new area. The resultant image is a png image.
• Added a new action function called Artwork Information to extract various information about the artwork available in one or more files.
• Added a new action function called Add Folder to Recently Opened List. Useful when you move tracks and you want a quick reference to the new location.
• The Set action function interprets values as 0 to 5 stars when setting the rating field. If you wish to specify a specific value for the internal ID3 format enter the value as a negative number from -1 to -255.
• New action function called Translate Rating used to modify the rating values in files between different mappings.
• The Prompt for Folder/File action function has a new option displayed when File is chosen. The New File option causes a save dialog as opposed to an open dialog to be displayed.
• Added a new action function called Set Action Test State from File Type. Yet a any even more convient method of testing file types than the Audio File Type property introduced in v3.2

      Album and Track Databases

• Two new columns can be created when building the databases. The Artwork Size column will contain width x height for the default artwork item. The db column will contain the online database associations as described in the main window's db column.

      Bug fixes

• When a rating was changed inline in the file list, the change indicator was not updated until the focus changed.
• The Copy function was not letting you copy the Rating field. Note that copying the default rating copies the unmodified rating value. You can use the \R escape sequence to get the value as a number of stars.
• At some point the Preferences-Exception set Remove Special Status menu item was disabled.
• False "modifications made" warnings were sometimes issued when closing actions where Text Item Lists were sorted.

Version 3.2 (3562)

• Warning if you are on Yosemite and use Dropbox, please make sure that you go to Dropbox Preferences - General and uncheck 'Enable Finder integration'. While this will get rid of the fancy green check marks in the Finder it will also stop crashes when displaying File Open or Save dialogs. Dropbox will still operate normally. Thanks to the folks at Dropbox for describing the work around at this link. Update: this is supposedly fixed in OS X 10.10.1
• Feature Request: Added the ability to identify multiple occurrences of files and potential duplicates in your collection. The functionality is available from within Track Databases. See the new help topic Duplicate Identification Using Track Databases for more information.
• To go hand in hand with the new Duplicate Identification Using Track Databases feature, the database Query system has been enhanced. Queries with the same Key and Data columns now eliminate the redundant Key names in the results. As opposed to only allowing the path to the file as accumulated metadata, you can now accumulate any single column. Examples can be found in the help for the Duplicate and Query processes.
• Feature Request: If you want the ability to replace files on an open while in Playlist Mode, you can enable the functionality via the new Preferences-File List-Allow Playlist Replace Open Mode option.
• You can now view a summary of the contents of a Yate preference file via the new Yate>Examine Preference File Contents... menu item.
• Feature Request: Yate preference files can now be imported by dragging them to the main window's file list area. You configure what is imported and how by the new Preferences - File List - Dragged preference file import settings - Configure option. If you hold down the Shift key while dragging, the contents of the file will be displayed as opposed to importing.
• Feature Request: When multiple artwork items are selected in any full artwork panel, you can now change the Picture Type.
• Preferences - File List has new options to control padding the display of the Track, Track Count, Disc and Disc Count fields. You can force minimum widths of 1 (no padding) to 4. The Track and Disc options can specify smart padding where the padding automatically matches the length of the associated Count field.
• There's a new Preferences - Audio option to write the padded representations of the Track, Track Count, Disc and Disc Count fields to the audio files.
• Feature Request: There are new options for both Discogs and MusicBrains called Join Exception. If you want to force your own separator string as opposed to using what is specified by the database (or defaulted by Yate), you can use these options.
• You can now configure the Discogs credit mappings to any of Composer, Conductor, Involved People, Musician Credits or Remixer. The mappings are set in Preferences - Discogs - Credit Mappings - Configure. Also, 'Music By' now defaults to being a Composer alias.
• Feature Request: Two additional import fields for Discogs: Copyright and Publisher. Copyright will import both © and ℗ copyrights if available.
• Feature Request: Lots of AIFF files have +-1 issues in the element of the file describing the contained data's length and other minor formatting issues in the audio container, (not the tag metadata). Most applications, in fact almost all, work around these issues and ignore the minor spec glitches. In our testing about 35% of all tested files have a minor format/spec issue. Unfortunately, it seems as if a few applications cannot process a wide variety of AIFF files. The files that cause problems do not have to have ever been processed by Yate which typically avoids modifying the container. Starting with this release Yate will repair all detected container format issues whenever saving the file. We are not sure which container issues cause these applications problems so we simply do a sweep and fix them all. If you are not experiencing problems with your files these issues can be treated as benign, as they should be. The Sample Actions web page, available from the Help Menu, contains pre-built actions to test for and fix these issues.
• There is a new property called Audio Container Status which returns 0 for an audio file which has recoverable formatting/spec issues in the audio container. The property returns 1 to identify a file with no detected container issues. Note that at this time, 1 is always returned for non AIFF files.
• New convenience properties to get a track's path or original path without a filename extension.
• There is a new property called Audio File Type. This property provides a better means of testing a file's audio type than by looking at the filename extension. The possible values are documented in the Get Property help.
• For those of you that are interested in audio file properties, Yate now differentiates when describing mp3 Xing and Info header variants.
• There is a new escape sequence which can be used in actions. @0 through @9 will be replaced with the contents of the named variable whose name is in the specified variable. eg. if variable 1 contains test, @1 will be replaced with the contents of named variable test.
• The Repeat With action statement can now be used to repeat on list elements or on every character in a field or named variable.
• Added a new Encode as ASCII action function. Essentially the function can be used to remove diacritical marks from fields. This is a lossy conversion and it is possible that characters are lost.
• Added a new flow control statement Exit Repeat.
• Added a Sort List action statement.
• Added a Copy Unhandled action statement.
• The Format Credits action function and its UI equivalent, can now specify the source separator used to delimit people as well as the resultant people separator to be used in the formatted data.
• The Trim action function can now remove control characters. You can also specify that all characters in the excluded set are to be removed.
• The Dump Variables action statement can now display the current value of the action test state.
• Entering newline characters in User Defined Text Information items is not allowed by the ID3 specification. However there are so many instances of items which break this rule that Yate will now allow you to insert newline characters when editing them.
• Bug Fix: It has been reported that Yate stops system restart on some Macs when there is no reason to do so. This build should fix the issue.
• Bug Fix: Discogs: Removal of (#) sequences in names could leave spaces at the end of the name field.
• Bug Fix: Discogs & MusicBrainz: When importing Involved People and / or Musicians Credits it was possible that some data was misplaced.
• Bug Fix: The Discogs post import action was not not executed when enabled.
• Bug Fix: The Repeat With and Build List functions when set to 'As Found' were not constructing the list properly.
• Bug fix: It seems as if Yosemite from time to time has issues auto hiding progress indicators when they become inactive. This can cause some dirt to be left on a display. We're back to showing and hiding the indicators manually.
• Bug Fix: Some full Artwork control menu items were incorrectly enabled when multiple artwork items were selected.

Version 3.1 (3408)

• The context menu for most field types in editing panels now have a Multi Field Editor... item. Selecting the item will display the Multi Field Editor with the field type selected.
• The context menu for field types which support multiple items had a menu item called Multi Item Editor. The menu item name is now the actual display name of the appropriate edit panel.
• On Yosemite, the highlight colour for the Editing Panel's preset buttons has been changed to reflect the the system's highlight color (as displayed in the main window file list). The white text on a light gray background was too washed out.
• The Musician Credits and Involved People fields are now internally stored as displayed. This will make no difference to you unless you have written actions to directly parse the fields. The external format used to write the data to audio files has not changed nor has the user facing representation of the data. Note that the fields are automatically formatted when saved to files removing blank lines and extraneous whitespace. The fields can now be directly edited on any editing panel where they occur. The fields have a new option to format the data. This is essentially a UI based implementation of the Format Credits action function.
• The Prompt for File or Folder action statement now allows you to create folders when prompting for a folder.
• The Save Variables and Restore Variables action statements now have options to save/restore per track copies of the variables while in stepwise execution mode.
• The Dump Variables action statement can now display variable snapshots (previous functionality), per track variable contents, system variable contents and named variable contents.
• The Verify Same and Verify Same Test action statements have been renamed to Compare Fields and Compare Fields Test. The help and descriptive text have been modified to better reflect what is being tested.
• The Action Pending Window displayed for the Prompt and Dump Variables statements now has a Copy button which will copy the displayed information to the system clipboard.
• Some new action functions used to maintain the concept of lists of items in fields or named variables. A list is any field where items are separated by a known delimiter:
  • Build List is used to construct a new list in a field or named variable based on the contents of a field or a named variable. The source delimiter can be a single string or a set of characters.
  • Count Items is used to count the number of items in a list in a field or named variable. The list delimiter can be a single string or a set of characters.
  • Add to List is used to add an item to a list in a field or named variable. Items can be added to the start or end of the list.
  • List Contains Test. The function looks for an occurrence of an item in list in a field or named variable. The action test state is set to reflect a successful match. If found, the item can optionally be removed.
• New action function Copy Field to Named Variable. This is a convenience function which avoids the necessity of copying a field to a variable then to a named variable.
• New action function Extract Bracketed Text. The function is used to look for text within a field bracketed by one of (), [ ], < >, or { }. The first or last occurrence can be matched. Matched text can optionally be removed. The action test state is set to reflect the occurrence of a match.
• New action function Split Field used to split a field into two parts at a specified delimiter.
• The Repeat With action function has been enhanced. It now allows empty delimiter fields. Support has been added for delimiters which are a set of characters to use as separators. The function can now use a field or named variable as the content source. Various parameter passing and list construction options have been implemented.
• Tweaked the Discogs Master Matching search string for better results.
• When doing Discogs Master Matching, those masters which only reference video content are now ignored. They will still be listed in the log file.
• When specifying a Discogs release directly via id=, you can now reference a master by prefixing the id with an m. ie. id=m#
• The CSV database Artwork Viewer can now be resized. Artwork can be dragged to the the main Yate window, the Finder, etc.
• Rename and File to Tag templates can now specify Disc Count and Track Count.
• Open Path in Clipboard now handles multiple paths separated by newline characters.
• Variables are now consistently displayed as Variable space number. ie. Variable 1, not Variable1.
• New Help menu entry to access the forum.
• New Help menu entry to access sample actions.
• Bug Fix: Undo was not working inside multi-line text fields on Custom panels.
• Bug Fix: The Sort Form action statement's item table was not showing the count of selected items.
• Bug Fix: The Prompt for File or Folder action function only worked when saving the results to Variable 0 through Variable 4.
• Bug Fix: On Snow Leopard you were able to drag an image in the large artwork well to itself.
• Bug Fix: Dragging from a display only artwork display such as the one next to the Comment field on the Info panel, only worked if a single file was selected.
• Bug Fix: Launching of the Default Action was broken in v3.0.
• Bug Fix: The Replace action statement was applying escape sequences on the 'from' pattern prior to splitting when OR matching was specified.

Version 3.0.1 (3353)

Mostly a few feature requests this time around.

• There is a new main table column for the Initial Key field.
• There is a new Discogs option to use Artist Name Variations (ANVs) for artist names, when they exist. More information can be obtained in the Discogs Preferences help.
• There are two new metadata elements which can be saved from Discogs: Artist Name Variations and Artist List. Artist Name Variations stores a list of key-value pairs associating artist names with ANVs. Artist List stores a list of all artists. This will be the same as the Artist field if the Combine multiple value items into a single value option is not enabled. A more thorough description of these new metadata elements can be found in the online help for the Discogs Wizard Release panel.
• id= album entries in the Discogs and MusicBrainz wizards are now placed in the recent items drop down menu.
• BugFix: The large image's context menu in the Artwork panel was not responsive until at least one file was selected which had an artwork item or an image was added by other means. This did not happen on custom panels.

Version 3.0.0.2 (3349)

• Bug Fix: Certain editing sheets on the main file window could not be removed on versions of the OS prior to 10.9.

Version 3.0.0.1 (3348)

• Bug Fix: The Sort Album and Sort Album Artist fields on the Sorting panel were somewhat confused as to what data they were supposed to display.
• Bug Fix: If you imported preferences which contained a default action, the action would no longer be the default unless it was in the root of the actions list.

Version 3.0 (3346)

Our largest update ever. Six months in the making! Major UI and functionality changes.

Application

• Throughout the application the white checkmark on green background character, used to imply linked or default, has been replaced with a simple black checkmark. The check on a green background character does not exist in Snow Leopard and changes to a blue background in Yosemite.
• The Preview system has been enhanced so that you can easily switch a preview from one track to another. Preview multiple tracks. More information in the new help topic: Previewing Tracks and Other Files.
• The online help is now always browser based.

File List Panel

• The status bar now displays n/m when loading files.
• Previously files were loaded on a background thread but the scanning of folders to determine which files to load was done on the foreground thread. The scanning is now also done on a background thread. The name of the folder currently being examined is displayed in the status bar.
• New table columns: Publisher and Label.
• The iTunes and db columns have tooltips explaining the various indicators.

Edit Panel Changes (Overall)

• The Edit panel now displays two rows of preset buttons used to select a specific content view.
  • The preset buttons resize automatically.
  • Abbreviations are used for views associated with controls with long names. eg. Artist Sites for Official Artist/Performer Website. When this is the case tooltips are available.
  • The order of the preset buttons can be changed by by dragging a preset button to a desired position.
  • The content displayed when a preset button is selected can be changed by right clicking on a preset button and choosing a content view. All content views (with the exception of Empty) can be associated with only one preset button at a time.
    • The context menu contains a submenu named Others. This menu is a convenient place to store those views you never or rarely use. A view is moved in or out of the Others menu by holding down the Shift key and clicking on the view's name in the context menu.
    • Three preset button layouts can be saved and loaded from the context menu.
    • Three custom panel views can be configured from the context menu.
  • The last preset button position (lower right) is somewhat special. Various controls have the ability to jump to an enhanced view which displays multiple items. If the activated view is not already mapped to a preset button, it will automatically be mapped to the last preset button replacing whatever was there before.
• The biggest change to the edit panel is the removal of the checkboxes and disclosure triangles previously associated with controls. A single round function button immediately to the left of a field replaces these items. The colour of the function button reflects the change status of the field. Five colours are possible:
  • Clear implies that the field is in an inactive state.
  • Green implies that no changes have been made to the field.
  • Orange implies that the field contains a value different that the initial value.
  • Yellow implies that the field has been changed since the editing state was set. (File selection changed or an action finished).
  • Red implies that the field is different that the initial and editing state values.
  Every menu associated with a function button has a colour code submenu which describes the colours.
• All functionality associated with a field other than simple editing, is accessed by clicking on the function button which will display a menu with the available functions. These functions include:
  • Activating a value chooser panel which replaces the old advanced editors. This panel presents differently depending on the number of files currently selected.
    • When a single file is selected, the panel allows you to choose the initial, edit or current value and optionally edit the value.
    • When multiple files are selected you can choose from among any of the unique values, restore the current value and optionally edit the value.
  • Setting a field to empty when ??? is displayed for multiple values.
  • Possible date/time functions.
  • A link to the view which displays all the values for a field type as opposed to the default value. For example the Comments field displays the default comment for the selected files. However, there can be multiple comments in the metadata. The link will take you to the Comments view which is used to access all the comments.
• Various fields have been moved to different views. Some new fields have been added to represent the default for multiple item metadata objects such as Terms of Use.

Artwork View Specific Changes

• The artwork panel now automatically hides the image table if only one artwork item is present. All artwork items are prefixed by a status display indicating: default (star), present in all files (completely filled circle), not present in all files (half filled circle), initial no longer present image (down arrow), editing state no longer present image (pencil). All functionality for an artwork item is accessed from a context menu. The possible functions are:
  • Add Artwork
  • Apply to All Files
  • Delete Artwork
  • Revert All to ... Initial Values
  • Revert All to ... Editing State Values
  • Change File Selection (change the file selection to the files containing the item.
  • Save to Folder Icon
  • Save to Folder Icon of Chosen Folder...
  • Save to folder.jpg
  • Save to folder.jpg in Chosen Folder...
  • Save Artwork to... This function operates differently based on the number of artwork items selected. When a single item is selected you supply the destination file name and can perform various transformation functions. When multiple items are selected you specify the output folder and the naming conventions.
• The pasting of image files into the large artwork panel now works as expected.

Saving Artwork from Menus and Toolbars

• Previously you could save artwork from the application's Artwork menu, the application toolbar and from the context menus on the Artwork Panel. The toolbar and application menu functionality no longer makes sense as they can no longer refer to a single fixed Artwork panel. (Custom panels may contain full artwork functionality). The toolbar items and application menu items for Save Artwork, Save Artwork to folder.jpg and Save Artwork to Folder Icon have been removed.
• The context menus on any full artwork control now have additional menu items so that you can save to folder.jpg files or folder icons based on a chosen folder or a single unique folder.

Multiple Item Views

• Multiple item views replace the former advanced editors for Comments, User Defined Text Items, etc.
• Multiple item views all follow the same format. The views are: Artist Sites, Comments, EQ, GEOB, Info Sites, Lyrics (All), Ratings, Relative Vol, Terms of Use, UD Text, UD URLS, UFIDs.
  • Every item displays a status. See the status displays described in the artwork panel writeup above.
  • Functionality is available via a context menu which can include the following:
    • Copy... used to copy various portions of the item to the system clipboard.
    • New... used to create a new item.
    • Edit
    • Apply to all Files
    • Delete
    • Revert All to ... Initial Values
    • Revert All to ... Editing State Values
    • Change File Selection
    • Recreate Item(s). Used to recreate individual removed items without reverting all items.
    • View (in the Log Viewer for binary data items)
    • Export (as binary data)
    • Dump (as a hex dump for binary data items).
• The Unhandled view is much the same as the multiple item views with somewhat reduced functionality.
• All multiple item views have the ability to display a list of referencing files when more than one file is selected. The option is unique to each view and is controlled by the Show/ Hide File References context menu items.

Custom Views

• There are three Custom views/panels which can be named and edited using the new Custom Panel Editor. You can design content views which reflect your own usage. You layout any Yate field type including the new five custom fields.

Custom Panel Editor

• The custom panel editor is activated from a preset edit panel buttons's context menu. The Edit>Custom Panels... menu item will open the panel editor. You choose which panel you want to configure and can work on all three panels before saving your changes.
• The edit panel allows you to name a custom panel, supply a tooltip for the panel and to layout controls in a 12 row by 2 column grid. Unoccupied grid elements are displayed in yellow, occupied in white and selected in cyan.
• To assign a component to a grid element, right click on an unoccupied grid element to receive the upper left of the control. A popup menu will list the available components.
• Every component has a minimum number of rows and will be created with the minimum number required. Components which can be resized vertically can use the Expand Up and Down buttons to grow the area occupied by the component.
• Initially an assigned control will occupy a left or right grid element. For components which can be resized, the Expand Left and Right buttons can be used to grow the area occupied by the component.
• Components can be moved by the Move Up, Down, Left and Right buttons. Additionally a component can be moved by by dragging the field and pointing to the new position for the the upper left hand corner of the field. If the Shift key is down when the drag terminates you are pointing to the new position for the lower left hand corner of the field.
• The Shrink buttons can be used to reduce the size of components.
• Certain components appear cropped and by default do not occupy a full half of the panel. This includes components such as Track/Track Count, Disc/Disc Count, Year, etc. Components adjacent to cropped components will automatically horizontally expand to use the additional space. This is much like the default layout on the Info panel.
• If a component has none below it and is vertically resizable, it will automatically be resized when the window size is increased. This is good for the Artwork component which can be created as occupying a minimal number of rows but which can expand vertically.
• When adding Custom fields (Custom 1...Custom 5) they will be rendered depending on the assigned number of rows. A single line Custom field will be rendered much the same as the Title field. A multi line Custom field will be rendered much the same as the Comments field.
• The 12 row by 2 column grid is based on the minimum window size allowed in the main window. If you want additional grid rows simply resize the panel editor vertically. When saved the main window will be resized if necessary and the main window's minimum size will be the greater of the absolute minimum size and the largest size required by any custom panel. To reduce the number of grid components simply make the Panel Editor window smaller. Depending on how much you reduce the size, components may be shrunk or eliminated entirely.
• There are three artwork oriented components. Artwork Full is essentially a full featured artwork control. It will display multiple artwork items and is fully editable. Artwork Display is a read only view of the default artwork item. It is identical in functionality to the popup artwork display to the left of the Comments field on the Info panel. Artwork Metadata is a read only display of the metadata associated with the default artwork item.

Limitations:

• Only vertically resizable components with no components below them will be automatically vertically resized.
• When exporting preferences to a Mac with a lower display resolution it is possible that the minimum size requirements are greater than the size of the display. If this happens open the Custom Panel Editor, reduce the visible number of grid rows and then save the panel. This may have to be repeated for all three custom panels.

File Browser

• A File Browser panel can be added to the main window (at the left or right). This browser lets you traverse the file system and open content in the Yate file list.
• You can load audio files, artwork, csv files and m3u files via a context menu or by dragging the files into the file list panel.
• Files can be dragged from the File Browser to the desktop or a Finder window.
• Files displayed in the File Browser can be revealed in the Finder. Open files in Yate can be revealed in the File Browser.
• The content and format of the display can be controlled via a View context menu item.
• All content can be previewed.

Audio Information Panel

• The bottom area of the File Browser vertical panel can be used to display an audio information panel. This is equivalent to the audio information area in the built in Audio panel.
• Yate now displays the bits per sample for ALAC encoded m4a or mp4 files.

Field changes

• Yate used to internally maintain the Disc Count and Track Count combined with the Disc and Track fields. This was done largely due an adherence to the ID3 standard. This was becoming a liability for a lot of functionality. All four fields are now individually maintained. This change will only be meaningful if you used an action to cheat and set both values in a single operation. Note that this does not change how the values are stored in the audio files.
• Every track now has five Custom fields named Custom 1, ..., Custom 5. These fields can be mapped onto custom panels using the new Panel Editor.

Action Changes

• The Clean Multiple Items, More than One Item and More than One Item Test actions have been modified to handle all multiple item fields which have the concept of a default value.
• When exporting a single action you can now do a smart export. This mode will export the action, all called actions and all other Yate components which are referenced in the action. A prefix string can be supplied which will be used to change the name of all referenced items. This makes it easier to import without collisions.
• A new escape sequence, U has been added. \U is used to create a unique pattern based on a time stamp. If you are using Yate on more than one Mac, the pattern is unique as long as both Macs have the correct time and you are not running more than one version of Yate at a time. The format of the pattern is number.number{+number}.
• A new escape sequence \I# has been added. The sequence will insert the leading integer value in variable #. If there is no leading integer value, 0 will be inserted.
• A new escape sequence \F# has been added. The sequence will insert the leading number in variable #. The inserted value will have at least one decimal and one fractional digit. If there is no leading number, 0.0 will be inserted.
• Added a new function named Database ID. This is a convenience method used to create/clear User Defined Text Items named Yate Album ID and Yate Track ID.
• Added a new function named Test If File Exists. The function can test if a file system item exists and is a file, folder or either. If the criteria is met the action test state will be set to true, otherwise false.
• The Import Metadata from Audio Files function now preserves the current Variable values.
• The Import Metadata from Audio Files function and the Copy Metadata UI based functions will no longer remove existing Unhandled metadata items. (Unhandled items are not copied).
• New properties accessible via the Get Property function to make it easier to determine the name of the folder containing a track's folder. Parent Folder Name, Path to Parent Folder, Original Parent Folder Name, Original Path to Parent Folder.
• The Trim function has been significant enhanced. You can now choose a combination of different character sets from: All non alphanumeric characters; whitespace characters; newline characters and punctuation characters. You can optionally remove any combination of leading and trailing characters. You can also change any sequence of the specified characters to a single space or newline character. You can perform the trim operation on a named variable or on any number of fields.
• Import Text File has been renamed Read Text File.
• Added a Write Text File function.
• Added an Evaluate Expression function used to evaluate an arithmetic expression and return the result in a variable.
• Added an Exit Grouped function which successively returns out of all actions being run grouped and then resumes processing at the next statement.

Preference Changes

• iTunes settings now have their own preference section.
• Preferences-General has a new option called Use strict iTunes definition of 'default' comment. Many audio players define the default comment as the first comment with an empty description field. iTunes seems to also require that the language is eng.
• Preferences-General has a new option called Update Preview on selection changes. When enabled changing a selection while previewing will update the preview.
• In Preferences-File List you can now configure the file list context menu, excluding items which do not interest you.
• In Preferences-File List the User Defined Text Information column mappings are now called Mappings as opposed to Custom. When mapping the columns from the file list table headers context menu they are called Mapping 1, Mapping 2 and Mapping 3.
• In Preferences-File List you can now choose to auto-select files after loading if the Open Mode is Album-Replace Existing Files.
• Custom fields can be assigned display names in Preferences-File List. The display names are used as file list column headers and when the custom fields are used in custom panels.
• The help button for the window is now displayed on a toolbar. The toolbar can be hidden via the Window menu or from the toolbar's context menu. If you have assigned the Menu>Help for Current Context to a shortcut the same help will be displayed.
• In Preferences-Search templates you can now specify that you want Title metadata to be included while searching. If more than one file is selected while searching only one title is used.

Track and Album Databases

• You can now filter out data. For example remove all items with the same content where I clicked.
• You can now issue simple queries against a database to obtain counts of items and paths to items.
• The file list context menu item Show in Database now removes the current filter if the tracks are located.
• There is a new file list context menu item called Show in Database (Original). Tracks are located in a album database by matching a track's Album metadata and the tracks' containing folder. Tracks are located in a track database by matching the file path. If any of this data has changed the Show in Database function will fail. The Original variant uses the data in place when the tracks were first opened (or last saved).
• Album databases which have a Yate Album ID field have stronger references to each row's associated album. This field allows you to change an album's title or folder and still be able to associate the items. When this field is present in a database it will be used as the default matching criteria when associating database items with open tracks. When the field is not present or an album id match cannot be made, the default criteria of the Album field and folder path will be used.
• Track databases which have a Yate Track ID field have stronger references to each row's associated track. This field allows you to change a tracks's location and still be able to associate the items. When this field is present in a database it will be used as the default matching criteria when associating database items with open tracks. When the field is not present or a track id match cannot be made, the default criteria of the file path will be used.

Discogs and MusicBrainz Wizards

• The function button in the Releases step of the wizards has been replaced with a context menu in the lower table.
• Both wizards now support the manual specification of a release id by specifying the Album search field as id=release id.

AcoustID

• There is a new menu/context menu function named Fingerprint, Get Data, Import... which successively performs the three functions: Create AcoustID Fingerprint, Get Data from AcoustID, Import AcoustID Recording Information...
• A main window toolbar item to represent the above function has been added.