@audio/decode-mp4 1.0.0 → 1.1.1

package/README.md

@@ -1,7 +1,7 @@
 # @audio/decode-mp4
 
 Decode the audio track of MP4, MOV, M4A, M4V and 3GP files to PCM float samples.<br>
-A pure-JS ISO BMFF demuxer that skips the video track and routes the audio to the matching codec package, loaded on demand.
+A pure-JS ISO BMFF demuxer that skips the video track and routes the audio (AAC, ALAC, MP3, FLAC, Opus, AC-3, DTS, AMR, PCM) to the matching codec package, loaded on demand.
 
 [![npm install @audio/decode-mp4](https://nodei.co/npm/@audio/decode-mp4.png?mini=true)](https://npmjs.org/package/@audio/decode-mp4/)
 
@@ -29,8 +29,11 @@ dec.free()
 | `samr`, `sawb` | AMR-NB, AMR-WB | [@audio/decode-amr](../decode-amr) |
 | `sowt`, `twos`, `in24`, `in32`, `fl32`, `fl64`, `lpcm`, `ipcm`, `fpcm`, `raw `, `NONE` | PCM 8–32 bit int, 32/64 bit float, either endianness | built in |
 | `ulaw`, `alaw` | G.711 | built in |
+| `ac-3`, `mp4a` (0xA5) | AC-3 | [@audio/decode-ac3](../decode-ac3) |
+| `dtsc`, `dtsh`, `dtsl`, `dtse`, `mp4a` (0xA9) | DTS (core) | [@audio/decode-dts](../decode-dts) |
+| `ec-3`, `mp4a` (0xA6) | E-AC-3 (Dolby Digital Plus) | [@audio/decode-eac3](../decode-eac3) |
 
-AC-3, E-AC-3 and DTS tracks throw an error naming the codec. Fragmented MP4 (`moof`) is not supported. QuickTime sound descriptions v0, v1 and v2 are handled, including `wave`-wrapped configs and `enda` endianness flags. When `moov` follows `mdat` (typical of camera and QuickTime output) the file is buffered until the header arrives.
+TrueHD tracks throw an error naming the codec. Fragmented MP4 (`moof`) is not supported. QuickTime sound descriptions v0, v1 and v2 are handled, including `wave`-wrapped configs and `enda` endianness flags. When `moov` follows `mdat` (typical of camera and QuickTime output) the file is buffered until the header arrives.
 
 Codec packages are imported dynamically, which is unavailable inside an AudioWorklet — decode in the main thread or a Worker.
 

package/decode-mp4.js

@@ -1,7 +1,8 @@
 /**
  * MP4 / MOV / M4A / M4V / 3GP audio decoder — ISO BMFF demuxer that routes the audio track to a codec:
  * AAC, ALAC → @audio/decode-aac · MP3 → @audio/decode-mp3 · FLAC → @audio/decode-flac
- * Opus → @audio/decode-opus/core · AMR → @audio/decode-amr · PCM / µ-law / A-law inline.
+ * Opus → @audio/decode-opus/core · AMR → @audio/decode-amr · AC-3 → @audio/decode-ac3 · E-AC-3 → @audio/decode-eac3
+ * DTS → @audio/decode-dts · PCM / µ-law / A-law inline.
  *
  * let { channelData, sampleRate } = await decode(mp4buf)
  * let dec = await decoder(); let result = await dec.decode(chunk)
@@ -248,13 +249,17 @@ function advance(st) {
 // ===== codec routing =====
 
 const MP3_OTI = new Set([0x69, 0x6B]), AAC_OTI = new Set([0x40, 0x66, 0x67, 0x68])
-const UNSUPPORTED = { 0xA5: 'AC-3', 0xA6: 'E-AC-3', 0xA9: 'DTS', 0xE1: 'QCELP', 'ac-3': 'AC-3', 'ec-3': 'E-AC-3', 'dtsc': 'DTS', 'dtsh': 'DTS-HD', 'dtsl': 'DTS-HD', 'dtse': 'DTS Express' }
+const UNSUPPORTED = { 0xE1: 'QCELP' }
+const DTS_TYPES = new Set(['dtsc', 'dtsh', 'dtsl', 'dtse']) // DTS-HD variants carry a decodable core
 
 async function createCodec({ entry, children }) {
 	let { type } = entry
 	if (type === 'mp4a') {
 		let { oti, dsi } = children.esds ? parseEsds(children.esds) : {}
-		if (MP3_OTI.has(oti)) return mp3()
+		if (MP3_OTI.has(oti)) return frames(import('@audio/decode-mp3'))
+		if (oti === 0xA5) return frames(import('@audio/decode-ac3'))
+		if (oti === 0xA9) return frames(import('@audio/decode-dts'))
+		if (oti === 0xA6) return frames(import('@audio/decode-eac3'))
 		if (!oti || AAC_OTI.has(oti)) {
 			if (!dsi) throw Error('MP4 AAC track has no AudioSpecificConfig')
 			return aac({ asc: dsi })
@@ -265,7 +270,7 @@ async function createCodec({ entry, children }) {
 		if (!children.alac) throw Error('MP4 ALAC track has no magic cookie')
 		return aac({ alac: children.alac })
 	}
-	if (type === '.mp3') return mp3()
+	if (type === '.mp3') return frames(import('@audio/decode-mp3'))
 	if (type === 'fLaC') {
 		if (!children.dfLa) throw Error('MP4 FLAC track has no dfLa box')
 		return flac(children.dfLa.subarray(4))
@@ -275,6 +280,9 @@ async function createCodec({ entry, children }) {
 		return opus(children.dOps)
 	}
 	if (type === 'samr' || type === 'sawb') return amr(type === 'sawb')
+	if (type === 'ac-3') return frames(import('@audio/decode-ac3'))
+	if (type === 'ec-3') return frames(import('@audio/decode-eac3'))
+	if (DTS_TYPES.has(type)) return frames(import('@audio/decode-dts'))
 	let fmt = pcmFormat(entry, children)
 	if (fmt) return pcm(fmt)
 	throw unsupported(UNSUPPORTED[type] || type)
@@ -316,8 +324,9 @@ async function aac(opts) {
 	return { feed: frames => dec.decode(frames), flush: () => dec.flush(), free: () => dec.free() }
 }
 
-async function mp3() {
-	let dec = await (await import('@audio/decode-mp3')).decoder()
+// self-synchronizing frame streams (MP3, AC-3, DTS): the codec resyncs on concatenated samples
+async function frames(load) {
+	let dec = await (await load).decoder()
 	return { feed: frames => dec.decode(concat(frames)), flush: () => dec.flush?.() ?? EMPTY, free: () => dec.free() }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audio/decode-mp4",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Decode the audio track of MP4, MOV, M4A, M4V and 3GP files (AAC, ALAC, MP3, FLAC, Opus, AMR, PCM) to PCM samples",
   "type": "module",
   "main": "decode-mp4.js",
@@ -28,10 +28,13 @@
   ],
   "dependencies": {
     "@audio/decode-aac": "^1.5.0",
+    "@audio/decode-ac3": "^1.0.0",
     "@audio/decode-amr": "^1.3.0",
+    "@audio/decode-dts": "^1.0.0",
     "@audio/decode-flac": "^1.3.0",
     "@audio/decode-mp3": "^1.3.0",
-    "@audio/decode-opus": "^1.3.0"
+    "@audio/decode-opus": "^1.3.0",
+    "@audio/decode-eac3": "^1.0.0"
   },
   "devDependencies": {
     "tst": "^9.2.2"
@@ -39,7 +42,23 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["mp4", "mov", "m4a", "m4v", "3gp", "quicktime", "isobmff", "demux", "video", "audio", "decode", "decoder", "aac", "alac", "pcm"],
+  "keywords": [
+    "mp4",
+    "mov",
+    "m4a",
+    "m4v",
+    "3gp",
+    "quicktime",
+    "isobmff",
+    "demux",
+    "video",
+    "audio",
+    "decode",
+    "decoder",
+    "aac",
+    "alac",
+    "pcm"
+  ],
   "license": "MIT",
   "author": "audiojs",
   "homepage": "https://github.com/audiojs/decode/tree/main/packages/decode-mp4",