Yate Version 1 Release Notes

Version 1.4.1.1 (767)

• Fixed another primary chunk overflow issue in AIFF files. All such errors are now ignored and the correct size is calculated on the fly.

Version 1.4.1 (765)

• Added a Bit Rate action function to test for tracks which have a bit rate less than a specified value.
• You can now issue more than one search url at at time in actions. Simply put more than one Search for Artwork function in an action with the same size test. Set the new Continue option on all but the last.
• Show in iTunes - Track renamed to Show in iTunes - Library to better reflect the different iTunes view modes.
• Show in iTunes - Album renamed to Show in iTunes - Playlist to better reflect what it does.
• Now get around an issue where certain AIFF files reported primary chunk overflow.
• Fixed some issues with how UI controls are locked down when they shouldn't be available.
• Fixed an issue where an action could not be renamed to the same name with different alphabetic case.

Version 1.4 (748)

      New Features / Additions

• The checkbox to the left of the Rating field now shows a - for more than one value. To set no stars for all selected files, click in the rating field and drag all the way to the left. You'll notice that the checkbox will have a check mark implying changed.
• The exception sets used as the Names List and Title Case List can now be assigned via the context menu in Preferences-Exception Sets. Note that the default exception set, the Names list and the Title Case list must all be different sets.
• The Preferences action function now allows setting the Names list and the Title Case list.
• Now have a default FLAC mapping for the Skip When Shuffling field.
• Added a File>Open Recent menu item. The last ten folders, m3u and m3u8 files will be retained. Items can be made sticky by holding down the Shift key and clicking on an item. Ten sticky items will be retained. You can clear all the non sticky items by selecting Clear Menu. You can clear all items, sticky and non sticky by holding doen the Shift key and selecting Clear Entire Menu.
• Added a Hidden column to the Action Manager. When an action is hidden, it will not appear in the User Defined action menu or the Batch Processor action menu.
• When exporting selected preference items or actions, you can now choose to merge the exported content into an existing file. Note that the exported content replaces all previous content of the same type. For example, exporting actions with the merge option will preserve the previous contents of the file with one exception. The exported actions will completely replace any actions previously in the file.
• The Link to iTunes action function has a new option. When Link if Modified is selected all selected files which are not currently linked and which have been modified, will be linked to iTunes. This is useful when running an action in the Batch Processor and you want to avoid linking unless necessary. Note that if you are going to modify the Artist, Album or Title fields you should always link before changes are made. If you are going to modify any of those fields use the Link option prior to making any changes as opposed Link if Modified.
• Warnings have been added for deleting just about anything.
• The Verify Same action function has been expanded. There are now three modes of verification.
  • When verifying by Files, each individual field must have the same value in every file. This is useful to check that every track in an album has the same value for Year.
  • When verifying by Fields, every field in a given file must have the same value. This is useful to check that the Artist and Album Artist fields in each file have the same value.
  • When Both is specified you are testing that all the specified fields in all the selected files have the same value. This is useful to check that the Artist and Album Artist fields across all files have the same value.

  The previous incarnation was effectively Files but was documented as if Fields.

      iTunes 11

• You can no longer set the gapless state of a track in iTunes 11 without getting an error. Part of a gapless album has been removed from the iTunes UI. The default for the Preferences-General-File List-iTunes Linked Fields ➡ (gapless) option has been changed to Off. For now, error messages are not displayed for a failure on setting the gapless value in iTunes. If you export a changed gapless value you will not get an error but it will not work. We will more than likely remove the ability to import and export the gapless state in a subsequent release.
• Adding tracks to iTunes seems to take much longer, especially when adding an entirely new artist. This seems to be true when adding from the Finder as well as adding from Yate. When adding from the Finder, iTunes returns control to the user before actually completing the add. The album may be displayed but the metadata may not yet be available. In Yate's case we regain control when the add is completely done. Hopefully, this will be speeded up in a future iTunes update.

      Bug Fixes

• The Next button was not displaying in the Batch Processor Wizard. The bug was introduced in v1.2.2.
  
• The Import and Export to iTunes action functions, did not work if the Use Defaults option was selected.
• Resetting the FLAC mappings was not updating the display.
• The Find and Remove action function was displaying incorrect values for the Ignore Case and From End options. The action function was correctly formed and does not have to be modified.
• The Get Artwork from iTunes menu function was not updating the display until the file selection changed.

      The iTunes Album Rating

