Apple Music Library Recap

Like Spotify Wrapped for Apple Music Library, but better because you don't have to wait until December, and you can go back to any year you want.

Apple-Wrapped is a macOS desktop app that reads straight from your Apple Music library. No account needed. No API keys. No Spotify subscription. Just you, your Mac, and your (possibly questionable) taste in music. Perfect if you really like using your local Apple Music library, or if you somehow own a Mac but are too broke to buy Apple Music or Spotify like me.

How it works

Under the hood, this app uses AppleScript to securely access your local Music library data. Then it processes your listening history to generate detailed statistics faster than you can skip a song. The result is a recap that lets you explore your library's story whenever you feel like.

Before you start

You'll need:

• A Mac (this won't work on Windows/Linux, sorry)
• Node.js installed — grab it from nodejs.org if you don't have it
• Apple Music with some songs in your library (the more the better)

---

Running it

Open Terminal, navigate to this folder, and run:

npm install
npm run dev

That's it. The app will open.

First time? macOS will ask if this app can control Music. Say yes — it needs that to read your library. You can find this permission later at System Settings → Privacy & Security → Automation.

---

Build a standalone app

npm run build:mac

This produces the standalone app and DMG installers in the dist/ folder.

---

⭐ Star this if you've ever defended Apple Music in an argument — PRs welcomed.