Application icon

Create Stubs / Process Stubs

iTunes and Music have the ability to attempt to download missing artwork for audio files. Unfortunately you cannot add APE, DFF, DSF, FLAC, OGG or WV files to your library. Further, while iTunes and Music can contain WAV files in their libraries they will not process artwork for WAV files.

These statements can be used as part of a workflow to get around this limitation.

This statement is only valid stepwise and while batch processing.

First you run a batch process where the action contains a Create Stubs statement. You specify which audio types you are interested in processing for missing artwork. (m4a, m4b, m4r, m4v and mp4 files all fall under MPEG-4). Note that files containing video are not processe. If a folder contains at least one audio file of a specified type, Yate will construct a small mp3 file, a stub, with one track's metadata. One stub file will be created for every unique album name. The created files will be added to iTunes or Music and linkage information will be retained. Folders already containing stub files are ignored. Any albums already containing artwork are also ignored.

When the batch process completes, you can go to iTunes or Music, select the produced stub files and from the context menu in the Album view do a Get Album Artwork. If your metadata for Album and Artist matches with something in Apple's extensive catalog, an artwork item will be downloaded. In order to make it easier to find the stub files, the Grouping field will have been set to STUB. The easiest way to locate the stub files in iTunes or Music is to create a Smart Playlist which matches a Grouping field of STUB. Note that if you have enabled the iTunes-Preferences-Store-Automatically Download Album Artwork, or the Music-Preferences-Advanced-Automatically update artwork option this step should take place automatically.

After attempting to download the missing artwork in iTunes or Music you can run a second batch process containing a Process Stubs statement. The statement will ignore folders which do not contain stub files. Each produced stub file retains the linkage information and the file types that you're interested in. Typically you want the statement to extract artwork, remove the stub files and then to delete the stub files. You can pick any combination of these options if for any reason you want to clean things up without extracting artwork. Remember that the Batch Processing Wizard does not automatically save modified files. Either select Auto Save Files before starting the batch run or include a Save statement in the action.

If no artwork for a particular stub file has been located, no tracks will be modified. Artwork will not be saved to files which already contain artwork. If you create the stub files, then manually add artwork to the tracks, the Process Stub statement will not modify the tracks.

These statements are intended to be used as a workflow. Do not edit the files after the Create Stubs batch run before you do the Process Stubs batch run.