Yate Release Notes

Version 9.0.0.1 (12643.12470)

      Bug Fix

• The introduction of a Replacement Set mode in Replace statements caused all periods to be removed when renaming files.

Version 9.0 (12642.12470)

      The Snippet Manager

• The Snippet Manager serves to store snippets which are functions performed by the Multi Field Editor.
• A retained snippet completely represents a Multi Field Editor function at the time it was executed. This includes the list of selected fields.
• Snippets can be supplied user specific names and can be exported back to the Multi Field Editor.
• Snippets can be exported to and imported from the filesystem.
• Any list of selected snippets can be used to automatically generate an action.
• The Snippet Manager can be displayed from the Multi Field Editor or via the Actions menu.
• The location of the snippets file can be changed in Settings - General - Advanced. This is to facilitate the sharing of settings.

      The Multi Field Editor

• The Replace function has a new mode to apply a provided replacement template to the selected fields.
• The Set function has a new mode named Set Using Rename Template. The mode uses a rename template to populate the selected fields. Only the filename portion of the template is used. ie. Folder Start sections and IfDup tokens are ignored. The test for characters invalid in Mac filenames is not performed. All other configurable template settings are applied.
• The Trim function now allows you to specify an other sequence when replacing sequences of the chosen character sets. Previously you could only specify a space or newline character.
• The MFE now interacts directly with the new Snippet Manager. The functionality can be enabled or disabled by the recording control.

      The Create Move Action Wizard

• The wizard has been completely rewritten to handle virtually all types of moves.
• Copy is now supported as well as move.
• Linking to an Apple App is now supported.
• Logging is now supported ... even when not batch processing.
• Additional folder validation is now performed.
• Folder validation and moving non audio files is automatically adjusted when moving to or from disc subfolders.
• Alpha tokens are supported with the ability to override the configured default settings.
• A produced action can support immediate mode, batch mode or both.
• Keep Both is now supported as a file already exists function. This requires that the supplied rename template has an IfDup and Dup # tokens.
• Different modes can be supplied for immediate and batch mode handling of a file already exists.
• A Wrapper action can automatically be generated to allow for extending the functionality.

      Album Ratings in iTunes/Music

• Apple Album Ratings are a mess. They can be synthesized and can change at seemingly any time in the application. Music can be closed and reopened and then display different synthesized ratings.
• The grey/black unwanted ratings appearing in the Ratings column can be annoying and distracting.
• Prior to this release the Settings - Apple Apps - Auto Export panel had a setting to clear the album rating. This setting was used by all exports. The setting only cleared the album rating if the Apple App identified that it had an explicit album rating.
• At least within the Music application, disabling synthesized album ratings works far better if every track in an album has disabled them.
• The issue with the previous setting was that it was conditional, so it was possible that not all tracks were modifed in Music when an export occured.
• The setting has been moved to the Apple Apps General panel as it applies to all exports.
• The setting when enabled, now has two possible values. Explicit is equivalent to the conditional implementation in prior releases. Explicit and Synthesized will unconditionally clear the album rating for all files which are exported. This method is potentially slower. If Explicit works for you, use that setting. If you're still seeing grey/black ratings in Music, switch to Explicit and Synthesized.

      The View Menu

• The View menu has new items to display and flush the database log optionally used by actions produced by the Create Move Action Wizard.

      Replacement Sets

• Replacement set items can now be regular expressions.
• +T replaces the + control and is used to create text replace items.
• +R is used to create regular expression replace items.
• Note that as of v8.3.5, the panel as ordered is now the order in which which the replacements are applied. The panel is no longer sorted and you can use drag & drop to rearrange the items.
• Case insensitivity is now available as a column in the table.
• Escape sequences in text replace items are now deprecated.
• Additional information is described in a topic called Settings - Replacements.

      Rename Settings

• If you want to disable multi value delimiter substitutions you can enter \m as the replacement field. This is equivalent to entering the multi value delimiter text.
• You can now install actions which are bundles of sample rename templates.
• Clicking on the 🌐 button will open the Action Updater. Actions containing rename template bundles will be listed, even if already installed.
• This is a quick means of identifying rename template bundle actions. These rename template bundle actions only purpose is to make it easier to install sample rename templates provided on the Yate web resources page.
• These rename template bundle actions are marked as Hidden in the Action Manager and will not appear on action selection menus. By selecting one of the actions in the Action Manager and choosing Resource Documentation from the context menu, you can easily see the online help for the templates.

      Rename Templates

• The Encoding control now supports Fold Unicode which only performs Unicode character folding.
• All Encoding control items now perform Unicode character folding. Previously Remove Accents did not.
• The advanced rename template settings panel has a new item named Apply transformations for Alpha. This is equivalent to the Apply transformations for IfDup settings but for the Alpha token. Transformations are applied before computing the alpha sequence.
• If you want to disable multi value delimiter substitutions you can enter \m after a Multi Value Delimiter token. This is equivalent to entering the multi value delimiter text.
• There is a new token named IfExpression which supports the construction of complex expressions based on the content of fields, properties, track variables, integers ans strings. Most If token types in the past, tested only for existence.

      File to Tag, Rename and Search Templates

