Yate Release Notes

Version 10.0.2 (13082.13005)

      Image Manipulation

• All full artwork panels and the Artwork Viewer can now rotate images, flip images and set them to greyscale.

      Action Statement Changes

• The Manipulate Artwork statement's Pad - Round setting has been renamed to Advanced. The setting supports rotating and flipping images.
• Note that the UI only supports rotating of 90°, 180° and 270°. This statement supports 1-359°

      Search Yate Help

• The panel has been rearranged such that the web based documentation is no longer listed in the left bookmarks panel. The web documentation is available by a dedicated icon.
• Resource documentation for all installed resource actions can now be accessed from a displayed menu.
• There is a new bookmark icon which is equivalent to the context menu item.
• All help topics available on the Help menu can now be accessed via the quick help icon.

      Bug Fixes

• The Manipulate Artwork statement was ignoring the w&h setting. Scaling was always w|h.
• The Build Component List statement was not working for Reversed mode when the source was not in a named variable.
• Whenever Yate was started in Playlist Mode, the Open Mode toolbar buttons would be messed up.
• If an edit panel layout had empty buttons followed by non empty buttons, the layout would not be created properly and could result in empty panels.

Version 10.0.1.2 (13065.13005)

      Bug Fix

• Tracks dragged in from Music were not always linked.

Version 10.0.1.1 (13063.13005)

      Bug Fixes

• The new rename template token, ❨Not❩, was being set incorrectly in some cases. This may have affected the new resource action named Generate an NFO File via Rename Templates. The action is fine and need not be modified.

Version 10.0.1 (13062.13005)

      The Action Updater/Installer

• The Action Updater/Installer is used to install actions and various other specific content such as bookmarks, rename templates, Multi Field Editor actions and actions required for some menu driven functionality.
• In the past the displayed panel always listed actions with updates. Some people found this confusing.
• The panel now only displays content based on however the process was invoked.

      Status Bars

• The Movie DB and Snapshot Editor status bars now honour the Settings - File List - Abbreviate file and folder paths setting.

      Bug Fixes

• When displaying text with icons on the toolbar, the text was not enabled/disabled correctly.
• The edit panel bar was not displayed correctly on macOS 10.14.x when in dark mode.
• Under certain conditions the File to Tag, Rename Template and Search Template items were not always properly sorted when displayed on a menu.
• The Copy Metadata Configuration panel had a label which was not anchored correctly.

Version 10.0 (13053.13005)

      UI Changes

• You will notice lots of appearance changes ... especially on Golden Gate or Tahoe.
• Access to Yate custom controls is now provided by borderless icons.
• Mac OS Tahoe introduced a revamped UI for the OS. One complaint is that contrast has suffered. On Tahoe and later, you can control the contrast which is provided. On earlier versions of the OS, the settings are ignored. The settings are found on the Window menu on a Contrast Adjustment submenu. The settings are:
  
  

  None

  No contrast is provided. All backgrounds are directly provided by the OS.
  
  

  Light

  A light contrast is supplied. This is Yate's default value.
  
  

  Darker

  A slightly darker contrast is supplied.
  
  

  Next

  Cyclically toggles to the next contrast value.

  
  These items can be assigned keyboard shortcuts. It is recommended that you provide a shortcut for the Next item as it makes it far easier to change the contrast on a whim.

      The Main Window Toolbar

• The old classic Yate icon set has been removed.
• While large toolbar icons are still supported on older OS versions, small size really looks better.
• The Settings - File List Toolbar icons control has been removed.
• Settings - File List has a new item named Toolbar icon appearance. This setting allows you to selectively enable or disable the following items:
  
  

  Show Menu Indicators

  When enabled, toolbar icons which display a menu will display a trailing ⌄ indicator.
  
  

  Show a Border

  When enabled, a border may be displayed on a toolbar icon. Note that this looks different on almost every OS version and on some versions may only display when hovering over the icon. As well, the setting may change the size and spacing of the icons. Note this setting is ignored on versions of Mac OS prior to 11.0 (Big Sur).
  
  

  Provide Extra Padding

  By default toolbar icons are displayed with as little separating space as is necessary. When this setting is enabled, extra padding is provided.
  
  

• When a window title bar is displayed, the icons will appear beneath the title bar ... on all but the oldest supported OS versions. On Tahoe and Golden Gate, the window's title is moved to the left of the window. Having two rows may be a waste of space. There is a new toolbar item named Yate. If you insert the icon to the left of the toolbar and do not display a title bar, the effect will be about the same without wasting the vertical space.
• Different toolbar configurations can be saved via Window>Toolbar Layouts.

      Edit Panel Buttons

