music-metadata 11.8.3 → 11.10.0

package/README.md

@@ -602,6 +602,9 @@ Returns a list of supported MIME-types. This may include some MIME-types which a
   Note that enabling this option **does not guarantee** that duration will be available,
   only that the parser will attempt to calculate it when possible, even if it requires reading the full file.
 
+- `includeChapters`: `boolean` (default: `false`)
+  When `true`, the MP4 parser scans the `mdat` atom for chapters.
+
 - `mkvUseIndex`: `boolean` (default: `false`)
 
   When `true`, the parser uses the SeekHead index in Matroska (MKV) files to skip segment and cluster elements.

package/lib/ParserFactory.js

@@ -137,5 +137,5 @@ export class ParserFactory {
 }
 function getExtension(fname) {
     const i = fname.lastIndexOf('.');
-    return i === -1 ? '' : fname.slice(i);
+    return i === -1 ? '' : fname.substring(i);
 }

package/lib/apev2/APEv2Parser.js

@@ -132,8 +132,8 @@ export class APEv2Parser extends BasicParser {
                         const picData = new Uint8Array(tagItemHeader.size);
                         await this.tokenizer.readBuffer(picData);
                         zero = util.findZero(picData, 0, picData.length);
-                        const description = textDecode(picData.slice(0, zero), 'utf-8');
-                        const data = picData.slice(zero + 1);
+                        const description = textDecode(picData.subarray(0, zero), 'utf-8');
+                        const data = picData.subarray(zero + 1);
                         await this.metadata.addTag(tagFormat, key, {
                             description,
                             data

package/lib/asf/AsfObject.js

@@ -210,7 +210,7 @@ export class ContentDescriptionObjectState extends State {
             if (length > 0) {
                 const tagName = ContentDescriptionObjectState.contentDescTags[i];
                 const end = pos + length;
-                tags.push({ id: tagName, value: parseUnicodeAttr(buf.slice(off + pos, off + end)) });
+                tags.push({ id: tagName, value: parseUnicodeAttr(buf.subarray(off + pos, off + end)) });
                 pos = end;
             }
         }
@@ -232,13 +232,13 @@ export class ExtendedContentDescriptionObjectState extends State {
         for (let i = 0; i < attrCount; i += 1) {
             const nameLen = view.getUint16(pos, true);
             pos += 2;
-            const name = parseUnicodeAttr(buf.slice(off + pos, off + pos + nameLen));
+            const name = parseUnicodeAttr(buf.subarray(off + pos, off + pos + nameLen));
             pos += nameLen;
             const valueType = view.getUint16(pos, true);
             pos += 2;
             const valueLen = view.getUint16(pos, true);
             pos += 2;
-            const value = buf.slice(off + pos, off + pos + valueLen);
+            const value = buf.subarray(off + pos, off + pos + valueLen);
             pos += valueLen;
             this.postProcessTag(tags, name, valueType, value);
         }
@@ -298,9 +298,9 @@ export class MetadataObjectState extends State {
             pos += 2;
             const dataLen = view.getUint32(pos, true);
             pos += 4;
-            const name = parseUnicodeAttr(uint8Array.slice(off + pos, off + pos + nameLen));
+            const name = parseUnicodeAttr(uint8Array.subarray(off + pos, off + pos + nameLen));
             pos += nameLen;
-            const data = uint8Array.slice(off + pos, off + pos + dataLen);
+            const data = uint8Array.subarray(off + pos, off + pos + dataLen);
             pos += dataLen;
             this.postProcessTag(tags, name, dataType, data);
         }

package/lib/asf/GUID.js

@@ -25,7 +25,7 @@ class GUID {
      */
     static decode(objectId, offset = 0) {
         const view = new DataView(objectId.buffer, offset);
-        const guid = `${view.getUint32(0, true).toString(16)}-${view.getUint16(4, true).toString(16)}-${view.getUint16(6, true).toString(16)}-${view.getUint16(8).toString(16)}-${uint8ArrayToHex(objectId.slice(offset + 10, offset + 16))}`;
+        const guid = `${view.getUint32(0, true).toString(16)}-${view.getUint16(4, true).toString(16)}-${view.getUint16(6, true).toString(16)}-${view.getUint16(8).toString(16)}-${uint8ArrayToHex(objectId.subarray(offset + 10, offset + 16))}`;
         return guid.toUpperCase();
     }
     /**
@@ -51,11 +51,11 @@ class GUID {
     static encode(str) {
         const bin = new Uint8Array(16);
         const view = new DataView(bin.buffer);
-        view.setUint32(0, Number.parseInt(str.slice(0, 8), 16), true);
-        view.setUint16(4, Number.parseInt(str.slice(9, 13), 16), true);
-        view.setUint16(6, Number.parseInt(str.slice(14, 18), 16), true);
-        bin.set(hexToUint8Array(str.slice(19, 23)), 8);
-        bin.set(hexToUint8Array(str.slice(24)), 10);
+        view.setUint32(0, Number.parseInt(str.substring(0, 8), 16), true);
+        view.setUint16(4, Number.parseInt(str.substring(9, 13), 16), true);
+        view.setUint16(6, Number.parseInt(str.substring(14, 18), 16), true);
+        bin.set(hexToUint8Array(str.substring(19, 23)), 8);
+        bin.set(hexToUint8Array(str.substring(24)), 10);
         return bin;
     }
     constructor(str) {

package/lib/common/FourCC.js

@@ -9,7 +9,7 @@ const validFourCC = /^[\x21-\x7e©][\x20-\x7e\x00()]{3}/;
 export const FourCcToken = {
     len: 4,
     get: (buf, off) => {
-        const id = textDecode(buf.slice(off, off + FourCcToken.len), 'latin1');
+        const id = textDecode(buf.subarray(off, off + FourCcToken.len), 'latin1');
         if (!id.match(validFourCC)) {
             throw new FieldDecodingError(`FourCC contains invalid characters: ${util.a2hex(id)} "${id}"`);
         }

package/lib/common/GenericTagTypes.d.ts

@@ -4,7 +4,7 @@ export interface IGenericTag {
     id: keyof ICommonTagsResult;
     value: AnyTagValue;
 }
-export type GenericTagId = 'track' | 'disk' | 'year' | 'title' | 'artist' | 'artists' | 'albumartist' | 'album' | 'date' | 'originaldate' | 'originalyear' | 'releasedate' | 'comment' | 'genre' | 'picture' | 'composer' | 'lyrics' | 'albumsort' | 'titlesort' | 'work' | 'artistsort' | 'albumartistsort' | 'composersort' | 'lyricist' | 'writer' | 'conductor' | 'remixer' | 'arranger' | 'engineer' | 'technician' | 'producer' | 'djmixer' | 'mixer' | 'publisher' | 'label' | 'grouping' | 'subtitle' | 'discsubtitle' | 'totaltracks' | 'totaldiscs' | 'compilation' | 'rating' | 'bpm' | 'mood' | 'media' | 'catalognumber' | 'tvShow' | 'tvShowSort' | 'tvEpisode' | 'tvEpisodeId' | 'tvNetwork' | 'tvSeason' | 'podcast' | 'podcasturl' | 'releasestatus' | 'releasetype' | 'releasecountry' | 'script' | 'language' | 'copyright' | 'license' | 'encodedby' | 'encodersettings' | 'gapless' | 'barcode' | 'isrc' | 'asin' | 'musicbrainz_recordingid' | 'musicbrainz_trackid' | 'musicbrainz_albumid' | 'musicbrainz_artistid' | 'musicbrainz_albumartistid' | 'musicbrainz_releasegroupid' | 'musicbrainz_workid' | 'musicbrainz_trmid' | 'musicbrainz_discid' | 'acoustid_id' | 'acoustid_fingerprint' | 'musicip_puid' | 'musicip_fingerprint' | 'website' | 'performer:instrument' | 'peakLevel' | 'averageLevel' | 'notes' | 'key' | 'originalalbum' | 'originalartist' | 'discogs_artist_id' | 'discogs_label_id' | 'discogs_master_release_id' | 'discogs_rating' | 'discogs_release_id' | 'discogs_votes' | 'replaygain_track_gain' | 'replaygain_track_peak' | 'replaygain_album_gain' | 'replaygain_album_peak' | 'replaygain_track_minmax' | 'replaygain_album_minmax' | 'replaygain_undo' | 'description' | 'longDescription' | 'category' | 'hdVideo' | 'keywords' | 'movement' | 'movementIndex' | 'movementTotal' | 'podcastId' | 'showMovement' | 'stik';
+export type GenericTagId = 'track' | 'disk' | 'year' | 'title' | 'artist' | 'artists' | 'albumartist' | 'album' | 'date' | 'originaldate' | 'originalyear' | 'releasedate' | 'comment' | 'genre' | 'picture' | 'composer' | 'lyrics' | 'albumsort' | 'titlesort' | 'work' | 'artistsort' | 'albumartistsort' | 'composersort' | 'lyricist' | 'writer' | 'conductor' | 'remixer' | 'arranger' | 'engineer' | 'technician' | 'producer' | 'djmixer' | 'mixer' | 'publisher' | 'label' | 'grouping' | 'subtitle' | 'discsubtitle' | 'totaltracks' | 'totaldiscs' | 'compilation' | 'rating' | 'bpm' | 'mood' | 'media' | 'catalognumber' | 'tvShow' | 'tvShowSort' | 'tvEpisode' | 'tvEpisodeId' | 'tvNetwork' | 'tvSeason' | 'podcast' | 'podcasturl' | 'releasestatus' | 'releasetype' | 'releasecountry' | 'script' | 'language' | 'copyright' | 'license' | 'encodedby' | 'encodersettings' | 'gapless' | 'barcode' | 'isrc' | 'asin' | 'musicbrainz_recordingid' | 'musicbrainz_trackid' | 'musicbrainz_albumid' | 'musicbrainz_artistid' | 'musicbrainz_albumartistid' | 'musicbrainz_releasegroupid' | 'musicbrainz_workid' | 'musicbrainz_trmid' | 'musicbrainz_discid' | 'acoustid_id' | 'acoustid_fingerprint' | 'musicip_puid' | 'musicip_fingerprint' | 'website' | 'performer:instrument' | 'peakLevel' | 'averageLevel' | 'notes' | 'key' | 'originalalbum' | 'originalartist' | 'discogs_artist_id' | 'discogs_label_id' | 'discogs_master_release_id' | 'discogs_rating' | 'discogs_release_id' | 'discogs_votes' | 'replaygain_track_gain' | 'replaygain_track_peak' | 'replaygain_album_gain' | 'replaygain_album_peak' | 'replaygain_track_minmax' | 'replaygain_album_minmax' | 'replaygain_undo' | 'description' | 'longDescription' | 'category' | 'hdVideo' | 'keywords' | 'movement' | 'movementIndex' | 'movementTotal' | 'podcastId' | 'showMovement' | 'stik' | 'playCounter';
 export interface INativeTagMap {
     [index: string]: GenericTagId;
 }

package/lib/common/GenericTagTypes.js

@@ -112,7 +112,8 @@ const commonTags = {
     movementTotal: defaultTagInfo,
     podcastId: defaultTagInfo,
     showMovement: defaultTagInfo,
-    stik: defaultTagInfo
+    stik: defaultTagInfo,
+    playCounter: defaultTagInfo
 };
 export const commonTagsKeys = /* @__PURE__ */ Object.keys(commonTags);
 /**

package/lib/common/MetadataCollector.js

@@ -5,7 +5,7 @@ import { CombinedTagMapper } from './CombinedTagMapper.js';
 import { CommonTagMapper } from './GenericTagMapper.js';
 import { toRatio } from './Util.js';
 import { fileTypeFromBuffer } from 'file-type';
-import { parseLrc } from '../lrc/LyricsParser.js';
+import { parseLyrics } from '../lrc/LyricsParser.js';
 const debug = initDebug('music-metadata:collector');
 const TagPriority = ['matroska', 'APEv2', 'vorbis', 'ID3v2.4', 'ID3v2.3', 'ID3v2.2', 'exif', 'asf', 'iTunes', 'AIFF', 'ID3v1'];
 /**
@@ -187,7 +187,7 @@ export class MetadataCollector {
                 break;
             case 'lyrics':
                 if (typeof tag.value === 'string') {
-                    tag.value = parseLrc(tag.value);
+                    tag.value = parseLyrics(tag.value);
                 }
                 break;
             default:

package/lib/common/Util.d.ts

@@ -51,3 +51,8 @@ export declare function dbToRatio(dB: number): number;
  * @param value string holding a ratio like '0.034' or '-7.54 dB'
  */
 export declare function toRatio(value: string): IRatio | undefined;
+/**
+ * Decode a big-endian unsigned integer from a Uint8Array.
+ * Supports dynamic length (1–8 bytes).
+ */
+export declare function decodeUintBE(uint8Array: Uint8Array): number;

package/lib/common/Util.js

@@ -1,5 +1,6 @@
 import { StringType } from 'token-types';
 import { FieldDecodingError } from '../ParseError.js';
+import { getUintBE } from 'uint8array-extras';
 export function getBit(buf, off, bit) {
     return (buf[off] & (1 << bit)) !== 0;
 }
@@ -140,3 +141,14 @@ export function toRatio(value) {
         };
     }
 }
+/**
+ * Decode a big-endian unsigned integer from a Uint8Array.
+ * Supports dynamic length (1–8 bytes).
+ */
+export function decodeUintBE(uint8Array) {
+    if (uint8Array.length === 0) {
+        throw new Error("decodeUintBE: empty Uint8Array");
+    }
+    const view = new DataView(uint8Array.buffer, uint8Array.byteOffset, uint8Array.byteLength);
+    return getUintBE(view);
+}

package/lib/flac/FlacParser.js

@@ -96,13 +96,21 @@ export class FlacParser extends AbstractID3Parser {
      */
     async parseComment(data) {
         const decoder = new VorbisDecoder(data, 0);
-        decoder.readStringUtf8(); // vendor (skip)
+        const vendor = decoder.readStringUtf8();
+        if (vendor.length > 0) {
+            this.metadata.setFormat('tool', vendor);
+        }
         const commentListLength = decoder.readInt32();
         const tags = new Array(commentListLength);
         for (let i = 0; i < commentListLength; i++) {
             tags[i] = decoder.parseUserComment();
         }
-        await Promise.all(tags.map(tag => this.addTag(tag.key, tag.value)));
+        await Promise.all(tags.map(tag => {
+            if (tag.key === 'ENCODER') {
+                this.metadata.setFormat('tool', tag.value);
+            }
+            return this.addTag(tag.key, tag.value);
+        }));
     }
     async parsePicture(dataLen) {
         if (this.options.skipCovers) {

package/lib/id3v2/FrameParser.js

@@ -4,6 +4,7 @@ import * as util from '../common/Util.js';
 import { AttachedPictureType, SyncTextHeader, TextEncodingToken, TextHeader } from './ID3v2Token.js';
 import { Genres } from '../id3v1/ID3v1Parser.js';
 import { makeUnexpectedFileContentError } from '../ParseError.js';
+import { decodeUintBE } from '../common/Util.js';
 const debug = initDebug('music-metadata:id3v2:frame-parser');
 const defaultEnc = 'latin1'; // latin1 == iso-8859-1;
 export function parseGenre(origVal) {
@@ -54,7 +55,7 @@ function parseGenreCode(code) {
     if (code === 'CR')
         return 'Cover';
     if (code.match(/^\d*$/)) {
-        return Genres[Number.parseInt(code)];
+        return Genres[Number.parseInt(code, 10)];
     }
 }
 export class FrameParser {
@@ -89,7 +90,7 @@ export class FrameParser {
             case 'PCST': {
                 let text;
                 try {
-                    text = util.decodeString(uint8Array.slice(1), encoding).replace(/\x00+$/, '');
+                    text = util.decodeString(uint8Array.subarray(1), encoding).replace(/\x00+$/, '');
                 }
                 catch (error) {
                     if (error instanceof Error) {
@@ -149,13 +150,13 @@ export class FrameParser {
                     offset += 1;
                     switch (this.major) {
                         case 2:
-                            pic.format = util.decodeString(uint8Array.slice(offset, offset + 3), 'latin1'); // 'latin1'; // latin1 == iso-8859-1;
+                            pic.format = util.decodeString(uint8Array.subarray(offset, offset + 3), 'latin1'); // 'latin1'; // latin1 == iso-8859-1;
                             offset += 3;
                             break;
                         case 3:
                         case 4:
                             fzero = util.findZero(uint8Array, offset, length, defaultEnc);
-                            pic.format = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
+                            pic.format = util.decodeString(uint8Array.subarray(offset, fzero), defaultEnc);
                             offset = fzero + 1;
                             break;
                         default:
@@ -165,15 +166,15 @@ export class FrameParser {
                     pic.type = AttachedPictureType[uint8Array[offset]];
                     offset += 1;
                     fzero = util.findZero(uint8Array, offset, length, encoding);
-                    pic.description = util.decodeString(uint8Array.slice(offset, fzero), encoding);
+                    pic.description = util.decodeString(uint8Array.subarray(offset, fzero), encoding);
                     offset = fzero + nullTerminatorLength;
-                    pic.data = uint8Array.slice(offset, length);
+                    pic.data = uint8Array.subarray(offset, length);
                     output = pic;
                 }
                 break;
             case 'CNT':
             case 'PCNT':
-                output = Token.UINT32_BE.get(uint8Array, 0);
+                output = decodeUintBE(uint8Array);
                 break;
             case 'SYLT': {
                 const syltHeader = SyncTextHeader.get(uint8Array, 0);
@@ -234,31 +235,31 @@ export class FrameParser {
             }
             case 'POPM': { // Popularimeter
                 fzero = util.findZero(uint8Array, offset, length, defaultEnc);
-                const email = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
+                const email = util.decodeString(uint8Array.subarray(offset, fzero), defaultEnc);
                 offset = fzero + 1;
-                const dataLen = length - offset;
+                const valueLen = length - offset - 1;
                 output = {
                     email,
                     rating: Token.UINT8.get(uint8Array, offset),
-                    counter: dataLen >= 5 ? Token.UINT32_BE.get(uint8Array, offset + 1) : undefined
+                    counter: valueLen > 0 ? util.decodeUintBE(uint8Array.subarray(offset + 1)) : undefined
                 };
                 break;
             }
             case 'GEOB': { // General encapsulated object
                 fzero = util.findZero(uint8Array, offset + 1, length, encoding);
-                const mimeType = util.decodeString(uint8Array.slice(offset + 1, fzero), defaultEnc);
+                const mimeType = util.decodeString(uint8Array.subarray(offset + 1, fzero), defaultEnc);
                 offset = fzero + 1;
                 fzero = util.findZero(uint8Array, offset, length, encoding);
-                const filename = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
+                const filename = util.decodeString(uint8Array.subarray(offset, fzero), defaultEnc);
                 offset = fzero + 1;
                 fzero = util.findZero(uint8Array, offset, length, encoding);
-                const description = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
+                const description = util.decodeString(uint8Array.subarray(offset, fzero), defaultEnc);
                 offset = fzero + 1;
                 const geob = {
                     type: mimeType,
                     filename,
                     description,
-                    data: uint8Array.slice(offset, length)
+                    data: uint8Array.subarray(offset, length)
                 };
                 output = geob;
                 break;
@@ -274,23 +275,23 @@ export class FrameParser {
             case 'WPUB':
                 // Decode URL
                 fzero = util.findZero(uint8Array, offset + 1, length, encoding);
-                output = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
+                output = util.decodeString(uint8Array.subarray(offset, fzero), defaultEnc);
                 break;
             case 'WXXX': {
                 // Decode URL
                 fzero = util.findZero(uint8Array, offset + 1, length, encoding);
-                const description = util.decodeString(uint8Array.slice(offset + 1, fzero), encoding);
+                const description = util.decodeString(uint8Array.subarray(offset + 1, fzero), encoding);
                 offset = fzero + (encoding === 'utf-16le' ? 2 : 1);
-                output = { description, url: util.decodeString(uint8Array.slice(offset, length), defaultEnc) };
+                output = { description, url: util.decodeString(uint8Array.subarray(offset, length), defaultEnc) };
                 break;
             }
             case 'WFD':
             case 'WFED':
-                output = util.decodeString(uint8Array.slice(offset + 1, util.findZero(uint8Array, offset + 1, length, encoding)), encoding);
+                output = util.decodeString(uint8Array.subarray(offset + 1, util.findZero(uint8Array, offset + 1, length, encoding)), encoding);
                 break;
             case 'MCDI': {
                 // Music CD identifier
-                output = uint8Array.slice(0, length);
+                output = uint8Array.subarray(0, length);
                 break;
             }
             default:
@@ -302,7 +303,7 @@ export class FrameParser {
     static readNullTerminatedString(uint8Array, encoding) {
         let offset = encoding.bom ? 2 : 0;
         const zeroIndex = util.findZero(uint8Array, offset, uint8Array.length, encoding.encoding);
-        const txt = uint8Array.slice(offset, zeroIndex);
+        const txt = uint8Array.subarray(offset, zeroIndex);
         if (encoding.encoding === 'utf-16le') {
             offset = zeroIndex + 2;
         }
@@ -364,9 +365,9 @@ export class FrameParser {
     }
     static readIdentifierAndData(uint8Array, offset, length, encoding) {
         const fzero = util.findZero(uint8Array, offset, length, encoding);
-        const id = util.decodeString(uint8Array.slice(offset, fzero), encoding);
+        const id = util.decodeString(uint8Array.subarray(offset, fzero), encoding);
         offset = fzero + FrameParser.getNullTerminatorLength(encoding);
-        return { id, data: uint8Array.slice(offset, length) };
+        return { id, data: uint8Array.subarray(offset, length) };
     }
     static getNullTerminatorLength(enc) {
         return enc === 'utf-16le' ? 2 : 1;

package/lib/id3v2/ID3v24TagMapper.js

@@ -137,7 +137,8 @@ const id3v24TagMap = {
     TGID: 'podcastId',
     TKWD: 'keywords',
     WFED: 'podcasturl',
-    GRP1: 'grouping'
+    GRP1: 'grouping',
+    PCNT: 'playCounter',
 };
 export class ID3v24TagMapper extends CaseInsensitiveTagMap {
     static toRating(popm) {

package/lib/id3v2/ID3v2Parser.js

@@ -24,7 +24,7 @@ export class ID3v2Parser {
         if (readI < buffer.length) {
             buffer[writeI++] = buffer[readI];
         }
-        return buffer.slice(0, writeI);
+        return buffer.subarray(0, writeI);
     }
     static getFrameHeaderLength(majorVer) {
         switch (majorVer) {
@@ -64,7 +64,7 @@ export class ID3v2Parser {
                     uint8Array = ID3v2Parser.removeUnsyncBytes(uint8Array);
                 }
                 if (frameHeader.flags?.format.data_length_indicator) {
-                    uint8Array = uint8Array.slice(4, uint8Array.length);
+                    uint8Array = uint8Array.subarray(4, uint8Array.length);
                 }
                 return frameParser.readData(uint8Array, frameHeader.id, includeCovers);
             default:
@@ -132,10 +132,10 @@ export class ID3v2Parser {
                 this.metadata.addWarning('Illegal ID3v2 tag length');
                 break;
             }
-            const frameHeaderBytes = data.slice(offset, offset + frameHeaderLength);
+            const frameHeaderBytes = data.subarray(offset, offset + frameHeaderLength);
             offset += frameHeaderLength;
             const frameHeader = this.readFrameHeader(frameHeaderBytes, this.id3Header.version.major);
-            const frameDataBytes = data.slice(offset, offset + frameHeader.length);
+            const frameDataBytes = data.subarray(offset, offset + frameHeader.length);
             offset += frameHeader.length;
             const values = ID3v2Parser.readFrameData(frameDataBytes, frameHeader, this.id3Header.version.major, !this.options.skipCovers, this.metadata);
             if (values) {
@@ -149,7 +149,7 @@ export class ID3v2Parser {
         switch (majorVer) {
             case 2:
                 header = {
-                    id: textDecode(uint8Array.slice(0, 3), 'ascii'),
+                    id: textDecode(uint8Array.subarray(0, 3), 'ascii'),
                     length: Token.UINT24_BE.get(uint8Array, 3)
                 };
                 if (!header.id.match(/[A-Z0-9]{3}/g)) {
@@ -159,9 +159,9 @@ export class ID3v2Parser {
             case 3:
             case 4:
                 header = {
-                    id: textDecode(uint8Array.slice(0, 4), 'ascii'),
+                    id: textDecode(uint8Array.subarray(0, 4), 'ascii'),
                     length: (majorVer === 4 ? UINT32SYNCSAFE : Token.UINT32_BE).get(uint8Array, 4),
-                    flags: ID3v2Parser.readFrameFlags(uint8Array.slice(8, 10))
+                    flags: ID3v2Parser.readFrameFlags(uint8Array.subarray(8, 10))
                 };
                 if (!header.id.match(/[A-Z0-9]{4}/g)) {
                     this.metadata.addWarning(`Invalid ID3v2.${this.id3Header.version.major} frame-header-ID: ${header.id}`);

package/lib/id3v2/ID3v2Token.d.ts

@@ -48,7 +48,7 @@ export declare const LyricsContentType: {
 };
 export type LyricsContentType = typeof LyricsContentType[keyof typeof LyricsContentType];
 export declare const TimestampFormat: {
-    notSynchronized0: number;
+    notSynchronized: number;
     mpegFrameNumber: number;
     milliseconds: number;
 };

package/lib/id3v2/ID3v2Token.js

@@ -40,7 +40,7 @@ export const LyricsContentType = {
     trivia_pop: 6,
 };
 export const TimestampFormat = {
-    notSynchronized0: 0,
+    notSynchronized: 0,
     mpegFrameNumber: 1,
     milliseconds: 2
 };

package/lib/lrc/LyricsParser.d.ts

@@ -1,4 +1,6 @@
 import { type ILyricsTag } from '../type.js';
+export declare function parseLyrics(input: string): ILyricsTag;
+export declare function toUnsyncedLyrics(lyrics: string): ILyricsTag;
 /**
  * Parse LRC (Lyrics) formatted text
  * Ref: https://en.wikipedia.org/wiki/LRC_(file_format)

package/lib/lrc/LyricsParser.js

@@ -1,4 +1,20 @@
 import { LyricsContentType, TimestampFormat } from '../type.js';
+// Shared timestamp regex for LRC format
+const TIMESTAMP_REGEX = /\[(\d{2}):(\d{2})\.(\d{2,3})]/;
+export function parseLyrics(input) {
+    if (TIMESTAMP_REGEX.test(input)) {
+        return parseLrc(input);
+    }
+    return toUnsyncedLyrics(input);
+}
+export function toUnsyncedLyrics(lyrics) {
+    return {
+        contentType: LyricsContentType.lyrics,
+        timeStampFormat: TimestampFormat.notSynchronized,
+        text: lyrics.trim(),
+        syncText: [],
+    };
+}
 /**
  * Parse LRC (Lyrics) formatted text
  * Ref: https://en.wikipedia.org/wiki/LRC_(file_format)
@@ -7,34 +23,23 @@ import { LyricsContentType, TimestampFormat } from '../type.js';
 export function parseLrc(lrcString) {
     const lines = lrcString.split('\n');
     const syncText = [];
-    // Regular expression to match LRC timestamps (e.g., [00:45.52] or [00:45.520])
-    const timestampRegex = /\[(\d{2}):(\d{2})\.(\d{2,3})\]/;
     for (const line of lines) {
-        const match = line.match(timestampRegex);
+        const match = line.match(TIMESTAMP_REGEX);
         if (match) {
             const minutes = Number.parseInt(match[1], 10);
             const seconds = Number.parseInt(match[2], 10);
-            const millisecondsStr = match[3];
-            let milliseconds;
-            if (millisecondsStr.length === 3) {
-                //  (e.g., .521 = 521 millseconds)
-                milliseconds = Number.parseInt(millisecondsStr, 10);
-            }
-            else {
-                //  (e.g., .52 = 520 millseconds)
-                milliseconds = Number.parseInt(millisecondsStr, 10) * 10;
-            }
-            // Convert the timestamp to milliseconds, as per TimestampFormat.milliseconds
-            const timestamp = (minutes * 60 + seconds) * 1000 + milliseconds;
-            // Get the text portion of the line (e.g., "あの蝶は自由になれたかな")
-            const text = line.replace(timestampRegex, '').trim();
+            const ms = match[3].length === 3
+                ? Number.parseInt(match[3], 10)
+                : Number.parseInt(match[3], 10) * 10;
+            const timestamp = (minutes * 60 + seconds) * 1000 + ms;
+            const text = line.replace(TIMESTAMP_REGEX, '').trim();
             syncText.push({ timestamp, text });
         }
     }
-    // Creating the ILyricsTag object
     return {
         contentType: LyricsContentType.lyrics,
         timeStampFormat: TimestampFormat.milliseconds,
+        text: syncText.map(line => line.text).join('\n'),
         syncText,
     };
 }

package/lib/lyrics3/Lyrics3.js

@@ -8,9 +8,9 @@ export async function getLyricsHeaderLength(tokenizer) {
         await tokenizer.readBuffer(buf, { position: fileSize - 143 });
         tokenizer.setPosition(position); // Restore position
         const txt = textDecode(buf, 'latin1');
-        const tag = txt.slice(6);
+        const tag = txt.substring(6);
         if (tag === endTag2) {
-            return Number.parseInt(txt.slice(0, 6), 10) + 15;
+            return Number.parseInt(txt.substring(0, 6), 10) + 15;
         }
     }
     return 0;

package/lib/mp4/MP4Parser.js

@@ -300,6 +300,8 @@ export class MP4Parser extends BasicParser {
                     switch (atom.header.name) {
                         case 'trak':
                             return this.parseTrackBox(atom);
+                        case 'udta':
+                            return this.parseTrackBox(atom);
                     }
                     break;
                 case 'moof':

package/lib/mp4/Mp4Loader.js

@@ -1,7 +1,7 @@
 export const mp4ParserLoader = {
     parserType: 'mp4',
-    extensions: ['.mp4', '.m4a', '.m4b', '.m4pa', 'm4v', 'm4r', '3gp'],
-    mimeTypes: ['audio/mp4', 'audio/m4a', 'video/m4v', 'video/mp4'],
+    extensions: ['.mp4', '.m4a', '.m4b', '.m4pa', 'm4v', 'm4r', '3gp', '.mov', '.movie', '.qt'],
+    mimeTypes: ['audio/mp4', 'audio/m4a', 'video/m4v', 'video/mp4', 'video/quicktime'],
     async load() {
         return (await import('./MP4Parser.js')).MP4Parser;
     }

package/lib/mpeg/MpegParser.js

@@ -406,7 +406,7 @@ export class MpegParser extends AbstractID3Parser {
             await this.skipSideInformation();
             return false;
         }
-        if (this.frameCount === 3) {
+        if (this.frameCount === 4) {
             // the stream is CBR if the first 3 frame bitrates are the same
             if (this.areAllSame(this.bitrates)) {
                 // Actual calculation will be done in finalize

package/lib/ogg/OggParser.js

@@ -29,7 +29,7 @@ class OggStream {
         debug('firstPage=%s, lastPage=%s, continued=%s', header.headerType.firstPage, header.headerType.lastPage, header.headerType.continued);
         if (header.headerType.firstPage) {
             this.metadata.setFormat('container', 'Ogg');
-            const idData = pageData.slice(0, 7); // Copy this portion
+            const idData = pageData.subarray(0, 7); // Copy this portion
             const asciiId = Array.from(idData)
                 .filter(b => b >= 32 && b <= 126) // Keep only printable ASCII
                 .map(b => String.fromCharCode(b))

package/lib/ogg/vorbis/Vorbis.js

@@ -38,7 +38,7 @@ export class VorbisPictureToken {
         offset += 4;
         const picDataLen = Token.UINT32_BE.get(buffer, offset);
         offset += 4;
-        const data = Uint8Array.from(buffer.slice(offset, offset + picDataLen));
+        const data = buffer.slice(offset, offset + picDataLen);
         return {
             type,
             format,

package/lib/ogg/vorbis/VorbisDecoder.js

@@ -21,8 +21,8 @@ export class VorbisDecoder {
         const v = this.readStringUtf8();
         const idx = v.indexOf('=');
         return {
-            key: v.slice(0, idx).toUpperCase(),
-            value: v.slice(idx + 1),
+            key: v.substring(0, idx).toUpperCase(),
+            value: v.substring(idx + 1),
             len: this.offset - offset0
         };
     }

package/lib/type.d.ts

@@ -359,6 +359,7 @@ export interface ICommonTagsResult {
      * https://github.com/sergiomb2/libmp4v2/wiki/iTunesMetadata#user-content-media-type-stik
      */
     stik?: number;
+    playCounter?: number;
 }
 export interface IRatio {
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "music-metadata",
   "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "11.8.3",
+  "version": "11.10.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -109,33 +109,33 @@
     "@borewit/text-codec": "^0.2.0",
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
-    "debug": "^4.4.1",
+    "debug": "^4.4.3",
     "file-type": "^21.0.0",
     "media-typer": "^1.1.0",
     "strtok3": "^10.3.4",
     "token-types": "^6.1.1",
-    "uint8array-extras": "^1.4.1"
+    "uint8array-extras": "^1.5.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.0",
+    "@biomejs/biome": "2.3.4",
     "@types/chai": "^5.2.2",
     "@types/chai-as-promised": "^8.0.2",
     "@types/content-type": "^1.1.9",
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.2.1",
+    "@types/node": "^24.5.0",
     "c8": "^10.1.3",
-    "chai": "^5.2.1",
-    "chai-as-promised": "^8.0.1",
-    "del-cli": "^6.0.0",
-    "mime": "^4.0.7",
-    "mocha": "^11.7.1",
+    "chai": "^6.2.0",
+    "chai-as-promised": "^8.0.2",
+    "del-cli": "^7.0.0",
+    "mime": "^4.1.0",
+    "mocha": "^11.7.5",
     "node-readable-to-web-readable-stream": "^0.4.2",
     "remark-cli": "^12.0.1",
     "remark-preset-lint-consistent": "^6.0.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">=18"