• Each panel's context menu has new items to allow to to set multiple items as hidden or not hidden.
• The three template panels have a new filter button which allows you to display all templates, only templates which are not hidden or only templates which are hidden. The filter is automatically cleared when new items are added; and possibly when locating a template from a menu or an action statement's Show button. Not that changing a template's hidden status does not remove the item from the display automatically.

      The Action Manager

• The Log and Display Usage Information functions are now deep. ie. actions which are not selected but are called will automatically be selected.
• The same functions now identify actions called which are not defined. ie. they do not exist.

      The Action Updater

• When actions are installed by the updater, only actions are updated. Any other components associated with the actions are only installed if they are missing. This means that any customization you have made to rename templates, export sets, etc., will not be lost. Custom field definitions are always validated and confirmed if they differ.
• You can now force the refresh of all components by setting the Overwrite all preexisting components checkbox. When this setting is enabled, you will completely overwrite all components bundled with the selected actions.

      MusicBrainz

• All MusicBrainz extraction functionality now allows for the import of the Album Id and Album Artist Id.
• Enhanced the parse algorithm used in classical decomposition

      Main Window Filtering

• Added a filter named Artwork Mime Type.

      Search Yate Help

• Previously you had to manually create bookmarks to web resource page documents in the Help>Search Yate Help panel.
• This is now done automatically if you have Settings-General Automatically check for action updates enabled. New documents and updates will be bookmarked.
• The web page bookmarks now include the document version and the post date.
• You can no longer remove the resource page bookmarks. They are now grouped under a single expandable item.

      Field Lists in Action Statements

• Many action statement process a list of fields contained in a named variable. In the past these were always normalized field lists. ie. they specified the fields to be processed.
• Tag Sets can be normalized or inverted where they specify a list of fields not to be processed.
• Field lists can now be inverted by specifying a - as the first list item. -,Artist implies all fields except for Artist. Additional information can be found in the Field Lists topic which has been added as a bookmark to the Search Yate Help panel.

      The Batch Chain

• When an action is started in the Batch Processor, optional inline Batch Start and Batch End actions will be called.
• If the started action calls other actions which were designed to run directly through the Batch Processor, their Batch Start and Batch End actions are not called.
• There is a new methodology which uses the Include statement to create a batch chain which contains other actions where Batch Start and Batch End should be called.
• The methodology is described in a topic called The Batch Chain.

      Action Statement Changes

• The Compare Text statement has a few new path oriented tests and a new exact option:
  
  

  Contains Path At

  The source path must be a folder and both paths must exist. The function returns true if the source folder's path contains the second path.

  Contains or is Equal to Path At

  The source path must be a folder and both paths must exist. The function returns true if the source folder's path is the same as or contains the second path.

  Overlaps Path At

  Is equivalent to left Contains or is Equal to Path At right or right Contains path at left

  exact

  The statement by default ignores low level character encoding. If two text items being compared are identical except that one is encoded as UNFC and the other UNFD, the statement will return true. The strings have the same characters! The new exact option allows to override this behaviour when performing {in}equality tests.
  
  

• The Copy Files, Create Symbolic Links and Move statements
  
  
  • The statements now set a new property named Retained Status. The property offers additional information on a per file result. You can now tell if a file was skipped which is not indicated as an error.
  • The Move statement previously had a Runtime override setting which allowed you to change a Move to a Copy Files function at runtime. This is done by setting a named variable Override Move to Copy.
  • All three statements now have a control which when enabled allows you to override the what to do if a file exists handling at runtime. This is done by setting a named variable Override Move to Copy.
  • All three statement now have keep both functionality. The use differs when the statement is run in immediate mode and in batch mode. Keep Both is only available at runtime if a rename template is specified which uses an (IfDup) token.
  • The Move statement now also supports overriding the delete empty folders functionality at runtime. Named variable Delete Empty Folders Override is used.
  • The Move statement can now explicitly delete up to five levels of empty folders or all empty folders.
  
  
• All statements which support statement transformations now have a Fold Unicode function which performs Unicode character substitution. All encoding functions now perform Unicode character substitution. Previously Remove Accents did not. The affected statements are: Copy Files, Create Symbolic Links, Export Metadata, Import Metadata, Import Metadata from Audio and Move.
  
  
• The Copy Non Audio Files and Move Non Audio Files have additional runtime override capabilities.
  
  
• The Create Album Database and Create Track Database statements have a new setting. If Standalone, Create only and Preserve sidecar are all checked, a Preserve file control will be enabled. When Preserve file is enabled, an existing database file will be preserved if the sidecar can be preserved. If the sidecar file cannot be preserved as is, the database file, if any, will be completely overwritten.
  
  
• There is a new action statement named Create List. This is useful to create empty lists of a fixed size and to generate lists which contain numeric sequences.
  
  
• Enhanced the parser for the Decompose Title into Classical Metadata statement.
  
  
• The Export to Apple App statement now supports clearing album ratings as Explicit or Explicit and Synthesized.
  
  
• There is a new statement named Get Inclusion in Track List. The statement sets a track variable to true or false if the associated file's Disc-Track fields fall within a specified list. The list is formatted the same as in the Multi Field Editor's Credits panel.
  
  
• The Get Info statement:
  • There is a new setting to extract named export sets (which makes sense). The new encoding is extracted via Named Replacement Set. The older extraction methods (now deprecated) use Named Replacement Set (Legacy).
  • The Named Exception Set function can now optionally allow the extraction of an inverted set.
  
  
