🚀 Music Tag Web

简体中文 | English

Music Tag Web is a web-based music metadata editor that can edit song title, album, artist, lyrics, cover art, and more. It supports FLAC, APE, WAV, AIFF, WV, TTA, MP3, M4A, OGG, MPC, OPUS, WMA, DSF, MP4 and other audio formats.

🎉 Features

Why a web version? When using Navidrome, my music library is stored on a remote server. Desktop tools like MusicTag and mp3tag cannot satisfy remote editing needs. I need a sidecar app that can run on the server and edit online music tags directly.

• View, edit, and modify metadata for most audio formats
• Batch auto-tagging (scraping) support
• Acoustic fingerprint recognition (identify songs even without metadata)
• Music file organization by artist/album or custom multi-level grouping
• File sorting by filename, size, and modified time
• Batch conversion between Traditional Chinese and Simplified Chinese metadata
• Filename parsing/unpacking to fill missing metadata
• Batch text replacement for metadata cleanup
• Audio format conversion via ffmpeg
• Whole-track cutting/splitting support
• Multiple metadata sources
• Lyric translation support
• Operation log display
• Export album cover files and upload custom album covers
• Mobile-friendly UI with phone access support
• Xiaomi XiaoAI local/NAS playback support
• Cloud drive music playback
• Playback statistics with bar/line chart visualization

🦀 Project Demo

Demo account: admin/admin

【音乐标签Web｜Music Tag Web】

💯 How to Use

【User Guide】

【User Guide V2】

Use the V2 guide for V2 deployment.

V1 Deployment

The image is available on Docker Hub.

1. Pull image

docker pull xhongc/music_tag_web:latest

2. Run container

docker run -d -p 8001:8001 -v /path/to/your/music:/app/media -v /path/to/your/config:/app/data --restart=always xhongc/music_tag_web:latest

Or deploy with Portainer Stacks (docker compose):

version: '3'

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - "8001:8001"
    volumes:
      - /path/to/your/music:/app/media:rw
      - /path/to/your/config:/app/data
    command: /start
    restart: unless-stopped

Set /path/to/your/music to your music directory and /path/to/your/config to your config directory.

3. Visit 127.0.0.1:8001/admin. Default account/password: admin/admin. Change the default password after login.

V2 Deployment

Compared with V1, V2 changes container port to 8002 and removes command: /start in Docker Compose.

1. Pull image

docker pull xhongc/music_tag_web:latest

2. Run container

docker run -d -p 8002:8002 -v /path/to/your/music:/app/media -v /path/to/your/config:/app/data --restart=always xhongc/music_tag_web:latest

Or:

version: '3'

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - "8002:8002"
    volumes:
      - /path/to/your/music:/app/media:rw
      - /path/to/your/config:/app/data
    restart: unless-stopped

Set /path/to/your/music to your music directory and /path/to/your/config to your config directory.

3. Visit 127.0.0.1:8002/admin. Default account/password: admin/admin. Change the default password after login.

📷 User Interface (V2)

💬 Contact

If you have suggestions or feature requests, please star the project first and then open an issue. If your issue is not seen in time, you can join the group chats (or add WeChat: charlesnowed, note: Music Tag, and I can invite you to the group).

 

Channels

t.me/music_tag_web

MusicTag Telegram Group

QQ Group: 55893996 (Group 1 full)

QQ Group: 79502786 (Group 2)

💸 Sponsor

If music-tag-web helps you, you can support the author. Your support helps keep updates coming. Thank you.

➡ 爱发电

🌟 Star History

Disclaimer

Any commercial use is prohibited, including but not limited to selling, monetizing, tipping, or profit-making use. This project is for personal technical research and learning only, and does not provide music downloads.

This project is distributed under GPL V3.0. The terms below supplement GPL V3.0. If there is any conflict, the terms below prevail.

Definitions used in this agreement:

• “This project” means music-tag-web
• “User” means anyone who uses this project
• “Official music platforms” means the built-in sources, including but not limited to Kuwo, NetEase Cloud Music, QQ Music, Migu, Kugou, etc.
• “Copyrighted data” includes but is not limited to images, audio, names, lyrics, and other copyrighted content

Data used by this project is fetched from publicly accessible servers of official music platforms, then filtered and merged for display. Therefore, this project does not guarantee data accuracy.

Using this project may generate copyrighted data. This project does not own such data. To avoid infringement, users must delete copyrighted data generated during usage within 24 hours.

Some resources used in this project (including but not limited to fonts and images) come from the Internet. If there is infringement, please contact us for removal.

Any direct, indirect, special, incidental, or consequential damages resulting from use or inability to use this project are the sole responsibility of the user, including but not limited to loss of goodwill, work stoppage, computer failure, and other business losses.

This project is completely free and open source on GitHub for technical learning and communication. It does not guarantee compliance with local laws in every jurisdiction. Using this project in violation of local laws is prohibited, and all related legal responsibilities are borne by the user.

By using this project, you acknowledge and accept the terms above.