Skip to content
Masab Farooque
Contact

A-01Apple Music Metadata Validator

Apple Music Metadata Validator

Catches the metadata errors that get music releases rejected, before they ever reach Apple Music.

Client
Music distributor
Year
2025
Role
Sole builder.
Apple Music Metadata Validator, catches the metadata errors that get music releases rejected, before they ever reach Apple Music.

Fig. 1 · Architecture

How it works

Every part is drawn from what the project does. The traffic moving through it is illustrative.

Drag to turn · point to inspect

Overview

The client distributes music, and a single malformed field can hold up a release for days. This tool checks an export before it is submitted and flags everything that would fail.

The parser handles the role format used by iMusician, for example primary:Artist Name;producer:Name, and normalises each contributor. It also finds where real data starts in an Excel file on its own, skipping header rows and blank lines without configuration.

Validation follows the Apple Music style guide, including duplicate detection by title, artist and ISRC together. Fields that can be inferred from existing data are filled in automatically, which removes most of the manual correction work.

What it does
  • Finds the real data start row in Excel files automatically
  • Parses the iMusician semicolon role format
  • Fills in missing fields that can be inferred
  • Duplicate detection on title, artist and ISRC together
  • Full Apple Music style guide checks
  • Clear errors with the fix stated next to them
The hard parts
  • Role strings that vary in every export
  • Detecting the data start row across very different file structures
  • Deduplication across several identifier combinations

Built with

ReactTypeScriptExcel parsingCSV processingTailwind CSS

Next project

Blue Lock Archive