@sequencemedia/music-library-parser

Parse Apple Music Library XML to JSON, JS, ES, or M3U


Keywords
music, library, xml, parser, audio, video, track, playlist, json, m3u, m3u8
License
ISC
Install
npm install @sequencemedia/music-library-parser@1.1.26

Documentation

@sequencemedia/music-library-parser

JavaScript functions and XSL stylesheets to parse an Apple Music Library.xml file and transform it to m3u files, JSON, JavaScript, or EcmaScript.

Requires Java and Saxon PE.

Library

Transforms the entire library.

import { toM3U } from './src/js/library/index.mjs'
import {
  toJSON,
  toJS,
  toES
 } from './src/js/library/transform/index.mjs'

toM3U

Requires the arguments jar, xml, and destination.

  • jar - the path to the Saxon binary on your device
  • xml - the path to the Apple Music Library.xml file
  • destination - the path for the m3u files to be written

Returns a Promise resolving when all m3u files are written.

toJSON

Requires the arguments jar, and xml.

  • jar - the path to the Saxon binary on your device
  • xml - the path to the Apple Music Library.xml file

Returns a Promise resolving to a JSON string.

toJS

Requires the arguments jar, and xml.

  • jar - the path to the Saxon binary on your device
  • xml - the path to the Apple Music Library.xml file

Returns a Promise resolving to a JavaScript object.

toES

Requires the arguments jar, and xml.

  • jar - the path to the Saxon binary on your device
  • xml - the path to the Apple Music Library.xml file

Returns a Promise resolving to a collection of JavaScript Map and Set instances.

Playlists

Transforms the playlists.

import { toM3U } from './src/js/library/playlists/index.mjs'
import {
  toJSON,
  toJS,
  toES
 } from './src/js/library/playlists/transform/index.mjs'

See Library.

Tracks

Transforms the tracks.

import { toM3U } from './src/js/library/tracks/index.mjs'
import {
  toJSON,
  toJS,
  toES
 } from './src/js/library/tracks/transform/index.mjs'

See Library.