gitwtfhub

wtf is music-metadata-wasm?

subframe7536/music-metadata-wasm — explained in plain English

Analysis updated 2026-08-04 · repo last pushed 2026-02-03

5RustAudience · developerComplexity · 2/5QuietSetup · moderate

TL;DR

A deprecated WebAssembly library that reads and writes embedded tags in music files, like title, artist, album, and cover art, from a web app or Node.js program. The author recommends using the replacement library music-tag-native instead.

Mindmap

mindmap
  root((repo))
    What it does
      Reads music file tags
      Writes music file tags
      Extracts cover art
    Tech stack
      Rust
      WebAssembly
      Node.js
    Use cases
      Music player apps
      File organizer tools
      Fix mislabeled tracks
    Status
      Deprecated project
      Use music-tag-native
    How it works
      Load file to memory
      Get editable metadata
      Save new file buffer

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a web music player that displays embedded album art and song details.

REASON 2

Create a file organizer that reads and corrects mislabeled music tracks.

REASON 3

Make a web tool where users upload MP3s and edit their embedded metadata.

REASON 4

Extract cover art from FLAC files and identify the image format.

What's in the stack?

RustWebAssemblyNode.js

How it stacks up

subframe7536/music-metadata-wasmdhkts1/teamclaude-rselofight/emufight
Stars555
LanguageRustRustRust
Last pushed2026-02-03
MaintenanceQuiet
Setup difficultymoderateeasyhard
Complexity2/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a WebAssembly-compatible environment and a replacement library is recommended since this project is deprecated.

No license information is mentioned in the README, so usage terms are unclear.

Wtf does this do

This project, music-metadata-wasm, lets a web app or Node.js program read and write the tags embedded in music files, things like song title, artist, album, and cover art. It is deprecated, meaning the author no longer maintains it and points users to a replacement called music-tag-native instead. The library works by running code originally written in Rust (a fast, lower-level language) inside a browser or Node environment using WebAssembly, which lets that code execute at near-native speed. In practice, you load a music file into memory, pass it to the library, and get back an object you can read from or write to, setting a new title, for instance, then save it back out as a new file buffer. The README's example shows reading a FLAC file, changing its title, and extracting the cover image's format. Someone building a music player, a file organizer, or a web tool that lets users fix or enrich their song collection would find this useful. For example, if you are making an app where people upload their MP3s and you want to display the embedded album art or let them correct mislabeled tracks, this handles the reading and writing of that embedded data. The notable design choice is using WebAssembly to bring Rust-based metadata parsing into JavaScript environments, which can be faster than pure-JavaScript alternatives for processing audio files. However, since the project is explicitly deprecated, anyone considering it should look at the suggested replacement instead. The README does not go into detail on supported formats or features beyond the FLAC example shown.

Yoink these prompts

Prompt 1
I want to read the metadata from a FLAC file in my Node.js app, including title, artist, album, and cover art. How do I use music-metadata-wasm to load the file and extract those tags?
Prompt 2
Help me write a browser-based tool that lets users upload an MP3, view its embedded album art, edit the song title and artist, then download the updated file using music-metadata-wasm.
Prompt 3
Show me how to use music-metadata-wasm to read a music file, change the title tag, extract the cover image format, and save it back as a new file buffer.
Prompt 4
I need to batch-process a folder of music files and extract all embedded metadata into a JSON object using music-metadata-wasm in Node.js. Can you write that script?

Frequently asked questions

wtf is music-metadata-wasm?

A deprecated WebAssembly library that reads and writes embedded tags in music files, like title, artist, album, and cover art, from a web app or Node.js program. The author recommends using the replacement library music-tag-native instead.

What language is music-metadata-wasm written in?

Mainly Rust. The stack also includes Rust, WebAssembly, Node.js.

Is music-metadata-wasm actively maintained?

Quiet — no commits in 6-12 months (last push 2026-02-03).

What license does music-metadata-wasm use?

No license information is mentioned in the README, so usage terms are unclear.

How hard is music-metadata-wasm to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is music-metadata-wasm for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.