Sobre el proyecto

music-metadata es un analizador de metadatos de código abierto para archivos multimedia de audio y video, distribuido como paquete npm. Lee información de formato, etiquetas y duración desde archivos locales, streams, Blobs y buffers en memoria, y se ejecuta tanto en Node.js como en entornos de navegador cuando se empaqueta con herramientas como Webpack o Rollup. La cobertura de formatos incluye MP3, MP4/M4A/M4V, FLAC, Ogg, Opus, Vorbis, Speex, Theora, WAV/BWF, AIFF/AIFF-C, AAC/ADTS, APE, ASF/WMA, Matroska/WebM, MPC, DSF, DSDIFF y WavPack. La compatibilidad de etiquetas abarca ID3v1, ID3v1.1, ID3v2.2, ID3v2.3, ID3v2.4 y ID3v2 Chapters, APE, ASF, EXIF 2.3, iTunes/MP4, RIFF/INFO, comentarios Vorbis y AIFF. Se manejan los formatos de letras LRC, letras sincronizadas (SYLT) y no sincronizadas (USLT), junto con etiquetas MusicBrainz tal como las escribe Picard y etiquetas ReplayGain. También se extraen detalles de codificación como tasa de bits, profundidad de bits, duración y perfil de codificación (por ejemplo CBR, V0, V2). La API se basa en promesas. Los puntos de entrada específicos de Node.js son parseFile para rutas del sistema de archivos y parseStream para streams Readable de Node.js. Los puntos de entrada multiplataforma incluyen parseWebStream para objetos ReadableStream web, parseBlob para objetos Blob o File, parseBuffer para datos Uint8Array o Buffer, y parseFromTokenizer para tokenizadores strtok3 personalizados o de terceros. Las opciones opcionales permiten controlar comportamientos como el cálculo de duración y la omisión de carátulas incrustadas. La versión 8 migró de CommonJS a módulos ECMAScript puros y apunta a ECMAScript 2020, con un requisito de motor Node.js 22 o superior; se documenta una ruta de compatibilidad hacia atrás con CommonJS. El proyecto es mantenido por Borewit e incluye insignias de CI, CodeQL, cobertura y vulnerabilidades de dependencias. Demos en línea como Audio Tag Analyzer, Webamp y un reproductor de streams de radio ICY ilustran usos típicos, y la biblioteca está dirigida a aplicaciones multimedia, reproductores de música y otros proyectos que necesiten metadatos de audio detallados.