The Apple Music actions are designed to provide various means of extracting metadata from Apple Music. On tracks purchased from the iTunes store this process is simpler.
A number of actions are provided but only three are user accessible.
The Profile Manager is used to create/edit/delete profiles used by the search and extract actions. You can configure as many profiles as you wish but you must have at least one. There is also the concept of a default profile which can be directly accessed. More information on the Profile Manager and profiles can be found in The Profile Manager.
When editing a profile, this action can directly run the other two.
When you purchase albums from iTunes the tracks have an Apple Music Playlist ID. This ID provides sufficient context to locate the album in the appropriate iTunes store. Purchased tracks also have an Apple Music Catalog ID which can be used to properly map files to individual tracks. Yate stores both these IDs as UDTIs.
This action only processes files with an Apple Music Playlist ID. All other files are ignored. It will attempt to import metadata for each unique Apple Music Playlist ID in the selected files. When called directly, the default profile is always used.
When files do not contain an Apple Music Catalog ID a mapping panel will be presented, if necessary, to allow you to change the file to track mappings.
Whenever per track metadata is imported an Apple Storefront UDTI will be written to the files. When this action is directly started, a consistant Apple Storefront value across all files will supercede the storefront specified in the profile.
Note that as with the Discogs and MusicBrainz wizards, you can elect to run an action whenever metadata is imported. You configure this in the Profile Manager.
This action groups selected files according to the profile settings and performs an album search for each grouping. You enter a query which is typically the album or artist name. A database will be presented with each album which satisfies the query. You would then select a single album in the results and continue.
At this point, the Apple Music Playlist ID will be stored in the files and the AM: Extract Metadata action will be called to import the metadata.
This action emulates the Discogs and MusicBrainz wizards with the added ability to work on more than one album at a time.
You must create at least one profile before you start. If you want to import metadata for files purchased from the iTunes store, you can directly run AM: Extract Metadata. If you want to search for albums you would run the AM: Album Search action.
All panels presented by the various actions have a help button which provides browser based help for the panel.
If you wish you can specify an action for a profile's Post Import Action field. The specified action will be run automatically each time something is imported.
The following extension actions are provided:
A sample container action named AM Extension: Sample Extension Container is provided which runs the first two of the provided extensions. If you want to manually create your own container action, perform the following steps:
If you want to use the AM Extension: Sample Extension Container action, a profile's Post Import Action field must be set to AM Extension: Sample Extension Container.
If you want to modify the AM Extension: Sample Extension Container action it is recommended that you duplicate and rename the action. Subsequent action updates may overwrite AM Extension: Sample Extension Container.
AM: Extract Metadata
AM: Album Search
AM: Profile Manager
Action : AM Helper: Create New Profile Obj
Action : AM Helper: Skip Selected Files
AM Helper: Extract Metadata via Playlist ID
AM Helper: Extract Profile Metadata
AM Helper: Get Album Metadata
AM Helper: Patch Profile
AM Helper: Present Mapping Results
AM Helper: Profile Container to Runtime Settings
AM Helper: Results to Database
AM Helper: Runtime Settings to Profile Container
AM Helper: Search for Album
AM Helper: Skip Selected Files>
AM Extension: Remove HTML from Description Field
AM Extension: Save Artist Artwork to Folder and Remove
AM Extension: Save Artist Artwork to Parent Folder and Remove
AM Extension: Sample Extension Container
|2022-01-09||v1.1||Added warnings if AM: Extract Metadata was run and no tracks have an Apple Playist ID. Bug fix: If grouping tracks by the Album field and a track had trailing spaces in the Album field, the track would not be processed.|
|2022-05-18||v1.2||Added support for Artist artwork and URLs. Request limit is now selected from a popup list. The post processing action can now be selected from a popup list.|