Yate Release Notes

Version 6.4.1 (10306.10269)

      The Beatport Importer

• The Beatport Importer was already stripping trailing qualifiers enclosed in parenthesis on the Title field when using it in a search. However, when scoring the Title against the search results, the full title was used. Both title variants will now be used and the highest score will be retained.
• Yate used to synthesize Beatport URLs to https://pro.beatport.com/. That domain no longer seems to work. URLs are now synthesized to https://beatport.com/. An action named Fix Beatport URLs is available on the resources page if you want to update the URLs in existing files without running the importer.
• The scoring algorithm will now use mix name and release metadata to further refine results when more than one has the best score.
• By popular demand there is a new option to append a mix name to the Title field when importing titles. The format is:
      title (mix name)
• The standard Edit Find functions have been mapped to the importer to make it easier to find files not marked for import. Edit>Find>Find (⌘F) will highlight all files which are not marked for import. Edit>Find>Find Next (⌘G) will highlight the next file which is not marked for import. Edit>Find>Find Previous (⇧⌘G) will highlight the previous file which is not marked for import.

      yate-cli Command Line Application

• Certain versions of the OS cannot launch Yate when yate-cli is run from within the application's bundle. There is a new Yate>Setup menu item to extract yate-cli so that it can be easily accessed.
• The functionality has been expanded to open audio files.
• Do a Yate>Search Yate Help and search for yate-cli for more information.

      Bug Fixes

• There was a timing issue where Prompt category statements could open a panel without any buttons. This would require a Force Quit.
• Move/Copy statements which used a rename template which added path components and did duplicate handling, duplicated the added path components if a file was a duplicate.
• Sort controls on the the Movement column were not working.

Version 6.4 (10287.10269)

      Beatport Importer Options

• When specifying Automatically select matches there is an Exact option.
• You can now Aggressively search for an exact match.
• You can now hide matches which do not meet the specified criteria. This is great for hiding a long list of rejected matches.
• You can now specify thresholds to be used when matching titles, artists and optionally releases (albums). Items which do not meet the threshold are not considered. More information is available in the online help.
• These changes will help eliminate the automatic choosing of matches which are incorrect.

      Lyrics

• APISEEDS is no longer accepting registrations for API keys and is migrating to a new service at happi.dev.
• As of this release we will continue to support APISEEDS and also support happi.dev. The usage and credit patterns are similar.
• There are a few differences in behaviour and they are documented in the online help.
• Every command and statement which contained APISEEDS is now named Get Lyrics.
• The auto generated UDTIs which were prefixed with APISEEDS will now be prefixed with Get Lyrics. Old UDTIs will be removed and replaced with the new when a lyrics search is performed. In order to maintain your retry dates, the APISEEDS Status UDTI will be used if Get Lyrics Status is not present.
• At some point down the road when APISEEDS shuts down we will remove support.
• In order to ease the transition for those of you who have purchased credits, we've purchased a large block of credits which can be accessed by using an API key of free. This is a shared resource and will be used up over time.

      Earliest Recording Date from MusicBrainz

• Functionality has been introduced to search MusicBrainz on a per track basis to determine a track's earliest release date.
• There is a new action statement named MusicBrainz Earliest Recording which supports what gets matched, how many network accesses occur and what gets imported.
• The Actions menu has a new Earliest Recording Date from MusicBrainz item. This is a convenience method as the functionality is provided by importing an action which is executed. The functionality is configured by modifying the imported action.
• Some tracks have numerous recordings and may require many rate limited network accesses. If you're feeling lucky you can limit the process to one network access per track.
• Progress is displayed on the main window's status bar. If you see that more pages (network accesses) are required than you wish to wait for, you can do a File>Cancel or hit the toolbar Cancel button. You will be given the opportunity to skip the file or cancel. When a search is cancelled, partial results will be retained.

      The Artwork Viewer

• You can now open image files via File>Open.
• You can now open image files via the Finder's Open With functionality.
• You can now open an image file from a command line via the following command:
        /Applications/Yate.app/Contents/MacOS/yate-cli -av file

      Custom Panels

• Custom panels can now be imported via Yate>Import Preferences and by dragging an appropriate file to the main window's file list area.
• The Custom Panel Editor's Delete All button has been renamed to Clear. It now also erases the name and tooltip fields.

      Discogs and MusicBrainz Wizards

• There is now a new context menu item named Select Same Album or Folder on the mapping panel's context menu.

      Rename Replacements

• A replacement item which has a from pattern of \. will replace all trailing periods in the effective string with the possibly empty to pattern. This is primarily for users copying files to Window's based PCs.

      Multi Field Editor Editor

• The Trim function has a new Remove Invalid setting. It is equivalent to the Remove Invalid Characters statement and does a context sensitive removal of invalid characters on a per field basis.

      Filter Editor