• In the past, Yate only supported two rows of five buttons. You can now have one or two rows. Rows can be configured to have two through ten buttons. The same amount is applied for each row.
• When dragging a button to change its location, you must now hold down the Shift key.
• When creating a saved layout, the selected button and the row/column configuration is saved as well as the button assignments. All layouts created on prior versions will work.
• The Saved Preset Button Layouts submenu on an edit panel button's context menu has been renamed to Panel Layouts.
• The Panel Layouts>Button Configuration item will display a submenu which allows you to select a button configuration. ie. the number of rows and columns.
• The Panel Layouts menu has an additional item named Initial Button Layout. The item restores the out of the box button layout.

      UI Layouts

• Previous versions allowed you to save column layouts and edit panel layouts.
• Edit panel bar layouts now retain the number and layout of the buttons.
• Toolbar layouts retain the content of the toolbar and its display mode. Icons only, Icons & Text, or Text Only. On older OS versions they also retain the icons size.
• This release also allows the saving of UI layouts. A single UI layout can modify the following:
  • A main window column layout.
  • An edit panel bar layout.
  • A toolbar layout.
  • The File Browser visibility.
  • The visibility of the File Browser information area.
  • The content displayed in the File Browser information area. Audio information or artwork.
  • The layout of the three primary main window panels.
  • Whether the edit panels are attached or detached.
  • The optional display of a main window title bar.
  • The visibility of the main window toolbar.
• The column layouts and edit panel button layouts are available where they always were.
• The toolbar and UI layouts are accesible on the Window menu.
• A new toolbar item named UI Layouts Menu is available which provides quick access to the four supported Manage Saved Layouts panels.
• All of the Manage Saved Layouts panels now support the application of a saved item from within the panel.

      Keyboard Shortcuts

• You must now inline edit a field associated with a menu item in Settings - Shortcuts. Previously you only had to be displaying the panel.

      Maximum Grouping-Work Name compatibility

• Previously the settings was a simple on or off.
• Some audio players have now adopted Apple's encoding for all ID3 based files. Previously Yate only implemented it for MP3 and AIFF as those were the file types which could get loaded into the Music application. WAV was always handled differently.
• The previous on setting is now named On for MP3 and AIFF (smart). This provides the previous functionality. smart refers to Yate's ability to detect the encoding type.
• You can now also select On for All ID3 (smart). This provides the functionality for MP3, AIFF, DFF, DSF and WAV files.
• A fourth setting is provided named Always on for ID3. Note that this is not a smart setting. Its only usage is if you want to tag files which were previously tagged by an application which always uses the Apple encoding. ie. it is not smart about it. The only time this might be required is if your files contain Work Name fields and no Grouping fields. In almost all cases, All ID3 (smart) is safer.
• As this setting is not only for Apple Apps anymore it is duplicated on Settings - Audio - ID3 panel.

      Rename Templates

• IfExpression sequences can now reference UDTIs and UDURLs. Context menu items are available to insert common names.
• Added new UDTI token which can be used to insert the contents of a UDTI. The User Defined Names token menu submenu can insert common names.
• Added new UDURL token which can be used to insert the contents of a UDURL. The User Defined Names token menu submenu can insert common names.
• IfExists and IfExists+ can test UDTIs and UDURLs.
• Property token File Type has been automatically renamed to File Extension.
• Added new property tokens Channel Count and Channel Mode.
• Added Media Type as a token.
• Added File Type as a token.
• Added new Property tokens: {Total} Size (bytes), {Total} Size (units), {Total} Time (ms), {Total} Time (hh:mm:ss). units is a number of B, KB, MB or GB. The Total variants accumulate the result over all active files. When not running in an action this is all selected files. When running in an action this is the set of currently active files.
• Added new Mark token. These tokens are stacked and serve as a reference point to a location in the produced text. Any token which references a Mark token removes it from the stack.
• Added new Pop Mark token. The token removes the last Mark token, if any, from the stack.
• Added new Rollback to Mark token to remove all text following the last Mark token.
• Added new . token which is equivalent to Break. The . token always appears by itself on a row when a template is formatted. This enables the token to introduce retained spacing in a template.
• The Set Using Rename Template statement can be used to generate any text without restrictions via a rename template. Tokens have been added which make sense with this statement but perhaps not with the use of a rename template for renaming files. The added tokens are:
  
  

  Fill Pattern

  The token is followed by text to be used by tokens which fill. The default pattern is a single space.

  Justify Center

  The token is followed by a number specifying the desired length of text. All text from the preceding Mark token is centered by filling the space with the Fill Pattern. The used Mark token is removed from future consideration. ie. it is removed from the stack.

  Justify Left

  Same as Justify Center, except that the text is left justified.

  Justify Right

  Same as Justify Center, except that the text is right justified.

  NL

  The token inserts a newline character.
  
  

