KATALOG
1.0  ·  mac OS  ·  iPhone
Download for macOS
Articles

How do I move my Music library to a new Mac and keep my play counts and ratings?

Copy the whole library folder, not just the songs, then point Music at it with the Option key. Here is the full move, step by step, and what goes wrong.

10 November 2026

Copy the whole library folder from the old Mac, not just the song files, then open Music on the new Mac while holding the Option key and choose that library. Your play counts, ratings, playlists and date added live in the library file, not in the songs, so a move that only carries the songs arrives with all of that gone.

That one detail is behind most of the "my new Mac shows an empty library" and "all my plays reset to zero" posts. The rest of this page is the move done properly, plus the fixes for the usual snags.

Why the songs alone are not enough

A Mac music library is two things:

  • The media: the audio files themselves, usually in a Media folder.
  • The library file: a database that remembers everything about those files. Play counts, star ratings, favourites, playlists, last played, date added, and where each file lives on disk.

Most of that second list is never written into the audio files. If you drag only the Media folder to a new Mac and add it to a fresh library, the songs come across and the history does not. You get a clean library with every play count at zero.

Where the library lives

On a Mac running the Music app, the default spot is your Home folder > Music > Music. Inside you will find a file called Music Library.musiclibrary and a Media folder.

If the old Mac is older and still runs iTunes, look in Home folder > Music > iTunes. The library file there is iTunes Library.itl, next to an iTunes Media folder. The Music app can open and convert that kind of library, and it leaves the original file alone when it does.

If your songs are on an external drive, the library folder may still be on the internal disk while the media sits on the drive. Check before you copy.

The move, step by step

  1. Quit Music (or iTunes) on the old Mac. Copying a library while the app has it open can leave you with a half-written file.
  2. Copy the whole folder (the Music folder or the iTunes folder described above, with the library file and media inside) to an external drive, or straight across with Migration Assistant if you are setting the new Mac up from scratch. Migration Assistant moves your Home folder, Music included, and is the least fiddly route.
  3. Put the folder in Home folder > Music on the new Mac. Running a library from the internal disk avoids a whole class of permission and drive-name problems.
  4. Hold the Option key and open Music. Keep holding until a small window appears, then click Choose Library and select the folder you copied.
  5. Give it time. A large library, or one coming from iTunes, can take a while to convert on first open. Let it finish before you start editing.

When it opens, spot check a few songs you know you played a lot. If the play counts are there, the history came across.

If your songs live on an external drive

A library remembers where each file is by its full path, and the drive's name is part of that path. So:

  • Plug the drive in before you open Music.
  • Keep the drive's name exactly the same as it was on the old Mac. Rename it and every song points at a location that no longer exists.
  • If songs show a small exclamation mark, Music cannot find the file. Right click one, choose to locate it, and point it at the right file. Music may offer to find the rest in the same folder.

If the library opens empty

  • You opened a new library by accident. Quit, hold Option, open Music again and choose the right folder.
  • You copied the media without the library file. Go back to the old Mac and copy the whole folder.
  • The drive was not mounted. Quit Music, plug the drive in, open Music again.

A backup that does not depend on the library file

Before a big move, it is worth exporting a copy of the library's details. In Music, choose File > Library > Export Library. That writes an XML file listing every track with its rating, favourite status and play count. Keep it next to your backup. If the library file is ever lost or damaged, you still have the record of what you played and how you rated it.

Make the next move easier

The reason a move is risky is that so much of your work sits in one database file. The more of it that lives in the songs themselves, the less a lost library file can take with it.

Katalog is a Mac app that runs alongside the Music app and writes your tag edits into the files themselves, so artists, albums, genres and artwork travel with the songs to the next Mac, the next drive or the next app. It opens large libraries in under a second and keeps everything local. Katalog

Quick checklist

  • Quit the app on the old Mac first.
  • Copy the whole library folder, not only the Media folder.
  • Put it in Home folder > Music on the new Mac.
  • Hold Option when opening Music and choose that library.
  • External drive: plug it in first, keep its name the same.
  • Export the library to XML as a backup before you start.

Katalog is a library manager for large, owned music collections, for macOS. The full version is yours to try right now for 30 days.

Download for macOS