• iTunes allows you to set an Album Rating. When you manually set an Album Rating, all tracks which do not have an explicit rating will be displayed with an equivalent number of ☆'s for its rating value.
  
  When an album has an iTunes Album Rating and you set a track's rating to no stars, then export it to iTunes, the operation will effectively fail. This is due to the fact that iTunes will display its default value for the album. You will notice that Yate still displays ratings differ even though you have just exported the new rating. In order to solve this problem you have to reset the iTunes Album Rating to no stars.
  
  We now identify those albums which have had an Album Rating set via a ☆ in the iTunes column of a track's display. Preferences-General now allows you to control the display of the ☆ indicator. It also supports the setting of an Auto clear ☆ option. When set, the iTunes Album Rating will be cleared whenever data is exported to iTunes. You can also clear the Album Rating via the Export to iTunes action function and by the Compare iTunes Values panel.

      Flow Control in Actions

• The User Defined Fields function has been modified so that if the field cannot be matched and the function is an Export function, the User Defined Work field will be cleared.
• The Exists and Search for artwork functions have a new Test option used to specify that a test status should be set as opposed to the normal Pending Window or Batch Processing logging handling. Search for artwork sets the test state to true when a search notification would normally be issued, otherwise it sets the state to false. Exists sets the test state to true whenever its criteria is met, otherwise it sets the state to false. Note that the Test option is only performed once per set of files.
• The new Test function is used to implement flow control within actions. Yate maintains a test state for the currently running action. The state is initialized to false when an action is started. When a second action is run by another action the previous state is restored when the second action terminates. Currently the Exists and Search for artwork action functions can modify the test state.
  
  The Test function allows you to test if the state is true or false, to optionally run an action and then to continue, exit or stop. Exit stops execution of the current action. Stop cancels execution of all running actions and returns control to the user.
  
  To run an action you must set the Run action option and choose an action to run from the drop down list.
  
  Note that a Test function is run once per set of files and not individually for each file.

Version 1.3 (708)

• Yate will now tag AIFF files (.aiff, .aif, .aifc)
• The Open Modes can now be separated into two global states: Album Mode and Playlist Mode. Album Mode is what existed prior to this release. When in Playlist Mode, opening a track will not automatically open all other audio files in the same folder. In Playlist mode the other mode options are always Add and Do Not Process Subfolders. Note that while running a batch process, you are effectively in Album Mode.
• There is now a status bar available for the file list. The status bar displays the number of tracks and duration of the tracks. If more than one track is selected (ala iTunes), the displayed information refers to the selection. The status bar is toggled on or off via the Window>Hide/Show Status Bar item. The state is maintained separately for the Album and Playlist open modes. The status bar will also provide feedback when a large number of files are being loaded.
• There is a new Action menu item and associated action function called Create m3u files. When in Album Mode one m3u file will be created for each folder represented in the current file selection. When in Playlist Mode you will be prompted for the name and location of a file to be created. Every open track will be written to the file regardless of the current selection. If all of the filenames can be represented in Latin1, an m3u file will be created. If this is not the case, an m3u8 file will be created with UTF8 encoding. Yate will place relative file paths into the produced files as long as all the files are descendants of the folder where the file is placed. If this is not the case, absolute paths will be written.
• When in Playlist Mode, m3u and m3u8 files can be opened or dragged into the file list.
• Preferences-General no longer has the performance/responsiveness sliders. They were originally intended for the initial beta period and have now been set to the most appropriate values.
• The Done button used in the advanced editor panels and the action editor can now have a shortcut applied. This can be set in Preferences-Shortcuts. There is a new section item called Key Bindings which contains the Done item.
• Added an option to Preferences-General so you can choose the Picture Type for artwork dragged into Yate. You can choose a default value of Cover (front) or Other.
• Added an option to display track numbers padded to two digits in the file list display and the associated edit fields. The option is found in Preferences-General-Pad track display. Note that this is a display-only option and does not affect how the information is stored in the tag.
• Rename templates can now specify Genre.
• File to tag processing has been expanded. All tag fields found in Rename templates can be specified. There is now also an Ignore token used to skip data. There is also a new Folder Start token used to specify the extraction of information from a file's folder name.

A note about online help: Apple strongly caches the help files associated with applications. As the help for Yate is updated fairly regularly, it is possible that you will download a new build and have older help displayed. Unfortunately, there is no current method to work around this issue from within Yate. Typically the issue only arises when additional help anchors are implemented. Our forum section Yate-Issues contains a sticky item describing how to flush and automatically rebuild the help cache.

Version 1.2.2.2 (681)