• If Length and Truncate tokens now use a Mark token, if any. If there is no Mark token, they operate on the entire text representation as before.
• There is a new if - else -endif token named IfConsistent. The token tests if the specified item is identical in all active files. It can test fields, variables, properties, UDTIs and UDURLs.
• There is a new if - else -endif token named IfConsistentEmpty. The token tests if the specified item is empty in all active files. It can test fields, variables, UDTIs and UDURLs.
• There is a new if - else -endif token named IfConsistentNotEmpty. The token tests if the specified item is identical but not empty in all active files. It can test fields, variables, UDTIs and UDURLs.
• There is a new if - else -endif token named IfMarkNotEmpty. The token tests is any text has been inserted since the last active Mark token.
• Added a new Not token which when processed before an if token will negate the result.
• Added new break token varients. Break\ will displayed followed by a new line when a template is formatted. ❨.❩ will display preceded and followed by empty lines in a formatted template. Both of these tokens do nothing except provide visual spacing in the template token editor. As with the Break token, they only possible effect they have is to terminate a text sequence.

      File to Tag Templates

• Added Media Type as a token.
• Added File Type as a token.

      File to Tag, Rename & Search Templates

• These templates have a Hidden column. Previously this was an on or off value. The value is now a tri-state.
• The additional value is only to provide additional granularity while filtering the display. ✓ and - are both treated as hidden. ie. they will not appear on UI based menus.
• The panel's filter button now provides for all filtering possibilities.
• One possible use is to differentiate templates designed for use with the Set Using Rename Template statement from those which are simply hidden.

      The Token Editor

• The Token Editor can now display a find bar.

      Special Named Variables

• Named variable File Provided is available as a convenience. It will be true if at least one of File Auto Selected or Temporary File Supplied is true.

      Settings Import / Export

• Bookmarks is now a separate import/export item. This was done so that bookmarks can be distributed and subsequently imported when a plist file is dragged to the main window.
• Toolbar Layouts and UI layouts are available items.

      The Content Advisory Field

• This field was historically only available in MPEG-4 files where the encoded item is supported by iTunes/Music.
• Some users have expressed a desire to be able to save the rating in other audio file types for their own benefit. This has been enabled.

      FLAC Mappings

• New installs will have UNSYNCEDLYRICS as a read only alias to the default Lyrics mapping of LYRICS.
• New installs will have ITUNESADVISORY mapped to Content Advisory.
• If you want to add these items to your mappings you can do it manually or do a Yate>Import Built in Items>Import FLAC/OGG Mappings.

      APE Mappings

• New installs will have ITUNESADVISORY mapped to Content Advisory.
• If you want to add this item to your mappings you can do it manually or do a Yate>Import Built in Items>Import FLAC/OGG Mappings.

      Audio - MPEG-4 Settings

• The Conductor field has an additional alternate mapping of the low level ©con atom.

      By Popular Demand

• The Original Release Time field has been renamed to Original Release Date. Symbolic references to Original Release Time will still work as expected.
• The Release Time field has been renamed to Release Date. Symbolic references to Release Time will still work as expected.

      Discogs

• The Discogs master release will contain the earliest release date of any release associated with it. This is not provided as a standard metadata import item as extracting the metadata involves an extra network access each time an import occurs. You can configure Auto load master to extract original release date. The choices are:

  
  No

  The data is not fetched.
  
  

  Always

  An attempt will be made to fetch the metadata which will be stored to the Original Release Date field.
  
  

  If empty

  If the Original Release Date field is empty, the metadata will be fetched.
  
  

• A resource action named Extract Original Release Date from Discogs Master is provided which can be run at any time over any number of files. It performs the same extract.
• The wizard can now import series metadata. It is stored to a UDTI named Discogs Series.
• The Discogs - Setting option to display or not display a Catalog Number column in the search results has been removed. The column is always displayed.

      MusicBrainz

• The search results panel now displays a Catalog Number column.

      Discogs & MusicBrainz

