From the deadwax

Why Apple Music Artwork Disappears When You Move Your Collection

apple-musicartworkicloudcollections

Open Music.app on your Mac right now. Pick an album. One you ripped from CD years ago, or imported from a folder. The artwork is right there. Full resolution, looks great.

Now copy that same file to a USB drive and open it on another machine. Or move your library to a NAS. Or add it to Plex.

The artwork is gone.

Where the artwork actually lives

When Music.app displays album art, it isn't reading it from your audio file. It's reading it from a local metadata cache. Apple's AMPArtworkAgent service manages this cache, and the ITLibrary framework serves artwork from it, not from the file itself. The cache is managed from ~/Library/Containers/com.apple.AMPArtworkAgent/.

This means the artwork you see in Music.app and the artwork embedded in your actual MP3, FLAC, or M4A file are two completely different things. Your file might have a 200×200 JPEG from 2008. It might have nothing at all. Music.app shows you the nice version from its cache regardless.

As long as you stay inside Apple's ecosystem, on that one Mac, with that one library database, you never notice. This AMPArtworkAgent cache desync is one of the most common issues reported in Apple Support Communities. It's been documented in support threads going back years, and it's still the same behavior in the current macOS release.

iCloud Music Library makes it worse

If you use iCloud Music Library (now called "Sync Library"), Apple matches your tracks against its catalog and syncs metadata across your devices. This sounds like it would help. It doesn't. At least not for your files.

Here's what actually happens:

  1. Apple matches your track to its catalog using metadata heuristics and audio analysis.
  2. The match provides cloud artwork, but only in Apple's cache layer, served to Apple devices displaying that matched track.
  3. Your original file is unchanged. The audio bytes on disk still contain whatever artwork (or lack of artwork) they had before the match.
  4. On your other Mac, iCloud syncs the match reference, and Music.app shows the cached artwork there too. It looks like the artwork traveled. It didn't.

The moment you do anything outside of Music.app (copy to a NAS, serve through Plex or Navidrome, sync to an older iPod, open in VLC) the cache is gone. You see what's actually embedded in the file. Which is often nothing.

This is a design decision, not a bug

Apple's approach makes sense from their perspective. They maintain a massive, curated catalog of high-resolution artwork. Serving it from a cloud-backed cache means they can update artwork, fix incorrect covers, and deliver high-res images without touching users' audio files.

But it also means:

  • Your files are incomplete. They don't carry their own artwork. They depend on a cache that exists only inside Apple's ecosystem.
  • Portability is broken. The quality of your collection degrades the moment it leaves Music.app.
  • You don't own the presentation. Apple can change what artwork you see. If a match is wrong, your album shows someone else's cover. If a match is removed, the art disappears.
  • iCloud Music Library transcodes lossless audio to AAC. If you use Sync Library to keep collections consistent across Macs, Apple may replace your FLAC or ALAC files with lossy 256kbps AAC versions. The artwork problem is part of a broader pattern: Apple's sync prioritizes convenience and catalog consistency over preserving what you actually have on disk.

This isn't a temporary limitation or an edge case Apple will patch. It's a fundamental architectural choice: artwork lives in the cloud index, not in your files. No existing tool addresses this across sources. Tag editors can embed artwork into a single file, but none of them understand Music.app's cache behavior, handle multiple collection sources, or maintain quality across machines.

What "embedded" actually means

Audio files have dedicated metadata containers for artwork:

  • MP3 uses ID3v2 tags, a structured header before the audio payload
  • M4A and ALAC use MP4 atoms, specifically the covr atom inside the ilst metadata atom
  • FLAC uses a dedicated Picture metadata block alongside Vorbis comments
  • AIFF uses ID3v2 tags inside an ID3 chunk

When artwork is properly embedded, it's part of the file. It travels with the file. Any player on any device can read it. No cache, no cloud, no specific app required.

The challenge is that writing artwork into these containers correctly is format-specific binary editing. You can't just append bytes. MP4 files need sample-to-chunk offset recalculation. FLAC needs metadata block reindexing. Get it wrong and you corrupt the file or break playback.

How Private Press solves this

Private Press takes the position that your audio files should be self-contained. If you move a file, everything about it (the audio, the metadata, the artwork) should move with it.

The app searches three artwork providers in parallel (iTunes, MusicBrainz, and Discogs) and ranks results by confidence. The confidence score isn't a fuzzy guess. It's computed from album name similarity (Sørensen-Dice bigram coefficient), artist matching, edition detection, track count proximity, and release year. Each result gets a score from 0 to 100. The best match wins.

Once you have the right artwork, you press it into the file. That's the core operation in Private Press, and the name isn't metaphorical. A press is a permanent, format-aware binary write into your audio file's metadata container. Private Press uses dedicated editors for each of the four supported formats. It streams only the metadata regions using FileHandle, never loading the full audio into memory. Every write goes to a temporary file first. If anything fails, the original is untouched. If the write succeeds, an atomic swap replaces the old file. Your audio stays bit-perfect. The artwork is now permanently part of the file.

Every press is recorded with full provenance: which provider supplied the artwork, its resolution, the confidence score, and a timestamp. If you ever need to re-press or verify what changed, the history is there.

For tracks managed by iCloud Music Library, Private Press includes cloud-safe risk scoring before any write. It understands which files are cloud-managed and flags potential conflicts before touching them.

This works for Apple Music and local folders, including collections on a NAS. And because the artwork is in the file, it works everywhere the file goes. Different Mac, different player, different server. No cache dependency. No cloud. Yours.

Keeping it consistent across Macs

Pressing artwork solves the portability problem for individual files. But if you have the same collection on multiple Macs (a studio Mac and a laptop, say) you need those files to stay in sync.

Press Sync, coming to Private Press Pro, will handle this. Two Macs on the same local network discover each other via Bonjour, verify identity through iCloud, and exchange lightweight manifests describing every album. Then they build a Sync Plan. Not a file copy, but a quality-aware merge.

Every album will be classified into one of five buckets: new incoming, new outgoing, quality upgrade available, conflict, or already in sync. If your studio Mac has the lossless ALAC files but your laptop has higher-resolution artwork, Press Sync will keep the better audio and press the better artwork onto it. Quality goes up on both sides. Nothing gets lost.

"Same collection, everywhere" shouldn't mean "same cache, everywhere." It should mean the same files, the same quality, the same pressed artwork, regardless of which Mac you're on or which player you open them in.

The file is the source of truth

Apple built a system where the cloud index is the source of truth for artwork. That works if you never leave their ecosystem. Most people eventually do. A new server, an old iPod, a friend's machine, a car stereo that reads USB.

Private Press takes the opposite position: the file is the source of truth. What's in the file is what you see, everywhere, forever. No cache. No match. No dependency on a service that might change what it shows you.

Your collection took years to build. The artwork should be as permanent as the music.