Music Tag Web: editor de etiquetas musicales basado en web 113

¿Qué es Music Tag Web?

Music Tag Web es un editor de etiquetas de música web de código abierto que puede editar directamente los metadatos de audio en el servidor o en el equipo local, ideal para gestionar servidores de música como Navidrome. Admite múltiples formatos como FLAC, APE, WAV, AIFF, WV, TTA, MP3, M4A, OGG, MPC, OPUS, WMA, DSF, DFF, MP4, e incluye funciones de edición por lotes, reconocimiento de huellas digitales de música, gestión de letras y portadas, conversión de formatos, corte de imágenes completas, conversión entre chino simplificado y tradicional, reemplazo de texto, registro de operaciones y adaptación a dispositivos móviles. El backend del proyecto utiliza Python + Django, el frontend usa Vue, y su imagen está alojada en Docker Hub (xhongc/music_tag_web:latest).

Funciones principales de Music Tag Web

• Edición de etiquetas

• Etiquetas básicas: incluye nombre de la canción, artista, álbum, año de lanzamiento, género, número de pista e imagen de portada.

• Etiquetas avanzadas: incluye incrustación de letras, compositor, arreglista, información de derechos de autor y discográfica.

• Procesamiento por lotes: permite importar varios archivos de audio a la vez y modificar las reglas de etiquetas de forma unificada, como añadir nombres de álbum por lotes o unificar portadas, mejorando así la eficiencia.

• Compatibilidad de formatos: admite formatos de audio comunes como MP3, FLAC, AAC, WAV, OGG, APE, etc. Algunas herramientas pueden leer y escribir estándares de etiquetas de diferentes formatos, como ID3v1, ID3v2 y Vorbis Comment.

• Gestión de portadas: permite subir imágenes locales como portada del álbum, y también recortarlas y escalarlas para asegurar que coincidan con el audio.

• Exportación y guardado: una vez finalizada la edición, se puede descargar directamente el archivo de audio modificado, o exportar la información de las etiquetas como texto (por ejemplo, CSV) como copia de seguridad.

Cómo usar Music Tag Web

Primero sube la música y, a continuación, marca la carpeta en el árbol de directorios de la izquierda. Luego, en el lado derecho, haz clic en "自动刮削" (Scraping automático), selecciona "宽松模式" (Modo flexible), "全部源" (Todas las fuentes) y "覆盖旧标签" (Sobrescribir etiquetas antiguas), y por último guarda. Para las entradas fallidas que se muestran en rojo, debes modificarlas manualmente: introduce el álbum o artista correcto, realiza la búsqueda, haz clic en el resultado coincidente y guarda. También puedes organizar con un solo clic: haz clic en "整理文件" (Organizar archivos) en la parte superior, selecciona la plantilla artist/{album}/track{title} y ejecútala.

Despliegue rápido

# 1. Crear directorios (biblioteca de música + configuración)
mkdir -p /volume1/music /volume1/docker/music-tag
# 2. Iniciar contenedor (puerto 8002, imagen de unos 300 MB)
docker run -d --name music-tag-web \
  -p 8002:8002 \
  -v /volume1/music:/app/media:rw \
  -v /volume1/docker/music-tag:/app/data \
  --restart unless-stopped \
  xhongc/music_tag_web:latest

Accede desde el navegador a http://NAS-IP:8002 con la cuenta/contraseña por defecto admin/admin para comenzar a hacer scraping.

Para actualizar o revertir, simplemente ejecuta docker pull xhongc/music_tag_web:latest y vuelve a crear el contenedor; la configuración y los archivos de música se encuentran en los directorios mapeados del host, por lo que no se perderán.

Escenarios de aplicación de Music Tag Web

• Organización de bibliotecas musicales personales: editar de forma unificada las etiquetas de canciones descargadas dispersas para facilitar la clasificación y búsqueda en los reproductores.

• Producción de medios propios / podcasts: añadir título, autor y portada a los audios originales para cumplir con los requisitos de subida de las plataformas.

• Intercambio entre aficionados a la música: al organizar álbumes de música sin pérdida, completar la información de las etiquetas mejora la experiencia de compartición.

Preguntas frecuentes

• Conflicto de puertos: modifica el parámetro a -p 8011:8002.

• Caracteres chinos ilegibles: primero "清除所有标签" (Borrar todas las etiquetas) y luego vuelve a hacer scraping; o establece la codificación ID3 en UTF-8.

• No se puede dividir una imagen completa en pistas: asegúrate de que exista el archivo .cue correspondiente en el mismo directorio y, tras subirlo, haz clic en el botón "分割" (Dividir).

• Acceso desde la red externa: realiza un mapeo del puerto 8002 en el router, o utiliza proxy inverso o穿透 de red interna (NAT traversal).

Recursos relacionados con Music Tag Web

• Código fuente / documentación / registro de cambios: https://github.com/xhongc/music-tag-web

• Demo en línea: https://xiers-organization.gitbook.io/music-tag-web-v2