Yate Release Notes

Version 6.5.0.1 (10421.10417)

      The Main Window

• There is a new built in sort named Title - Artist Sort.

      Bug Fixes

• v6.5 updated Debug statements such that Beep was cleared and Log was set. Setting Log only makes a difference if you are debugging a batch process.
• The call stack on Debug statements had incorrect line numbers on special conditions such as 'run once'.
• If you selected a Move non Audio statement which had Delete Empty Parent Folder set, it was cleared.
• If you exported a file's metadata using File>Export more than once since Yate was started, the subsequent exports were not writing the artwork files.
• When importing metadata via File>Import, an artwork item's Picture Type was always set to Other.
• The Path Manipulation statement had issues when the path was in a track variable and the function was Set the Filename Extension or Append a Path Component.

Version 6.5 (10420.10417)

      Application

• m4r files can now be loaded.

      Main Window

• There is a new main window column and filter item named Tag Scheme.

      Dock Icon Behaviour

• There is a new Preferences - General setting to control what happens when the dock icon is clicked.
• The default is Show the Main Window which is Yate's previous behaviour.
• Preserve the Window Layout attempts to preserve the current window layout.
• Active Dependent Behaviour is equivalent to Show the Main Window when the application is active or Preserve the Window Layout when inactive.

      Opening Files

• Files can now be loaded in to the main window or to the Artwork Viewer via URLs. Do a Help>Search Yate Help for the Opening Files by URLs topic for additional information.

      Droplets

• Many Yate actions do not require audio files to be loaded in order to execute. You can now create droplets to these files which run directly when opened. See Preferences - General - Droplets for additional information.

      Discogs

• The Preferences-Discogs-General setting to Prefer Artist Name Variations (ANV) now has three values. Never and Always correspond to the previous settings. Latin Name Resolution will only substitute an ANV if an artist name contains non Latin-1 characters and the ANV contains only Latin-1 characters.

      Lyrics

• APISEEDS is no longer handling requests. Support has been removed.

      The Batch Processor

• Suppressed various logging information types unless Verbose is enabled.
• The Batch Processor can now be started from within an action. When the Batch Processor starts, its display panel will be positioned such that you have to click on the Start button to proceed. This behaviour can be avoided by the new Preferences - Actions setting named Enable Batch Processor auto start from Stop Action and Run Batch Processor.

      The Combined Credits Editor

• The credits table has been updated from the latest Discogs, MusicBrainz and Roon credits lists. There are now 7427 built in credits.
• The Alias column has been renamed Alias Of.
• Note that all Roon credits which are aliases now have the Alias Of column populated with the name of the canonical credit. If an alias was previously entered for an item, it will not be modified.
• The Known Credits table has a new context menu item named Validate Known Credits table. The function looks for issues in the table. Issues are typically associated with invalid Alias Of definitions. If any issues are found they are displayed in the Log Viewer.

      The View Menu

• The Credits Invalid for Roon function now performs a deeper analysis. The use of an alias is now reported.

      The Help Menu

• The Help menu's Quick Reference submenu has additional items.

      Search Templates

• You can now choose to use + or space as the metadata keyword delimiter.

      The Action Manager

• The context menu items have been somewhat reordered.
• The Set as Toolbar action context menu items have been moved to a submenu.
• When exporting a single folder, the folder name field in the export panel will be populated.

      Action Editor Windows

• You can no longer disable the display of line numbers. They're always displayed.
• The vertical bar after line numbers is now always displayed.
• The Run Action context menu item will now prompt you if there are unsaved changes and will allow you to save and run.
• The context menu items have been somewhat reordered.
• You can now search for occurrences of particular statements in the Find Panel. You must select the statement in the Function statement column before opening the Find Panel. As with other find entities you can find the next, previous or all occurrences.

      Preferences - Actions

• There is a new setting which allows you to enable or disable the auto-resizing of the Action Pending window.
• The option to disable the vertical grid line after lines numbers in Action Editor windows has been removed.
• There is a new setting to enable batch processing to start immediately after execution of a Stop Action and Start Batch Processor statement.

      Action Pending Window

• You no longer have to click on the displayed text to modify the size of the display font.
• If you right click on the window's icon, a menu will be displayed where you can enable or disable auto-resizing of the window. If you enable it, the window will be resized immediately.

      Action Statement Changes