• Fixed a few cases where audio information would be blank.
• Fixed a potential crash caused by repeated sorts and saves.
• Fixed user action shortcuts being lost when actions were added.

Version 1.2.2.1 (673)

• Fixed a bug related to sorting files and offscreen content.

Version 1.2.2 (665)

• Set description to URL on dragged artwork option, added to General Preferences. The previous behaviour was always enabled.
• We were using the rating content field in m4a files to optionally save the rating. While this doesn't seem to cause an issue with iTunes we've decided to move to the same method used for other non standard m4a items. The Preferences-Audio-Write ratings from content rating field option has been changed to Read ratings from content rating field. This will ensure that any previously written ratings will be read correctly. If you had write enabled, read will be enabled. If the files get rewritten the newer method is always used. Having the option enabled at that point will do no harm.
• Added options to specify an auto-run action for Discogs and MusicBrainz. If specified, the action is run after an import from the online database.
• Added options to the Save action function. Yate only removes ID3V1 tags and optionally strips free space when a file is written. The new options allow you to force a write, even if a file is not modified, on either of these conditions. Note that the Remove free space option does not have to be set as only the Padding value is used. A third option is to save the file always. This will force a rewrite of the file correcting any irregularities in the file and will ensure that mp3 files contain ID3v2.4 specification tags.
• The Batch Processor now retains the last action run.
• When exporting a single item, the filename will be preset to the name of the item.
• We removed the Prefs-Audio-Strict Validation option. The general opinion is that it is impossible to run when the option is checked. There are far too many break the spec cases being caught.
• Both the Discogs and MusicBrainz wizards can now import catalog numbers.
• Bug fix: The Append action function was not properly handling the optional append field.
• Bug fix: Another edge case was found for detecting malformed frames in mp3 files.

Version 1.2.1 (655)

• Replace action function now supports anchoring the search to the start or end of a field.
• Fixed an issue with Unicode in ID3 V2.2 files.
• Cosmetic display changes made to the dragging of files in and to the main list of files.
• Fixed a bug where off screen content was not being displayed properly when scrolled onto the display.

Version 1.2 (650)

Another big release containing a major new feature. Batch Processing! You can now edit all of your audio files with a single Action. This release has quite a long list. Remember that you can always view the release notes via Help>View Release Notes.

      New Features and Modifications

• Use the Actions menu item Batch Processor Wizard... to step you through the process of batch editing your tags. Basically you select an action and a root folder. The action is successively run on the specified folder and all contained subfolders. A log file is produced which contains all of the information which normally would have been displayed in error messages or an action pending window. Pretty much everything can be done in a batch process except searching for artwork and showing files in iTunes. Missing artwork and artwork not satisfying a specified minimum requirement are reported even though search URLs are not issued.
• Added a File menu item to open files/folders specified in a path in the system clipboard. This is essentially to make it easier to work with the log created by the Batch Processor. Folders are identified in the log as Folder: /path. If you copy the /path specification to the clipboard, you can use the new File>Open Path in Clipboard item to open the files contained in the folder.
• The Exists and Search for Artwork action steps have a new checkbox labelled Once. This option is only used by the Batch Processor wizard. When checked, only one item per folder will be output for these steps. This is to minimize output to the log file.
• The MusicBrainz wizard will now utilize Discogs data, if available. This includes the genre, mood and artwork. This feature is enabled by a new Preferences-General option Use Discogs data when available.
• A Close All Files menu and context menu item have been added. The Close Files menu item has been renamed to Close Selected Files.
• Tag sets can now be saved wherever used. Via the context menu or disclosure button there is a Save Current Set... menu item. Clicking on this will open the Preference window to the Tag Set display with the displayed tag set representing the set you were working on.
• The Export to iTunes and Import from iTunes action functions now allow you to override the default values set in Preferences-General.
• Search templates can now specify to place the metadata into the system clipboard as opposed to inserting it into the constructed URL. This enables you to access sites which require you to enter the search criteria on their site. When the site opens simply paste the metadata into the search field.
• Yate now tracks external file changes. The app always tracked external modifications to a file but now it will track file moves and deletions as well. A file's location is updated whenever it is redisplayed, or when a Save, Rename, Close or Quit occurs.
• The Cover (front) to first artwork position Action function has been renamed to Rearrange Artwork. You can now select to reorder based on Cover (front) to first or Largest first. Cover (front) to first moves the first artwork item with a Picture Type of Cover (front) to the head of the list. Largest first moves the largest artwork item to the head of the list. An artwork item is considered larger than another when the sum of its width and height is greater than the others. Regardless of the option chosen, the first artwork item has its picture type set to Cover (front).
• You can now select multiple sets in Preferences-Exception Sets and Replacement Sets.
• Unlink is now available in the file list context menu.
• Unlink has been added to the Link to iTunes action as an option.
• Added a Yate>Reset Warnings menu item.
• The iTunes linked display selection in Preferences-General has been changed to make it easier to use.
• Preferences Import is much better at detecting duplicate items. When importing items in the Add mode, copies will not be created if they already have an exact match.

      Bug Fixes and Tweaks

