explaingit

xhongc/music-tag-web

5,696PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A browser-based music tag editor that lets you view and fix song metadata, title, artist, cover art, lyrics, for files stored on a remote server, with batch editing and auto-fetch from Chinese music platforms.

Mindmap

mindmap
  root((music-tag-web))
    What it does
      Edit music metadata
      Batch tag editing
      Cover art updates
    Supported formats
      MP3 and FLAC
      WAV and AAC
      OGG and OPUS
    Metadata sources
      NetEase Cloud Music
      QQ Music
      Kugou Music
    Setup
      Docker deploy
      Browser access
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Edit song titles, artist names, album art, and lyrics for music files stored on a remote server through your browser

USE CASE 2

Batch-update metadata across hundreds of files at once without a desktop tag editor

USE CASE 3

Auto-fill missing or incorrect tags by fetching metadata from NetEase Cloud Music, QQ Music, or Kugou

USE CASE 4

Manage tags for a self-hosted Navidrome music library without needing local file access

Tech stack

PythonDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker, designed for self-hosted music servers like Navidrome where local desktop access to files is not available.

GPL V3.0 with extra restrictions: free for personal non-commercial use only, commercial use is prohibited, any copyrighted data produced must be deleted within 24 hours.

In plain English

Music Tag Web is a browser-based tool for editing the metadata stored inside local music files. Metadata is the embedded information that tells a music player things like the song title, album name, artist, lyrics, and cover art image. This tool lets you view and change all of that information through a web interface rather than a desktop program. The project grew out of a specific problem: the author stores music on a remote server running Navidrome, a self-hosted music streaming service, and needed a way to fix or update music tags without having local access to the files. Desktop tag editors cannot reach files sitting on a remote machine, so a web-based tool fills that gap. The interface runs as a small web server that you access from your browser, and it points at whatever folder contains your music files. The tool supports a wide range of audio formats including MP3, FLAC, WAV, AAC (M4A), OGG, OPUS, WMA, and several others. It can fetch metadata suggestions automatically from Chinese streaming platforms such as NetEase Cloud Music, QQ Music, and Kugou Music, which is useful for filling in missing or incorrect tag information. Batch editing is also supported, so you can update tags across multiple files at once rather than one at a time. Deployment is done through Docker. You run a single Docker command, point it at your music folder, and then open a browser to port 8001. A Docker Compose file is also provided for users who prefer that approach, including those running Portainer. The license is GPL V3.0 with additional terms that restrict commercial use entirely. The author is explicit that this is a personal, non-commercial learning project, and that any copyrighted data produced while using it must be deleted within 24 hours.

Copy-paste prompts

Prompt 1
I am running Music Tag Web with Docker and want to fix metadata for my MP3s. How do I mount my music folder and open the interface in a browser?
Prompt 2
How do I use Music Tag Web to batch-update the artist field across all files in a folder?
Prompt 3
Music Tag Web fetches metadata from NetEase, how do I search for a match and apply it to my local FLAC file?
Prompt 4
Write a Docker Compose file for Music Tag Web that mounts my music folder at /music and exposes port 8001.
Open on GitHub → Explain another repo

← xhongc on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.