Yate Release Notes

Version 4.7.1 (8092)

      Application Help

• There is a new Search Yate Help item on the Help menu.
• The Search Help panel locates topics containing your specified pattern and display's each topic's title. Searching can be done by contains, match start or word boundaries.
• Double clicking on a title or using the context menu, you can launch the associated help page in your browser. In the browser you can use the native find support to locate the pattern.
• There is an option to automatically position the opened content to the search pattern.
• Specifying * as the search pattern will display a list of all the help topics.

      Preferences

• When saving artwork to folder icons, you can now optionally have the corners rounded. Preferences - Artwork has a new setting named Round corners when saving icons. Note that this setting affects the UI and action based saving to folder icon functionality. It also affects the creation of custom toolbar icons for actions.

      Action Statements

• The Remove List Item at Index statement now supports negative indexes with the same logic as the List Item at Index statement.
• The Preferences statement has a new single setting override called Rounded Icon Corners.
• The Remove from iTunes startement will now also remove any retained PIDs.

      MPEG-4 Files

• Up until v4.0, MPEG-4 files which had no audio or video data would not be loaded. As of v4.0, the file could be loaded and edited. These files are damaged and once again will not be loaded.
• MPEG-4 files will now automatically be repaired, under the right conditions, if the low level component containing the audio data is present but has a garbled identifier.

      The Multi Field Editor

• An Exchange function has been added. The contents of two specified fields are exchanged.

      Database Files

• From a database file's context menu you can now create an alias to the file on the desktop. This really only makes sense if you set the file, or all files of the same type, to open in Yate. You can do this in the Finder's Get Info panel.

      File to Tag Templates

• When extracting to a field which requires a numeric value, all extraneous text after the number will automatically be tossed. For example extracting 2 file to a Track field will only retain the '2'.
• See the online help in the File to Tag token editor for additional information and as to how this differs from the Numeric qualifier.

      Blue Text in the Edit Panels

• Previously blue text was used to indicate the presense of control, newline or tab characters in fields where they are not valid.
• Text will now also be blue for extraneous data after the number in a numeric only field.
• When the text is blue, the associated function button will have a menu item named Why is the Text Blue?

      Bug Fixes

• The Discogs Metadata for Release statement was not exporting the full date for the Year key, even when available.
• The Discogs Metadata for Release statement had a potential crash depending on the received JSON data.
• The MusicBrainz Metadata for Release statement was not exporting the following per track keys: Recording date, Recording end date, Recording location and Recording start date.
• When executing an Add to iTunes statement in the Batch Processor the optional import of the PID was not performed unless the Verbose option was set.
• When importing from iTunes, Loves/Dislikes values were not handled correctly.
• The Episode ID field's Synthesize function was not working.
• Worked around an issue on Mac OS 10.14 or later where interaction with iTunes was not freeing resources.
• When batch processing an Access Discogs or Access MusicBrainz statement would crash if the action has a Batch Start sub action.
• The Clear User Defined Items statement was missing tMDb and Yate as sources.

Version 4.7.0.2 (8036)

      Bug Fixes

• The Repeat With statement's escaping of the source delimiter was broken for a source list in a named variable. Introduced in v4.7. Both the Repeat With and Build List statements now always handle escape sequences in the source delimiter field. Previously when the delimiter field was interpreted as characters, it was not unescaped.

Version 4.7.0.1 (8034)

      Bug Fixes

• The Preferences-General-Custom Fields configurator was validating the supplied FLAC/OGG name for the APE field.
• Attempting to set an FLAC/OGG/APE Custom Field mapping to a name already mapped as an Involved People List Item would cause a crash.
• The new inline expression sequences were documented incorrectly as \\x(expression\\x.) and \\x(expression\\x) ... The correct sequences are \x(expression\x.) and \x(expression\x)

Version 4.7 (8033)

      Additional Component Installation

• This version of the application requires installation of a few components.
• When you run the application you will be prompted to install the components.
• There is a new menu item named Install Additional Components on the Yate menu. This is primarily to handle the case where internet connectivity may be down when you first run the application.
• To handle the case where you run Yate in a secure environment with limited or no connectivity, instructions are supplied in a new topic called Manually Installing Required Components which can be found in the main help file.
• This version is the first where the application is hardened and notarized by Apple.

      iTunes

• As is currently done when saving files, Refresh iTunes will now export library only settings enabled in Preferences-iTunes-Auto Export. This means if you made changes while not linked to iTunes, you can now link and do a Refresh iTunes without having to also do an export. This change is also implemented in the associated action statement.

      Dark Mode

• The online help now enables the new Safari dark mode support.
• The inline display of online help in an Action Editor Window will now change its appearance when the window displays in dark mode.

      Custom Fields

• You can specify that a Custom Field should be displayed as a Checkbox via the Custom Panel Editor and as a Yes/No value in an Export Set. Previously there was no method of specifying a Yes/No display when a custom field is associated with a main window column. In Preferences-General-Custom Fields you can now specify that an associated main window column is to be displayed and edited as a Yes/No (boolean) value.

      Main Window

