# Borewit/music-metadata

Metadata parser for audio and video media files. Supports file and stream inputs in Node.js and browser environments, extracting format, tag, and duration information.

Repository: https://github.com/Borewit/music-metadata
Canonical: https://ross.abutalabs.com/products/music-metadata
Language: TypeScript
License: MIT
License Family: permissive
Topics: metadata, musicbrainz, picard, tag, tags, id3, flac, mp3, mp4, vorbis, ogg, aiff, ape, asf, wav, opus, audio, m4a, musepack, dsd
Last push: 2026-08-25T06:04:19+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 3589, "days_push": 8, "days_rel": 15, "gap_med": 5.0, "n_releases_24m": 59}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1319, forks 117 (observed 2026-08-28T04:04:21.184685+00:00)

## What it is
A TypeScript library for parsing metadata from audio and video media files, extracting format, tag, and duration information. It supports file and stream inputs and works in both Node.js and browser environments.

## Use cases
- read id3 tags from mp3 files in node
- extract duration and format info from audio files
- parse flac vorbis metadata in the browser
- build a music library app that reads track tags
- scan large audio files for metadata via streams
- get album art and artist info from m4a files

## When to choose
- you need to read audio/video metadata in JavaScript or TypeScript
- you must handle large files efficiently via streaming
- you need broad format coverage like MP3, FLAC, MP4, Ogg, WAV
- you want a promise-based API for async workflows

## When to avoid
- you need to write or edit tags rather than just read them
- you work outside the JavaScript/Node.js ecosystem
- you need CommonJS-only environments without ESM support

## Facets
- artifact type: library
- maturity: active
- function: parser, file-system, audio-processing
- domain: media, developer-tools, files
- platform: browser, cross-platform
- tags: audio-metadata, id3, music-library, streaming-parser, typescript, audio, nodejs, javascript

## Member repositories
- Borewit/music-metadata (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:21.184685+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:52.336731+00:00, confidence not recorded.
  - readme: https://github.com/Borewit/music-metadata (fetched 2026-08-28T04:04:21.184685+00:00, sha 4be47e80a549)
- Data as of 2026-08-30T08:39:29.467469+00:00.