whatisgithub

What is music-tag-web?

xhongc/music-tag-web — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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

What do people build with it?

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

What is it built with?

PythonDocker

How does it compare?

xhongc/music-tag-webfrostming/legittvytlx/ai-agent-deep-dive
Stars5,6965,6935,693
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencegeneraldeveloperresearcher

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

How do you get 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.

So what is it?

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.

Frequently asked questions

What is music-tag-web?

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.

What language is music-tag-web written in?

Mainly Python. The stack also includes Python, Docker.

What license does music-tag-web use?

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.

How hard is music-tag-web to set up?

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

Who is music-tag-web for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.