• The Search panel in both wizards now allows you to select ID, Barcode or Catalog number for what was the id field.
• The presence of a u in the field no longer forces a barcode lookup as there is now a control to specify Barcode. The field's disclosure menu list has been modified to reflect the new encodings in the list.
• Catalog number differs from ID and Barcode in that the Album and Artist fields are used if specified. Note that their usage is optional.
• Both wizards can now import UDTIs named Display Album Artist and Display Artist. These items always describe the fields as specified in the downloaded metadata, regardless as to how you are delimiting artist names.

      MPEG-4 Chapters

• Certain MPEG-4 files which contained chapters did not have their chapters read if tracks in the file were not properly identified. ie. the files are not following the correct encoding.
• There is now a work around for this issue and the chapters will be identified.

      Configuring User Supplied Action Icons

• The settings panel and the panel displayed in the Action Manager have been completely redesigned.
• Icons can be supplied in light and dark renditions.
• If no dark mode icon is supplied and there is a supplied light mode icon, it will be used. You can overide this behaviour to force the display of the default icon.

      Search Yate Help

• Many bookmarks have been created pertaining to this release.

      The Action Manager

• When viewing the output of Display Usage Information in the Container Viewer, double clicking on an action name will open the action in an editor window.

      Per File Test State

• if - else - endif sequences supported the ability to constrain which files are active based on a track variable. Even though the statement evaluated the track variable at its start, some people felt that changing the variable would affect the file selection ... which was not the case.
• if - else - endif can now test a per file test state which is evaluated when the sequence starts. There is one and only one per file test state per file.
• All statements which had the ability, such as most compare statements, can now set the per file test state.
• Note that testing track variables still has its uses. However, the per file test state method may be easier to understand and does not waste a track variable.

      Action Statement Changes

• The Format Numeric statement has a new mode named Formatted Display>File Size. An integer value will be formatted as a number of bytes (B), kilobytes (KB), megabytes (MB), or gigabytes (GB). At most two decimal places will be displayed.
• New escape sequence \?a1. Insert the value of the Per File Test State as 0 for false and 1 for true.
• New escape sequence \?a0. Insert the value of the Per File Test State as empty for false and 1 for true.
• The Set Action Test State statement has been renamed to Set Test State. It can now test the per file test state as well as the singleton action test state.
• The Get Info statement's List of File to Tag Templates, List of Rename Templates and List of Search Templates functions can now filter on the new hidden settings.
• The Manipulate Artwork statement can now add padding (a border) and optionally round the initial image and/or the padding.
• The following statements now support the per file test state: Build List, Clean Multiple Item Fields, Compare Container, Compare Date, Compare Numeric, Compare Text, Compare Fields, Debug, if, Logical Set, Run, Scanner, Set Test State, Test if File Exists, Test File Type, Test if List Contains Item.
• The Search Discogs and Search MusicBrainz statements now support searching by catalog number.
• The Discogs Metadata for Release and MusicBrainz Metadata for Release statements now import Display artist and Display Album artist.
• The Discogs Metadata for Release statement now imports Series.

      Resources

• The Configuring Yate's Appearance document has been updated.
• The Renaming and Restructuring Files and Folders document has been updated. The associated companion download has been updated as well.
• The Yate and the P Word document has been updated. The associated companion download has been updated as well.
• There's a new sample action named Generate an NFO File via Rename Templates. It generates NFO files based on rename templates.
• Other resource actions have been updated as well.

      Bug Fixes

• Renaming a saved edit panel layout did not refresh its name in the appropriate menu.
• Variables were not parsed correctly in Rename template IfExpression sequences.
• \?pm was not marked as deprecated in the Escape Sequences document.
• The Compare Container statement was not registering track variable usage.
• The Prompt for File or Folder statement was allowing you to specify file types when only prompting for folders.
• The Create Track / Album Database and Test if File Exists statements were not registering named variable usage in the export template field.
• The Logical Set statement had some UI issues.
• The Discogs Wizard Release Details panel displayed a Split Item into Separate Tracks function if a / was present in a title. space/space is required. The function was displayed but did not do anything as is correct.
• The Token Editor displays abbreviated menus when Control-letter is pressed. Previous versions did not capture all letters.
• Filter settings in Settings - File to Tag, Rename and Search, were not reinitialized if the settings were reset or synced with another Mac.
• The Manipulate Artwork statement was displaying a formatted item for the scale factor as opposed to displaying the number entered.