music-metadata

music-metadata é um analisador de metadados de código aberto para arquivos de mídia de áudio e vídeo, distribuído como pacote npm. Ele lê informações de formato, tags e duração de arquivos locais, streams, Blobs e buffers em memória, e funciona tanto no Node.js quanto em ambientes de navegador quando empacotado com ferramentas como Webpack ou Rollup. A cobertura de formatos inclui 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 e WavPack. O suporte a tags abrange ID3v1, ID3v1.1, ID3v2.2, ID3v2.3, ID3v2.4 e ID3v2 Chapters, APE, ASF, EXIF 2.3, iTunes/MP4, RIFF/INFO, comentários Vorbis e AIFF. Formatos de letras LRC, letras sincronizadas (SYLT) e não sincronizadas (USLT) são tratados, juntamente com tags MusicBrainz conforme escritas pelo Picard e tags ReplayGain. Detalhes de codificação como taxa de bits, profundidade de bits, duração e perfil de codificação (por exemplo CBR, V0, V2) também são extraídos. A API é baseada em promises. Pontos de entrada específicos do Node.js são parseFile para caminhos do sistema de arquivos e parseStream para streams Readable do Node.js. Pontos de entrada multiplataforma incluem parseWebStream para objetos ReadableStream da web, parseBlob para objetos Blob ou File, parseBuffer para dados Uint8Array ou Buffer, e parseFromTokenizer para tokenizers strtok3 personalizados ou de terceiros. Opções opcionais permitem controlar comportamentos como cálculo de duração e ignorar capas incorporadas. A versão 8 migrou de CommonJS para módulos ECMAScript puros e tem como alvo ECMAScript 2020, com requisito de mecanismo Node.js 22 ou mais recente; um caminho de compatibilidade retroativa com CommonJS está documentado. O projeto é mantido por Borewit e inclui badges de CI, CodeQL, cobertura e vulnerabilidades de dependências. Demonstrações online como Audio Tag Analyzer, Webamp e um player de stream de rádio ICY ilustram usos típicos, e a biblioteca é voltada para aplicações de mídia, players de música e outros projetos que precisam de metadados de áudio detalhados.