The edit profile panel contains all the settings which control the import of metadata. Per item help is available for items by selecting the item and pressing the spacebar.The panel is divided into five sections:
- Configuration Settings
- These settings are not associated with any particular metadata item. The configuration settings are described in detain below.
- Album Import Settings
- These settings describe the metadata items associated with the album as opposed to tracks. Barcode and Single will be imported to UDTIs or custom fields.
- Album & Track Import Settings
- These settings describe the metadata items which are imported from the album and might be overwritten if track level metadata is imported.
- Track Import Settings
- These settings describe the metadata items which are imported from tracks. Original Release Time is only imported if it differs from the Release Time.
- Search for Songs Settings
- These settings are only used by the Search for Songs actions. These settings are not associated with any particular metadata item. The settings are described in detain below.
Note that all import settings are tri-state checkboxes. When On, the item is always imported. When Off, the item is not imported. When Mixed (-), the item is only imported if it is not already present in the file.
The panel's context menu can be used to mark all import settings for import, non import or import only if empty. Note that the configuration settings are not affected by the context menu functions.
Configuration Settings
- File Grouping
- The Album Search action can perform multiple searches. This setting controls how the selected files are grouped. When the value column is Album, albums are grouped by the Album metadata item. When the value column is Folder, tracks in the same folder are grouped. When the value column is All Files, all selected tracks are treated as a single group.
- Ignore all but first genre
- An album can have multiple genres. When this settings is On, only the first genre will be retained.
- Ignore first genre in mood
- The mood field is imported as a copy of the genre information. When this setting is On, the first genre in the list will not be placed into mood.
- Join sequence
- The genre and mood fields might be populated with multiple items. If this field is empty, the multi value delimiter is used. When non empty, the field's contents will be use to delimit values.
- Match track threshold
- When mapping tracks to files, a weighted comparison is performed by comparing a file's Artist, Title, Disc, and Track fields and its duration against the available downloaded track metadata. This test always results in the mapping of a single file to every track (assuming they are available).
A second test is performed which produces a percentage fuzzy score by comparing a downloaded tracks's title with the following:
- a file's title
- a filename
- a filename run through all available File to Tag templates. This is used to extract the title from the filename which may contain other metadata components.
The fuzzy comparison ignores alphabetic case, accents and will discard all words in the Weight Exception set. By removing the words in the Weight Exception set, the accuracy is improved.
The threshold supplied in this setting determines the percentage at which a fuzzy comparison will be considered a perfect match. When displaying the mapping results, only those items which had the correct Apple Music Catalog ID or meet the threshold requirements will be preselected for import.
- Only import album tags
- When this option is set, only metadata at the album level will be imported. ie. all track level import settings will be treated as Off.
- Post Import Action
- This field can optionally contain the name of an action to be run whenever metadata is imported. If an album is skipped the action is not run. All track variables are preserved before the call, then restored.
- Remove existing artwork
- When artwork is imported it is added. When this setting is On, existing artwork will be deleted whenever artwork is imported.
- Request Limit
- As with the Discogs and MusicBrainz wizards, search replies are effectively limited to 25, 60, 75 or 100 items.
- Select all loaded files
- When set to ✓, all loaded files will be processed regardless of the current file selection.
- Storefront
- The Apple Music API targets a particular storefront. Each storefront is represented by a two character code. Select a storefront from the value cell's menu.
- Truncate year to yyyy
- The Year field is populated from Release Time metadata. When this setting is On, only the year will be saved.
- Write imported tag
- This setting is a tri-state. When set to ✓, a UDTI named Apple Music Import Timewill be written with a timestamp as a value whenever a track has something imported. Whenever track level metadata is being imported and a track is not mapped, a UDTI named Apple Music Unmatched will be written with a timestamp as a value.
Note that when set to ✓, UDTIs named Apple Music Skipped and Apple Music Import Time and Apple Music Unmatched will be removed when a file is skipped. When the setting is -, pre-existing UDTIs will not be removed.
- Write skipped tags
- When set to ✓, and an album is skipped, a UDTI named Apple Music Skipped will be written with a timestamp as a value.
- Write failed Catalog ID tags
- When set to ✓, and a known Catalog ID cannot be located, a UDTIs named Apple Music Failed Catalog ID will be written with the failed ID as the value. These failures may be caused by an incorrect store setting.
- Write failed Playlist ID tags
- When set to ✓, and a known Playlist ID cannot be located, a UDTIs named Apple Music Failed Catalog ID will be written with the failed ID as the value. These failures may be caused by an incorrect store setting.
Search for Songs Settings
- Artist Threshold
- A percentage in the range of 10 to 100 which determines what constitutes a successful fuzzy match of the Artist field.
- Title Threshold
- A percentage in the range of 10 to 100 which determines what constitutes a successful fuzzy match of the Title field.
- Preferred match
- This setting constrains which item is matched.
- First Best
In all matches with the best fuzzy compare score, the first is chosen.
- Earliest Best
In all matches with the best fuzzy compare score, the one with the earliest release date is chosen.
- Earliest Any
In all matches which satisfy the fuzzy thresholds, the one with the earliest release date is chosen.
- Do not process qualifiers
- Songs in the iTunes store often contain qualifiers enclosed in ( ) or [ ] sequences at the end of a song's name. This can cause compares to fail. By default, comparisons will be performed twice if required: once with the published name and once with the qualifiers removed. When set to ✓, the test with qualifiers removed will not be performed.
- Look for all metadata
- The per track actions, by default, cannot import all metadata which can be marked for import. This includes: Album Artist, Album URL, Artist Artwork , Artist Artwork URLs, Artist URLs, Barcode, Copyright, Description, Label, Part of a Compilation, Single, Disc Count, Track Count. When set to ✓, this setting will perform a more extensive search algorithm which supports the import of all of the metadata types.
- Use album name with threshold
- While there is no need to use Album metadata when searching, it can optionally be used to modify a potential item's score when matching. If this setting is set to ✓, album testing will be performed. This setting is only available when Preferred match is set to First Best.
If the Run... button is displayed, it will display a menu listing the suite's actions. If you select a menu item, the associated action will be run using the displayed profile as opposed to the default profile.
The Profile Manager
Apple Music Suite Overview