• When saving a filter you can now show a menu containing the names of existing filters.

      Audio Information Panel

• You can display a popup version of the Audio Information panel by right clicking on a file in the main window and selecting Audio Information from the context menu. It doesn't matter how many files are selected, only information for the clicked file is displayed.
• When only one file is selected you can do a View>Audio Information for the same functionality.

      Creating Apple App Playlists

• When creating an Apple App playlist from loaded files or within a Track database, there is now a disclosure button which will display the names of the existing playlists.
• The choice of which application's playlists to display is determined automatically. In the unlikely event that you are creating playlists in Music and TV at the same time, you will be asked to choose which list to display.

      Sort Form Improvements

• The Last Name, First Name functionality used by the Sort Form action statement and the same named function in the Multi Field Editor was very simplistic. It basically looked for the last space in a field and flipped the contents.
• Two new replacement set types have been introduced which are now used by the functionality.
  • The Sort Form Ignore Suffix set contains a list of sequences which can follow a last name. These include Band, Orchestra, etc. The sequences when found will not be considered the last name and will be isolated. For example: Ben Webster Band --> Webster, Ben (Band). There is also the ability to mark a suffix as being additive. This enables: The Gary Clark Jr. Band --> Clark, Gary (Jr. Band, The)
  • The Sort Form Name Prefix set contains a list of sequences which can be considered to be part of the last name. For example: Al Di Meola --> Di Meola, Al
• The new out of the box copies of the sets will automatically be imported and can be found in Preferences-Replacements.

      Action Editor Windows

• The Action Description context menu item displays an action's description in a popup window. Previously hitting the space bar would have the same effect.
• Hitting the space bar will now have the same effect unless the following holds: If a single statement is selected and it is a Comment, Force Grouped, Start, Tooltip or Version statement and has a non empty description, the description will be displayed in the popup window.

      Action Statements

• Prompt Statements
  • The Prompt for File or Folder statement now supports the common prompt statement functionality. This means that depending on the OS version and the New File option, a title can be specified. A check box can also be displayed.
  • The Ask, Prompt, Prompt for Fields and Prompt for Text statements now support up to four buttons which can be configured in a variety of ways.
  • The Prompt for Fields statement now selects Hide Info when a new statement is created.
  • The Alert and Critical Alert modes of the Ask and Prompt statements now support the same functionality as the Standard display mode.
• The Enumerate Fields and Extensions statement can now enumerate the following classes of fields: credits, dates, numeric and URLs.
• The Copy Files, Create Symbolic Links, Export Metadata, Import Metadata, Import Metadata from Audio File and Move statements now allow you to specify transformations to be applied much as you can in Rename templates.
• Support for the long deprecated LyricWiki Access statement has been removed.
• The Preferences statement no longer has a dedicated section to change the Action Pending Window's text colour. This is now done via a single preference change item named Action Pending Window Text Colour.
• The Scanner statement
  • The statement can now scan for Roman numerals and optionally convert them to integers.
  • The statement can now save per file results to track variables.
• The Replace statement now supports regular expressions. While it has less functionality than the Regular Expression statement, it supports multiple fields at a time.
• New action statement named MusicBrainz Earliest Recording discussed above.
• The Preferences and Extract Preference Set statements have been modified to acomodate the two new preference set types used by the Sort Form functionality.
• The Compare Fields Across Files and Compare Fields statements have been merged under the Compare Fields name. All existing statements have been adjusted. Please read the documentation as there are some changes when new statements are created.
• The Add to List statement now supports diacritic insensitivity.
• The List Manipulate statement has two new functions: Combine and Combine Counted. They both merge contiguous like elements.
• The List Contains Test statment now has a Per file values setting which causes the test data and list delimiter to be evaluated for each file when testing for containment in lists in fields.

      Other Action Related Changes

• The Pending Action Window now resizes to its content.
• New escape sequence \?xd imports the Non Standard Delimiters defined on the Preferences-Lists-Advanced List Settings panel. List items are delimited by a newline character (\n). Useful to be used with the new MusicBrainz Earliest Recording which has a delimiters field.
• New escape sequence \?nv imports a list of all non empty named variables. List items are delimited by the default list delimiter (\~).

      Bug Fixes

• The Stop Action and Filter Files statement possibly displayed an unsorted list of filters.
• When an action was exported the Preferences statement was not automatically including referenced Replacement and Exception sets.
• If Regular Expression was chosen as a String operator in a filter, the escape menus did not revert if a non regular expression operator was chosen.
• Tracks added to the Staging Playlist were not always added to the end of the list.
• Fixed a potential issue with the Move statement's preview functionality.
• The Exists statement was not immediately updating a change of a per file variable.
• The Discogs and MusicBrainz wizards were adding unselected files by matching album AND folder as opposed to matching album OR folder.