Music Tag Web: 웹 기반 음악 태그 편집 도구

Music Tag Web: 웹 기반 음악 태그 편집 도구 116

오픈 소스 웹 기반 음악 태그 편집기로, 서버나 로컬에 있는 오디오 메타데이터를 직접 편집할 수 있습니다. Navidrome 등 음악 서버 관리에 적합하며, 일괄 편집, 음악 핑거프린팅, 가사 및 커버 관리, 포맷 변환, 트랙 분할, 한자/간체 변환, 텍스트 바꾸기, 작업 기록, 모바일 대응 등의 기능을 제공합니다.

#Ai工具箱 #Ai开源项目

Music Tag Web: 웹 기반 음악 태그 편집 도구소개

Music Tag Web이란 무엇인가

Music Tag Web은 오픈소스 웹 음악 태그 편집기로, 서버나 로컬 컴퓨터의 오디오 메타데이터를 직접 편집할 수 있으며 Navidrome과 같은 음악 서버를 관리하는 상황에 활용할 수 있습니다. FLAC, APE, WAV, aiFF, WV, TTA, MP3, M4A, OGG, MPC, OPUS, WMA, DSF, DFF, MP4 등 다양한 형식을 지원하며, 일괄 편집, 음악 지문 인식, 가사 및 커버 관리, 형식 변환, 단일 트랙 분할, 간체/번체 변환, 텍스트 바꾸기, 작업 기록, 모바일 환경 대응 등의 기능을 갖추고 있습니다. 이 프로젝트의 백엔드는 Python + Django를, 프런트엔드는 Vue를 사용하며, 이미지는 Docker Hub(xhongc/music_tag_web:latest)에 호스팅되어 있습니다.

Music Tag Web


Music Tag Web 핵심 기능

  • 태그 편집

  • 기본 태그: 곡명, 가수, 앨범, 발매 연도, 장르, 트랙 번호, 커버 이미지를 포함합니다.

  • 고급 태그: 가사 임베딩, 작곡가, 편곡, 저작권 정보, 레코드 회사를 포함합니다.

  • 일괄 처리: 여러 오디오 파일을 일괄적으로 가져오고 태그 규칙을 통일하여 수정할 수 있습니다. 예를 들어 앨범명을 일괄 추가하거나 커버를 통일하여 효율을 높일 수 있습니다.

  • 형식 호환성: MP3, FLAC, AAC, WAV, OGG, APE 등 일반적인 오디오 형식을 지원합니다. 일부 도구는 ID3v1, ID3v2, Vorbis Comment 등 다양한 형식의 태그 표준을 읽고 쓸 수 있습니다.

  • 커버 관리: 앨범 커버로 사용할 로컬 이미지를 업로드할 수 있으며, 자르기 및 크기 조정도 가능하여 커버가 오디오와 일치하도록 보장합니다.

  • 내보내기 및 저장: 편집이 완료된 후 수정된 오디오 파일을 직접 다운로드할 수 있으며, 태그 정보를 텍스트(예: CSV) 형식으로 내보내 백업할 수도 있습니다.

Music Tag Web 사용 방법

먼저 음악을 업로드한 다음 왼쪽 디렉터리 트리에서 폴더를 선택합니다. 그런 다음 오른쪽에서 "자동 스크래핑"을 클릭하고 "관대한 모드", "모든 소스", "기존 태그 덮어쓰기"를 선택한 후 저장합니다. 빨간색으로 표시된 실패 항목은 수동으로 수정해야 하며, 올바른 앨범이나 가수를 입력하고 검색한 다음 일치하는 결과를 클릭하여 저장합니다. 또한 원클릭 정리가 가능하며, 상단의 "파일 정리"를 클릭하고 템플릿으로 artist/{album}/track{title}를 선택한 후 실행하면 됩니다.

빠른 배포

# 1. 디렉터리 생성(음악 라이브러리 + 설정)
mkdir -p /volume1/music /volume1/docker/music-tag
# 2. 컨테이너 시작(포트 8002, 이미지 약 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

브라우저에서 http://NAS-IP:8002 에 접속하면 기본 계정/비밀번호 admin/admin으로 즉시 스크래핑을 시작할 수 있습니다.

업그레이드나 롤백을 하려면 docker pull xhongc/music_tag_web:latest를 직접 실행한 후 컨테이너를 다시 생성하면 됩니다. 설정과 음악 파일은 모두 호스트의 매핑된 디렉터리에 있어 손실되지 않습니다.

Music Tag Web 활용 시나리오

  • 개인 음악 라이브러리 정리: 흩어져 다운로드한 곡들의 태그를 통일하여 편집하면 플레이어에서 분류하고 찾아보기 쉬워집니다.

  • 크리에이터 / 팟캐스트 제작: 창작 오디오에 제목, 제작자, 커버를 추가하여 플랫폼 업로드 요구 사항을 충족합니다.

  • 음악 애호가의 공유: 무손실 앨범을 정리할 때 태그 정보를 완비하여 공유 경험을 향상시킵니다.

자주 묻는 질문

  • 포트 충돌: 매개변수를 -p 8011:8002로 수정하면 됩니다.

  • 중국어 깨짐: 먼저 "모든 태그 지우기"를 실행한 다음 다시 스크래핑하거나, ID3 인코딩을 UTF-8로 설정하세요.

  • 단일 트랙을 트랙으로 분할할 수 없음: 동일한 디렉터리에 해당 .cue 파일이 있는지 확인한 다음 업로드 후 "분할" 버튼을 클릭하세요.

  • 외부망 접속: 라우터에서 8002 포트 포워딩을 설정하거나, 리버스 프록시, 내부망 통과 방식을 사용하세요.

Music Tag Web 관련 자료

  • 소스 코드/문서/업데이트 로그: https://github.com/xhongc/music-tag-web

  • 온라인 데모: https://xiers-organization.gitbook.io/music-tag-web-v2

Music Tag Web: 웹 기반 음악 태그 편집 도구 와 관련된 도구