• The Copy Non Audio Files and Move Non Audio Files statements have a new Overwrite existing subfolders option. Careful here!
  
  
• The Artwork to Folder Icon statement has a new Silent option. You can now also save an icon to a specified folder.
  
  
• The Artwork to Folder jpg statement has a new Silent option.
  
  
• The Debug statement has been completely overhauled.
  • The choice of which content is displayed is now configured at runtime.
  • At runtime when the Action Pending Window is displayed for the Debug statement, there is a Configure button. This allows you to change the displayed content on the fly. You can also modify the default settings.
  • To the right of the Configure button is a disclosure button which displays a menu providing additional capabilities:
    • You can open an action in an editor window ... even while batch processing. As is currently the case, changes to these windows cannot be saved while action processing.
    • You can display the metadata in the Log Viewer for all active files as if a View>Metadata as Text was executed.
    • When executing grouped or after a Load & Run statement, you can choose to display the metadata for the current file.
  • The displayed information now uses colour coding and where necessary monospace fonts to enhance the ability to quickly and properly view the information.
  • Properties can now be displayed as well as track variables. You can choose which properties you are interested in.
  • Empty track, named and system variables are no longer displayed. Empty properties are not displayed as well.
  • The Execution Mode can now be displayed.
  • A list of active files can now be displayed.
  • The step info area can now be hidden as depending on the displayed content it may be redundant.
  • You can no longer change the default text colour. However, markup is supported in the text prompt.
  • You can no longer display a checkbox on the panel.
  • The window title is now always Yate Debug.
  
  
• There is a new statement named Delete Files and Folders. This statement is extremely dangerous. Please read the documentation.
  
  
• The Import Artwork statement has a new setting to enable scaling of the imported images.
  
  
• The Involved People/Musician Credits Functions statement has two new functions: Credits Which are Aliases and Credits Which are not Defined.
  
  
• The List Contains Test statement now supports the per file testing against a list in a named variable. All fields are re-escaped wherever appropriate for each processed file. There is a new trimmed option which tests trimmed values against trimmed lists.
  
  
• There is a new statement named Load Artwork Viewer which can load an image file or the artwork contained in an audio file to the Artwork Viewer. The statement can also be used to close the Artwork Viewer.
  
  
• The Log statement now allows you to save the results to a Log named variable or per track variables.
  
  
• The Manipulate Artwork statement now accepts empty or 0 as a scale factor. It implies use the Preferences-Artwork scale value.
  
  
• The Map Metadata to Files statement can now specify criteria at runtime.
  
  
• The Open URL statement can now handle callbacks and the acquisition of downloaded data. The statement's online help contains additional information. There is a new escape sequence \?ou which serves as a callback marker in the URL.
  
  
• The Play System Sound statement can now play a sound from a file at a specified path. The sound is cropped at 5 seconds.
  
  
• Prompt category statements:
  • User interface markup:
    • The Ask, Debug, Prompt and Prompt for Text statements can optionally use a simple markup scheme in the displayed text.
    • The markup supports the display of bold and italic text, proportional and fixed width text and text colouring.
    • More information can be found in the online help for the above statements or via Help>QuickReference>Prompt Markup Sequences.
  • Statements with configurable buttons no longer have a requirement that the displayed buttons have to be contiguous. Note that discontiguous buttons will not display as expected on the Prompt statement with an Alert or Critical Alert display mode.
  • With statements with configurable buttons, which button, if any, is the default button can now be configured.
  • Statements displaying a Cancel button have a slightly modified default behaviour. The Cancel button warning gets reset to warn each time Yate is started. You can still temporarily dismiss the warning but not when batch processing.
  • You can now explicitly control whether a warning is issued when a cancel button is hit.
  • Checkboxes can now be displayed without the images essentially allowing you to specify an out of bounds text label.
  
  
• The Prompt for Text statement:
  • Menu items displayed on the picker list can now be displayed as a separator line.
  • Menu items displayed on the picker list can be prefixed by a ✓ character.
  • Menu items on the picker list can be configured to close the window when selected. Either honouring the format requirements or ignoring them.
  • There are two new formatting options for the results. Sequences of multiple spaces can be compressed and characters can be marked as invalid.
  • Documentation for the statement's menu item special sequences and its formatting option codes can be referenced from the Help>Quick Reference menu.
  • When specifying a picker menu in the Prompt For Text List named variable, all trailing newline characters are removed. This is to avoid the inadvertent display of empty menu items.
  • The Prompt for Text List R/O and Prompt for Text List Overwrite named variables are now deprecated. Their functionality has been replaced by format codes in the Prompt for Text Formatting named variable. The deprecated named variables will continue to operate for now unless. The new format codes have a higher precedence.
  • The text field can now be hidden if you want the user to only be able to choose a menu item. This is controlled by the new H format code.
  • There is a new button type named Continue-Always. A button of this type exits without validating the text field.
  
  