• Columns which display a value of Yes or No, now display ✓ for Yes and empty for No. Double clicking on any of these columns allows you to select Yes or No for all selected files. When inline editing, you can enter Y, Yes, True, any non zero integer value and most Unicode check mark characters for a value of Yes. Any other value is treated as No. The entered value is case insensitive.
• The Audio Properties table in the File Browser and on the Audio-General panel no longer has an ID3 Version field. The field has been renamed to Tag Scheme and displays additional information.
• There is a new built in sort preset called Video Sort available on the table header's content menu.
• Additional help topics on column layout presets, column sorting and autosizing are available on the main help page.

      MusicBrainz

• There is a new Preferences-MusicBrainz setting called Always load Release Group. When this is set, a release group will always be loaded enabling the search for information which might not be present in the release. Currently this additional information includes Relationship URLs which can include a variety of interesting links to sources such as WikiPedia, lyrics, etc.
• Some tracks in a release have location/date metadata. This is of particular interest to people organizing classical music libraries. Roon is capable of reading the metadata. Four new normalized UDTIs have been introduced named: Recording Date, Recording Start Date, Recording End Date and Recording Location. There are four associated import items available in the wizard. Note that MusicBrainz returns the start and end dates. The Recording Date is included simply for completeness and if imported is always the same as Recording Start Time.

      MP3 Files

• When reading MP3 files which contain multiple tag constructs, the priority is ID3V2, APE, ID3V1.
• Note that APE tags are always tossed when an MP3 file is written.

      Overriding the Open Mode

• By default, Yate preserves its Open Mode settings. You can now override this behaviour in three different situations. You configure the functionality in Preferences-File List.

      Key Entry in Preferences

• In order to avoid errors when pasting keys into Preferences for APISEEDS and Fanart, the keys are now sanitized. After removing control characters and spaces, the first non empty line is retained as the key.

      Properties

• There is a new Ape Version property which is set for all files containing APE tags (including MP3).

      Action Statement Changes

• The Manipulate Artwork statement can now explicitly set a JPEG encoding to Baseline or Progressive. You can also now explicitly set the compression factor to the system default. Some options, previously restricted, are now available in more situations to avoid unnecessary manipulations.
• The Contents of Folder statement has a new option called Full paths. When set, full paths as opposed to filenames or folder names will be returned. A Choose button was also added.
• The Enumerate Tag Sets and Fields statement now inverts inverted Tag Sets before returning them.
• The Save statement's, Save MP3 files which have an ID3V1 tag option has been renamed to Save files with non standard tag containers. Essentially the semantics have been extended to force save any file which contains a non standard tag container. eg. APE or FLAC files with ID3 tags
• The List Count statement has a new option to save per file counts.
• The Exists statement now allows the specification of the set of fields to be tested as a list of symbolic field names which can effectively be specified at runtime.
• There is a new statement named Prompt for Fields. The statement can be used at runtime to choose fields. Full granularity is provided as to what fields are displayed and which are initially set.
• There is a new statement named Set Tag Set. The statement takes a list of fields and applies it to an existing tag set or automatically creates a new one. If there are no fields in the list, an existing tag set will be removed.

      Escape Sequences

• Numeric expressions can now be evaluated in escape sequences.
  • \x(expression\x) will evaluate expression as in the Evaluate Expression statement and may contain nested escape sequences. Note that the terminating sequence has a leading \ character. If the expression cannot be evaluated nothing is inserted. If the expression evaluation works, the inserted text will always be an integer value.
  • \x(expression\.x) will evaluate expression as in the Evaluate Expression statement and may contain nested escape sequences. Note that the terminating sequence has a leading \ character. If the expression cannot be evaluated nothing is inserted. If the expression evaluation works, the inserted text may or may not include a fractional component.
• If the Shift key is depressed when invoking the context menu containing the Yate Field and Yate Initial Field submenus, all fields as opposed to only those with a single or default item are displayed .

      Database Viewers

• There is a new context menu item called Display Column Mappings. The database's column mappings will be displayed in the Log Viewer. Essentially export set metadata will be displayed.

      Cosmetic Changes

• The [+], [-], etc. buttons under tables in various panels now display larger than in the past.
• The Discogs and MusicBrainz wizards' Release window now changes the size of both tables with Cmd+ and Cmd-. Previously only the bottom table was adjusted.
• Link controls on edit panels are now blue.

      Bug Fixes

• The Set Open Mode statement was not preserving a setting of Playlist mode.
• Preferences-General-Notifications-Remove Notification on Exit in Prefs-Notifications was never enabled. Introduced when Growl support was dropped.
• The Create Stubs and Set Action Test State from File Type statements were not properly enabling WavPack.
• The List Manipulate statement when performing Remove One/Match, was not properly handling empty delimiter fields. They should have been defaulted to \~.
• When creating databases and preserving the sidecar file, the test for equality was a little too lax.
• While not really a bug, the regular expression Return Ranges+ option was returning a ridiculously large number for a not found capture group. The length field was correct at 0. Simply for legibility reasons, a -1 will now be returned instead. ie. -1,0
• When searching for Variable 0 in an action editor, a Set Action Test State statement which was not using variables as a source, would be matched.
• The Category field when not associated with a list was displaying the same list components as Content Advisory.
• The Enumerate Tag Sets and Fields statement with the Create a list of all non simple text fields option was not returning the correct list.
• The Action Editor window's Find panel was not displaying the correct per-type choices.