Skip to main content

Album Art Embedder

The Album Art Embedder looks for an image, downloads one if it can't find it locally, and then writes that image directly into the audio file's metadata.

How it Works​

1. Finds​

The flow element first tries to source an image without using the internet:

  • Internal: It checks if the audio file already has an image inside it. If it does, it skips the search.
  • Local Files: It scans the folder containing your audio file for common names like cover.jpg, folder.jpg, albumart.jpg, or front.jpg.
  • Existing Custom: If you have a Custom path set, it checks if your preferred artwork file already exists there before trying to download a new one.

2. Downloads​

If no local image is found, it attempts to get one online:

  • Search: It uses the {audio.AlbumArtist} and {audio.Album} variables to search TheAudioDb.
  • Fetch: If a match is found, it downloads the highest-quality cover available to a temporary area.
  • Skip: If the file is missing Artist or Album metadata, it won't know what to search for and will skip this step.

3. Embeds​

Once an image is found (locally) or fetched (online), the flow element embeds it:

  • Injection: It writes the image data directly into the audio file (ID3/Vorbis tags).
  • Self-Contained: Once embedded, the artwork stays with the file even if you move it to a phone, a car, or another folder that doesn't have the cover.jpg file.

Configuration​

Save to Folder​

Determines if a copy of the image should be kept on your hard drive:

  • No – The image is only put inside the audio file.
  • Source Folder – Saves a copy (like cover.jpg) next to the audio file.
  • Custom – Saves the image to a specific path you define.

Destination Path​

Where to save the image when using Custom mode.

  • Supports variables like /MyMusic/Covers/{audio.Artist}/.
  • Defaults to the audio file's folder if left blank.

Destination File​

The name for the saved image (e.g., folder or front).

  • Default: cover.
  • Extensions: It defaults to .jpg, but if it sees an existing .jpeg or .jpe, it will use that extension to avoid making duplicates.

Outputs​

  1. Embedded: Artwork was found and successfully written into the audio file.
  2. Not Embedded: No artwork was added. This happens if no local image was found, the online search failed, or the file had no metadata to search with.