node-taglib-sharp-extend

node-taglib-sharp-extend

extend node-taglib-sharp, add support for file in memory

install

pnpm add node-taglib-sharp node-taglib-sharp-extend

usage

basic

built-in:

import { File } from 'node-taglib-sharp'
import { File, MemoryFileAbstraction } from 'node-taglib-sharp-extend'

const file = File.createFromAbstraction(
  new MemoryFileAbstraction('test.mp3', buffer),
)

utils

import {
  flushFile,
  getFileFromBuffer,
  parseMetadata,
  updatePicture,
  updateTag
} from 'node-taglib-sharp-extend/utils'

let file = getFileFromBuffer('test.mp3', buffer)

const { tag, property, pictures, quality } = parseMetadata(
  file,
  arr => arr.flatMap(a => a.split('; ')).join('')
)

updateTag(file, 'title', 'test')
updatePicture(file, buffer)

file = flushFile(file)

types

export type IAudioTag<T extends string | string[] = string[]> = Partial<{
  title: string
  artists: T
  album: string
  track: number
  trackTotal: number
  disk: number
  diskTotal: number
  year: number
  genres: T
  albumArtists: T
  composers: T
  comment: string
  lyrics: string
}>

export type IAudioProperty = {
  bitRate: number
  bitsPerSample: number
  sampleRate: number
  duration: number
  channels: number
  codecs: ICodec[]
}

export type Metadata<T extends string | string[] = string[]> = {
  tag: IAudioTag<T>
  property: IAudioProperty
  quality: AudioQualityType
  pictures?: IParsedPicture[]
}

more utils are documented by JSDoc

run in browser

if you want to run in browser, you need to polyfill node modules and patch node-taglib-sharp for performance

polyfill

there is a built-in vite plugin for polyfill, and please confirm that vite-plugin-node-polyfills is installed

when dev, default includes is ['buffer', 'stream', 'string_decoder', 'fs', 'path']

when build, default includes: ['buffer', 'string_decoder'], other modules are manually transformed by the plugin

default global: { Buffer: true }

import { defineConfig } from 'vite'
import { polyfillTaglib } from 'node-taglib-sharp-extend/vite'

export default defineConfig({
  plugins: [
    polyfillTaglib(options),
  ],
})

worker support check

Matroska / WebM use node:crypto.randomFillSync() to generate random array, it is polyfilled to crypto.getRandomValues.

you can use built-in function to check if support in Web Worker:

import { checkWebWorkerSupport } from 'node-taglib-sharp-extend'

// you can run in main thread or worker thread
if (await checkWebWorkerSupport()) {
  // ...
}

patch

in V5.2.2, the performance of writing block is poor when using MemoryFileAbstraction. File.insert() use tiny buffer size to increase the file size, and the buffer allocation in memory seem to be expensive

so patch the File.insert() with larger buffer size in Step 3 will improve the performance

if you use pnpm, add to your package.json and rerun pnpm install:

{
  "pnpm": {
    "patchedDependencies": {
      "node-taglib-sharp@5.2.2": "./node_modules/node-taglib-sharp-extend/patches/[e-mail]"
    }
  }
}