https://github.com/sequencemedia/music-library-parser
https://github.com/sequencemedia/music-library-parser
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/sequencemedia/music-library-parser
- Owner: sequencemedia
- Created: 2021-12-27T11:22:00.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-03-06T22:37:32.000Z (4 months ago)
- Last Synced: 2026-03-07T03:34:50.082Z (4 months ago)
- Language: XSLT
- Size: 2.47 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# @sequencemedia/music-library-parser
JavaScript functions and XSL stylesheets to parse an Apple Music `Library.xml` file and transform it to [`m3u`](https://en.wikipedia.org/wiki/M3U) files, JSON, JavaScript, or EcmaScript.
Requires [Java](https://www.oracle.com/java/technologies/javase-downloads.html) and [Saxon PE](https://www.saxonica.com/welcome/welcome.xml).
## Library
Transforms the entire library.
```javascript
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.
```javascript
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.
```javascript
import { toM3U } from './src/js/library/tracks/index.mjs'
import {
toJSON,
toJS,
toES
} from './src/js/library/tracks/transform/index.mjs'
```
See **Library**.