• Cleaned up the display of hidden sub menus in the file list context menu.
• The Discogs release URL was not always correctly interpreted.
• Evidently there was a recent undocumented change in the Discogs API which always caused the Discogs Wizard to display an empty results list. This has been resolved.
• The manual saving of files in Discogs, MusicBrainz or an action messed up the destination path.
• The Refresh iTunes Action function was not verifying that a tag was linked.
• Remove and Insert in the Multi Field Editor was messing up the removal/insertion points after the first file was processed.
• The log viewer now saves files as UTF-8 as opposed to Latin-1.
• Found a case where the isDup rename logic failed on case sensitive file systems.
• The Get Artwork from iTunes functionality will never replace the existing artwork if iTunes has none.
• The Preferences Import and Export panels now call Key Bindings, ShortCuts. They were originally called key bindings and not renaming them here was an omission.
• Certain mp3 files were not displaying the per file audio information. Bit rate, Sample Rate, etc. This was only happening on some malformed tags.
• The Preferences>Factory Defaults menu item has been removed. The api used to reset the persistant domain does not work in Mountain Lion. A bug has been logged with Apple. We've decided to get around the issue by changing how Reset Preferences works. Reset Preferences will now reset all initial values including those items which are individually resettable. We have retained the ability to reset individual built in items.
• Lots of issues resolved with renaming files in managed iTunes libraries. Note that if your iTunes library has Preferences-Advanced-Keep iTunes media folder organized set, then renaming the files in Yate may not produce the desired results. This is due to iTunes renaming the files back to its desired managed format.
• Track and Disc Pad functions in Rename templates were not working.

Version 1.1 (589)

Thanks to all the users for sending in feature requests. In this release we've tried to implement the most asked for features relating to the iTunes integration.

• We've added the ability to Show Files in iTunes.
  
  This is available via the File menu, the context menu, toolbar buttons and via the Link to iTunes action step. Two methods are available:
  • Show Albums will essentially display a linked album in an iTunes playlist called Yate-Work. You can elect to automatically delete this playlist, if created, when Yate closes. See Preferences-General; for a new option.
  • Show Track will display a single linked file in the main Music playlist.
  
  
• We've added the ability to sync Skip When Shuffling with iTunes. This is another metadata field that iTunes does not write out to the audio files. A new field has been added to the Info tab to support this functionality. When linkd to iTunes and the Skip When Shuffling values differ, a ✖ character will be displayed in the iTunes column.
• 
  
• We've also added a File>Compare iTunes Values menu item. This feature will display a window comparing the linkable values as they exist in iTunes and Yate. You can selectively import and export any value regardless as to the linked field indicators you chose to display in Preferences>General>iTunes Linked Fields. You can also change the Yate values from this dsplay.
• 
  
• There's also been some minor rearrangement of the General preferences.
• 
  
• Bug fix: Growl notifications were not being issued for patched location in iTunes during a rename.

Version 1.0.2 (571)

• TitleCase algorithm now handles words with leading numbers. (2nd, 30th, etc). It will no longer capitalize the first letter.
• Feature request: Action step 'Cover (front) to first' now sets the first artwork item to 'Cover (front)' if no such items were found.
• Bug Fix: Action step 'Case' was not displaying 'Name exceptions' when they were enabled. This only affected the display.
• Feature request: Added a column named 'Artwork Count' which displays the number of artwork items in a file.
• Bug Fix: Exception and Replacements sets were not being restored on a preferences import. They were exported correctly.
• BTW: Videos describing some of the functionality have been uploaded to YouTube. You can access the video under Features on our web site at: 2manyrobots.com/yate

Version 1.0.1 (565)

• Bug Fix: Name exceptions which did not contain wildcard characters were always being capitalized. The case as entered should have been preserved.
• Bug Fix: Fixed some issues with the TitleCase logic.
• Bug Fix: Growl messages from Save in an action were incorrect.

Version 1.0 (560)

• First public release.