• The Include statement has a new item type named Batch Chain Action.
  
  
• There is a new statement named Insert Numeric Sequence. The statement mimics the Multi Fiel Editor's Insert Sequence function where the number being inserted is incremented only once per file.
  
  
• The List Manipulate statement has a new Normalize Field List function.
  
  
• The List Numeric statement can now return Minimum Length, Maximum Length, Index of Minimum Length and Index of Maximum Length.
  
  
• The Modify Application Settings statement can now modify the multi value delimiter.
  
  
• The Pad statement can now operate on lists.
  
  
• The Prompt statement's User Log mode has a new Per file setting. When enabled, one item is logged per file. The statement no longer trims leading whitespace characters.
  
  
• The Prompt for Fields statement can now optionally return an inverted field list.
  
  
• The Prompt from Container statement has a new key named disablePathIfStateOff. It hides a getPath icon if the same row's visible state checkbox is off.
  
  
• The Re-encode statement's Remove Accents functions now performs Unicode character folding.
  
  
• The Rename Files statement can now specify that a simplistic rename template should be auto generated to rename only a filename (with IfDup processing) based on the contents of a specified track variable.
  
  
• The Replace statement has a new mode which allows you to specify a replacement set which is applied to the effective source fields. Previously you had to use a Case statement which could apply a replacement set but it always uses the default set. This mode allows you to use any replacement set.
  
  
• The Run External Script statement can now optionally specify the script inline. This eliminates the need to write the script file to the file system.
  
  
• The Runtime State Stack statement can now push and pop the editing state values. You can now also compare the saved state at the top of the stack against the current, editing and initial states.
  
  
• There is a new action statement named Set Using Rename Template. The statement uses a rename template to populate variables or fields. Only the filename portion of the template is used. ie. Folder Start sections and IfDup tokens are ignored. The test for characters invalid in Mac filenames is not performed. All other configurable template settings are applied.
  
  
• The Substring statement can now formulate the alpha tag used by many as a folder name to make it easier to locate artist folders in the Finder.
  
  
• The Test if File Exists statement can now test paths across selected files in a track variable as opposed to the single file at a time.
  
  
• The Trim statement can now replace adjacent sequences with a specified sequence. Previously it only allows space or newline. The sequence is read from named variable Trim Replace Other Sequence.

      Escape Sequences

• There is a new escape sequence \as
• The sequence inserts the time in ms since 1970-01-01T00:00:00 that a running action or the batch processor was started.

      Release Specific Bookmarks

• A number of Search Yate Help bookmarks prefixed with v9.0 are automatically created when this release is installed.
• You can manually delete these bookmarks if you wish.
• The v9.0 prefix will be removed on the next release.

      Resource Documentation

• The Renaming and Restructuring Files and Folders document has been updated.
• The Yate and the P Word document has been updated.
• The Working with Apple Apps - The Basics document has been updated.

      Bug Fixes

• The Decompose Title into Classical Metadata statement's documentation omitted the cardinalNumber key.
• The Get Info statement was not being updated when a referenced rename template was renamed.
• The MusicBrainz Metadata for Release statement was not returning Single.
• The Prompt for Files statement's optional drag & drop panel was not working in the batch processor.
• The Prompt from Container statement's first time usage panel was not enabling link markup.
• The Replace statement's 'as list' control was not properly connected.
• The Test if File Exists statement was cancelling grouped execution depending on the statement's configuration.
• The Yate Database IDs statement was processing all files, even in grouped execution mode.
• Yate's execution modes have been described as batched and immediate or interactive. All documentation and UI now use Immediate.
• The Non Standard Delimiters field in Settings - Lists - Advanced Settings, was not always displayed properly. It may have had to be scrolled to refresh the display. This issue was OS dependent.
• The Create Move Action Wizard was not updating the Actions menu after creating an action.
• The function button menu for the AAC Kind, Video Definition and Content Advisory fields was incorrectly displaying the Enable/Disable only show Explicitly Supported Actions menu item.
• The Classification field was missing as a rename token.
• Making the Settings - Search token editor wider would mess up the display of the controls.
• Fixed various tooltip errors in the MusicBrainz and Discogs settings.
• Control-I in the rename template token editor did not display compound menus starting with I.
• When the only change to a field was its low level character encoding, a change would not be reported. This could only happen after re-encoding to UNFC or UNFD. When viewing changes, if the before and after representations appear identical, an encoding change has occurred.
• Clicking in a multi line edit field will no longer stop playing previews.
• If the runtime settings of an action was edited in the Action Manager and the action name contained contiguous spaces the runtime set was not correctly mapped.
• The Scanner action statement, when using track variables, was not properly retaining the save state to track variable control.