JSPM

  • Created
  • Published
  • Downloads 1172
  • Score
    100M100P100Q125297F
  • License MIT

MP3 tagging written in pure JavaScript

Package Exports

  • mp3tag.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mp3tag.js) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

mp3tag.js Banner

GitHub Workflow Status Build Status David npm npm bundle size

mp3tag.js is an open sourced JavaScript library used to edit the metadata of audio files. It currently supports ID3v1, ID3v2.3, and ID3v2.4 tags.

Visit https://mp3tag.js.org to learn more about the library and view it in action through an editor.

The website is also open sourced and can be viewed at the gh-pages branch.

Features

  • Read ID3v1 and ID3v2 tags synchronously
  • Write ID3v1 and ID3v2 tags synchronously
  • Supports unsynchronisation
  • Standards compliant. See id3.org

Installation

You can download the ready-to-use script at GitHub releases or you can build your own by cloning this repository using git then build it.

git clone https://github.com/eidoriantan/mp3tag.js
cd ./mp3tag.js
npm install
npm run build

You can also install this package by using npm:

npm install --save mp3tag.js@latest

Usage

<input type="file" id="input-file" accept="audio/mpeg">
<script>
const inputFile = document.getElementById('input-file')
inputFile.onchange = function () {
  const reader = new FileReader()
  reader.onload = function () {
    const buffer = this.result
    const mp3tag = new MP3Tag(buffer)
    mp3tag.read()
    console.log(mp3tag.tags)
  }

  if (this.files.length > 0) {
    reader.readAsArrayBuffer(this.files[0])
  }
}
</script>

If you want a detailed documentations, please visit the documentations page at mp3tag.js.org.

Support

If you had found a bug or any unexpected behavior, you can submit an issue through GitHub issues. If you wanted to contribute to this repository, refer to CONTRIBUTING.md.

You can also show your support by becoming a patron!

Patreon