• The Re-Encode statement now has a URL escape sequence function for query values.
  
  
• The Remove Folder Icon statement can now remove an icon on a specified folder.
  
  
• The Rename Files statement has a new silent option which is enabled by default for new statements.
  
  
• New Save statements now default to Selected Files as opposed to All Files.
  
  
• The Search Discogs and Search MusicBrainz statements can now override the results limit at runtime.
  
  
• The Set Action Runtime Setting statement can now remove all settings in the currently mapped set. This is done by by setting # to empty.
  
  
• The Stop Action and Open Files statement can now selectively close and/or open individual files, ignoring the Open Mode.
  
  
• There is a new statement named Stop Action and Run Batch Processor. All configuration for the batch processor is supplied. The user is presented with the information as to which action is about to run and can select Cancel or Start. Optionally there is a new Preferences - Actions setting to allow for the immediate start of the batch processor.
  
  
• The Test File Type statement:
  • When testing for MPEG-4 files, the statement can now test for Any, AAC or ALAC.
  • The statement now applies the standard Set, And, Or semantics for the test state as well as any variables being saved. Previously the test state was set to true on success regardless of the specified mode.
  
  
• The Test if File Exists statement:
  • The statement now returns creation and modification dates as well as file sizes.
  • You can Set, And or Or the result of the test to the action test state. Tests are only performed when necessary.
  
  
• The Transfer Metadata statement, when transferring out:
  • There is a new option to copy the source file's modification date to the destination file.
  • There is a new option to only write a file if something has changed after transferring the metadata.
  
  
• The Trash Items statement has been renamed to Trash Files and Folders.

      New Actions on the Resource Page

• Identify Apple App Metadata Discrepancies. An action to identify values in iTunes/Music which should be identical to those stored in the file but are not. This was a long standing iTunes issue.
• Lookup Wikipedia Artist Bio. A user facing action and an action which can be called to lookup artist bios and artwork on Wikipedia.
• Permute 3 Convert Selected Files. An action to encode files using Permute 3.
• Sync Files. A set of actions to synchronize metadata between files in different root folders. Copying of missing audio files and non audio files can be performed. Permute 3 can also be used to convert missing files.
• Many other actions were updated.

      Bug Fixes

• When explicitly specifying a text colour of Black, Red or Blue in an Ask, Debug, Prompt or Prompt for Text statement, the colours were not optimized for dark mode.
• Error messages were incorrectly being accumulated in Discogs/MusicBrainz Metadata for Release and Search Discogs/MusicBrainz statements. This could cause incorrect results in repetitive calls. It could also cause the Data Source Access Error named variable to contain garbage. The Search Discogs/MusicBrainz actions on the resource page could be affected.
• The Preferences-MusicBrainz-General Latin artist names setting was not substituting in single names. ie. no first name.
• Exclusions on the Prompt for Fields statement were not working correctly.
• The Sort Track List statement has been patched. At some point in the distant past it started sorting on incorrect columns.
• If the Log Viewer, Notepad or the Action Pending window was closed with an open find panel, a soft crash could occur when they were reopened.
• When an explicit true/false label was set on an Ask statement, the defaults were being changed.
• The Debug statement was changing the button and picker list selection named variables.
• Debug statement lines numbers at times were off by 1 or 2.
• If you renamed an action or preference item and it initially was the same name as was referenced on a Map Action Runtime Settings statement, the statement would have its set renamed. It should only be renamed if a runtime set was being renamed.
• Disabled Start statements were being recognized at runtime and in Action Editor Windows.
• The Append and Prepend statements were not immediately updating the display after using the multi line editor.
• The Ignore Files statement was not logging its track variable usage.
• The Test File Type statement was not applying the Set, And, Or semantics to the test state ... only to variables.
• m4a UDTI Apple Store Playlist ID was being incorrectly stored as a UDTI as opposed to a plID atom. Saving a file again will correct the issue.