# The Artwork Edit Panel

The Artwork panel is used to display and edit artwork for the current file selection. Note that this panel is only accessible if the current file selection contains tracks in the same folder, unless the File List Preference File List Preference, Disable Artwork panel when tracks in multiple folders are selected, is not checked. Warning: It is inherently dangerous to edit artwork across albums. If you make changes to which images are included in the final set you might find that the order of the remaining images in the files has changed. This is due to the fact that Yate merges the display of common items when multiple files are being edited. When disabled due to the preference setting a lock icon will be displayed.

If the selected files contain more than one image a table will be displayed which presents the list of available images. If only one image is available, the table will be hidden.

The table displays the artwork found in the files currently selected. It also shows the order of the artwork in the files. (This tends to make more sense if a single file is selected). You may drag and drop the images to change their order. Note that the images can only be dragged when all of the artwork is in all of the files. If this is not the case, dragging makes no sense. Yate treats the first image in an audio file as the default image. Most audio applications will only display this image.

A status symbol will be displayed to the left of an image in the table. The context menu for the images has a submenu named Status Codes which describes each of the symbols. The context menu is used to perform functions on the selected item.

The current selected image is displayed larger to the right of the table. (If a table is not required, only the larger image will be visible). This is the image you are working on. Three pieces of information are displayed for the current image. The Mime type field describes the mime type of the image, usually image/jpg or image/png, the dimensions of the image in pixels and the size of the image in kb. This field is a read only field. The picture type field allows you to select one of the ID3 picture types to associate with the image. The description field is a short textual description of the image. The Description field should be unique for every image in an mp3 file. Only those files which initially contained the image will be modified.

If items are deleted or modified, you can view the originals by selecting the Initial values and/or the Editing state values options.

The following functions may be available from the context menu for the large image or table items:

> Add Artwork...
>   Choose an artwork item to add.
> Set as Default
>   Make the selected item the default artwork item.
> Apply to All
>   Apply the current item to all selected files
> Delete Artwork
>   Remove the selected artwork items
> Recreate Item
>   When an item which is no longer in the file but is displayed as being in the initial or editing state is selected, you can recreate the item for the files which initially contained it.
> Revert All to>Initial Values
>   Restore the initial artwork items for all selected files.
> Revert All to>Editing State Values
>   Restore the editing state artwork items for all selected files.
> Crop Image...
>   You can to display a panel allowing you to crop the displayed image.
> Save to Folder Icon
>   Save the selected item as an icon on the folder containing the selected files.
> Save to Folder Icon of Chosen Folder...
>   Save the selected item as an icon on the chosen folder.
> Save to folder.jpg
>   Save the selected item as folder.jpg in the same folder as the selected files.
> Save to folder.jpg in Chosen Folder...
>   Save the selected item as folder.jpg in the chosen folder.
> Save Artwork to...
>   If a single artwork item is selected, save the artwork item to a specified file. When saving artwork in this manner you can also modify the type of the artwork encoding, the dimensions of the item and optionally set the image to grayscale. If an image is being modified you can also elect to save a copy of the new image in all selected files.
>   If more than one artwork item is selected, save them to a specified folder. When saving artwork in this manner you can choose how the file names are constructed.
> Copy/Paste
>   Artwork can be copied from and pasted to the large image display.

The following functions are available from the context menu for table items:

> Normalize
>   The function accumulates all unique artwork items by type within an album and causes every track to have a copy of each accumulated item. Tracks without Album fields are ignored.
> Largest First
>   The function makes the largest artwork item the default (first), for every track. The item is assigned a picture type of Cover (front).
> Delete all But Largest
>   The artwork is normalized then all but the largest artwork item is deleted.

In addition to the add artwork functions described above you can add artwork by dragging image files, audio files, any files containing a jpg or png image, or an image from any application or browser to the large image area. Icons can be extracted from folders by holding down the shift key and dragging a folder to the large image area.

You can also drag images and artwork files to the main file list. Be careful here as dragging an audio file to the main file list will not have the same effect as dragging it to the artwork tab.

Images can be dragged out of the large image display to any application which can receive dragged image data.

Images can be dragged out of the large image display directly to a Finder folder. The file will be named as follows:

- If the Shift key is pressed when the drag starts, the file will be named folder.jpg.
- If the Mime Type of the image is jpg or png, the file will be named Yate Artwork timestamp with the appropriate filename extension.
- The file will be named Yate Artwork timestamp with a filename extension corresponding to the Artwork preferences default artwork type.

If you want to save all the artwork items in the selected files, use an Artwork to Folder action statement. A simple action can be constructed which prompts for a destination folder and then saves the artwork.

You can search for artwork based on the metadata of the file by issuing an Artwork>Search for artwork... template. You can read more about this feature in Preferences - Search Templates.

Additional Information:

Opening files and the Open Mode ... Controlling what gets opened

The Main Window

The Current Selection, the Editing State, Red Light Green Light and What's With All Those Round Colored Buttons

Multiple Items and Multiple Values

The Custom Panel Editor