music-tag-web

Music Tag Web은 NAS, 원격 미디어 서버 및 Homelab 자작 사용자를 위한 오픈소스 자체 호스팅 Docker 음악 태그 편집기입니다. 이 프로젝트는 로컬 MP3Tag, MusicBrainz Picard 등 도구로는 서버의 무손실 음악 라이브러리 메타데이터를 원격으로 수정할 수 없는 문제를 해결하기 위해 만들어졌으며, Docker 컨테이너 원클릭 배포를 통해 Navidrome, Jellyfin 등 미디어 서비스의 사이드카 애플리케이션으로 사용되어 브라우저를 통해 로컬 개인 음악 라이브러리를 원격 관리할 수 있습니다. 핵심 기능은 전 형식 오디오 파일(FLAC, APE, WAV, AIFF, WV, TTA, MP3, M4A, OGG, MPC, OPUS, WMA, DSF, MP4)의 메타데이터 조회, 단일 및 일괄 편집, ID3 태그 복구를 포함합니다. 일괄 자동 스크래핑을 지원하여 앨범 정보, 아티스트, 가사, 커버를 자동 매칭하며, 내장 음악 지문 인식으로 태그가 없거나 파일명이 혼란스러운 곡을 자동 식별하고 메타데이터를 보완합니다. 또한 스마트 음악 라이브러리 정리(아티스트, 앨범별 자동 그룹화), 다차원 파일 정렬, 일괄 번체/간체 변환, 파일명 분해 및 압축 해제로 누락 정보 추출, 일괄 텍스트 교체로 잘못된 태그 정리, ffmpeg 통합 무손실 형식 일괄 변환, 통짜 APE/FLAC/CUE 파일 자동 트랙 분할 및 개별 태그 보완, 다중 소스 음악 메타데이터 인터페이스 폴백 스크래핑, 내장 가사 번역 일괄 기록, 완전한 작업 로그 추적, 일괄 내보내기 및 사용자 지정 업로드 앨범 커버 교체 등의 기능을 제공합니다. 배포 측면에서 프로젝트는 V1과 V2 두 가지 Docker 배포 방식을 제공하며, V2가 현재 권장 버전입니다. 컨테이너 내부 서비스 포트는 8002이고 Docker Compose 설정이 더 간결하며 호환성이 더 좋습니다. 이미지는 Docker Hub에 업로드되어 amd64 및 arm64 아키텍처를 지원하며 Synology, QNAP, Raspberry Pi 등 기기에 적합합니다. 사용자는 로컬 음악 디렉터리와 설정 디렉터리만 마운트하면 실행할 수 있으며, 기본 접속 주소는 127.0.0.1:8002/admin이고 기본 계정/비밀번호는 admin/admin입니다. 인터페이스는 완전 반응형 모바일 UI 디자인을 채택하여 휴대폰 브라우저로 NAS 음악 라이브러리에 원격 접속해 태그 편집을 지원합니다. 프로젝트는 Xiaomi AI 스피커 로컬 음악 라이브러리 재생과도 호환되어 NAS 무손실 음악 파일을 직접 읽을 수 있으며, 각종 개인 클라우드 드라이브에 마운트된 음악 라이브러리의 온라인 재생과 태그 편집을 지원합니다. 재생 데이터 통계 기능은 막대 그래프와 꺾은선 그래프로 음악 라이브러리 재생 기록을 시각화합니다. 프로젝트는 GPL V3.0 라이선스로 배포되며, 모든 음악 라이브러리 파일은 로컬에 저장되고 제3자에게 업로드되지 않아 개인정보 보안을 중시합니다. 프로젝트는 완전 무료이며 개인적인 기술 연구 학습 용도로만 제공되며, 어떠한 형태의 상업적 사용도 금지됩니다.