Об этом проекте

music-metadata — это открытый парсер метаданных аудио- и видеофайлов, распространяемый как пакет npm. Он считывает информацию о формате, тегах и длительности из локальных файлов, потоков, Blob и буферов в памяти и работает как в Node.js, так и в браузерных средах при сборке с помощью таких инструментов, как Webpack или Rollup. Поддерживаемые форматы включают 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 и WavPack. Поддержка тегов охватывает ID3v1, ID3v1.1, ID3v2.2, ID3v2.3, ID3v2.4 и ID3v2 Chapters, APE, ASF, EXIF 2.3, iTunes/MP4, RIFF/INFO, комментарии Vorbis и AIFF. Обрабатываются форматы текстов песен LRC, синхронизированные (SYLT) и несинхронизированные (USLT) тексты, а также теги MusicBrainz, записываемые Picard, и теги ReplayGain. Также извлекаются параметры кодирования, такие как битрейт, битовая глубина, длительность и профиль кодирования (например, CBR, V0, V2). API основан на промисах. Специфичные для Node.js точки входа — parseFile для путей в файловой системе и parseStream для потоков Readable в Node.js. Кроссплатформенные точки входа включают parseWebStream для объектов web ReadableStream, parseBlob для объектов Blob или File, parseBuffer для данных Uint8Array или Buffer и parseFromTokenizer для пользовательских или сторонних токенизаторов strtok3. Необязательные параметры позволяют управлять таким поведением, как вычисление длительности и пропуск встроенной обложки. Версия 8 перешла с CommonJS на чистые модули ECMAScript и ориентирована на ECMAScript 2020, требуя Node.js 22 или новее; описан путь обратной совместимости с CommonJS. Проект поддерживается Borewit и включает значки CI, CodeQL, покрытия и уязвимостей зависимостей. Онлайн-демонстрации, такие как Audio Tag Analyzer, Webamp и плеер ICY-радиопотока, иллюстрируют типичные варианты использования, а сама библиотека предназначена для медиаприложений, музыкальных плееров и других проектов, которым нужны подробные аудиометаданные.